Pinterest MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Pinterest: 43 typed functions through one MCP server. No Pinterest API key needed.
- Site
- pinterest.com
- Functions
- 43
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Pinterest alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/pinterestOne MCP server for Pinterest and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getBoardRead one board: name, description, owner, pin count, follower count, section count, privacy and cover.Arguments
Name Type Required usernamestringYes slugstringYes Returns
PinterestBoardDetailinterface PinterestBoardDetail { id: string; name: string; url: string; description?: string; owner?: { id: string; username: string; full_name?: string }; pin_count?: number; follower_count?: number; section_count?: number; privacy?: string; image_cover_url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/getBoardCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.getBoard("surlatable", "fathers-day");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.getBoard("surlatable", "fathers-day"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/getBoard \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"surlatable","slug":"fathers-day"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.getBoard("surlatable", "fathers-day");getCurrentUserWho the caller is signed in as.Arguments
None.
Returns
PinterestUserinterface PinterestUser { id: string; username: string; full_name: string; follower_count?: number; board_count?: number; pin_count?: number; is_verified_merchant?: boolean; image_large_url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/getCurrentUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.getCurrentUser();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.getCurrentUser())curl -X POST https://api.bowmark.ai/v1/sites/pinterest/getCurrentUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.getCurrentUser();getHomeFeedThe caller's own personalised Pinterest home feed, same row shape as searchPins, with a bookmark for the next page.Arguments
Name Type Required options{ bookmark?: string }No Returns
{ pins: PinterestPin[]; bookmark: string | null }interface PinterestPin { id: string; grid_title: string; link: string; pinner?: { username: string; full_name?: string }; board?: { id: string; name: string }; images?: Record<string, { width: number; height: number; url: string }>; product_metadata?: { price_val?: number; price_currency?: string; rating?: number; review_count?: number; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/getHomeFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.getHomeFeed();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.getHomeFeed())curl -X POST https://api.bowmark.ai/v1/sites/pinterest/getHomeFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.getHomeFeed();getPinRead one pin in full: title, seo_title, the description Pinterest renders, the outbound link and link_domain, created_at, the pinner and the board it…Arguments
Name Type Required idstringYes Returns
PinterestPinDetailinterface PinterestPinDetail { id: string; title?: string; seo_title?: string; description?: string; link?: string; link_domain?: { id: string }; created_at?: string; pinner?: { username: string; full_name?: string }; board?: { id: string; name: string }; images?: Record<string, { width: number; height: number; url: string }>; repin_count?: number; share_count?: number; reaction_counts?: Record<string, number>; price_value?: number; price_currency?: string; carousel_data?: unknown; videos?: unknown; aggregated_pin_data?: { id: string }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/getPinCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.getPin("1002684304554901551");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.getPin("1002684304554901551"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/getPin \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"1002684304554901551"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.getPin("1002684304554901551");getProductRead the product behind a shoppable pin: price and currency, the merchant and the outbound buy link, availability, the aggregate rating and how many…Arguments
Name Type Required idstringYes Returns
PinterestProductinterface PinterestProduct { id: string; price?: number; currency?: string; rating?: number; review_count?: number; availability?: boolean; item_id?: string; item_set_id?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.getProduct("1002684304554901551");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.getProduct("1002684304554901551"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"1002684304554901551"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.getProduct("1002684304554901551");getTopicRead one idea topic: its display name, its own key/slug, follower count, and whether it has related topics.Arguments
Name Type Required topicIdstringYes Returns
PinterestTopicDetailinterface PinterestTopicDetail { id: string; name: string; key: string; slug: string; followerCount?: number; isFollowed?: boolean; hasRelated?: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/getTopicCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.getTopic("918530398158");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.getTopic("918530398158"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/getTopic \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"topicId":"918530398158"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.getTopic("918530398158");getUserRead a person's or a brand's profile: id, full name, username, follower and following counts, how many pins and boards they have, whether they're a…Arguments
Name Type Required usernamestringYes Returns
PinterestUserinterface PinterestUser { id: string; username: string; full_name: string; follower_count?: number; board_count?: number; pin_count?: number; is_verified_merchant?: boolean; image_large_url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/getUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.getUser("surlatable");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.getUser("surlatable"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/getUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"surlatable"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.getUser("surlatable");hidePinTell Pinterest the signed-in caller does not want to see a pin in their home feed.Arguments
Name Type Required pinIdstringYes options{ undo?: boolean }No Returns
{ pinId: string; hidden: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/hidePinCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.hidePin("1234567890");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.hidePin("1234567890"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/hidePin \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"pinId":"1234567890"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.hidePin("1234567890");listBoardPinsEvery pin inside a board, in the board's own order, with a bookmark for the next page.Arguments
Name Type Required boardIdstringYes options{ bookmark?: string }No Returns
{ pins: PinterestPin[]; bookmark: string | null }interface PinterestPin { id: string; grid_title: string; link: string; pinner?: { username: string; full_name?: string }; board?: { id: string; name: string }; images?: Record<string, { width: number; height: number; url: string }>; product_metadata?: { price_val?: number; price_currency?: string; rating?: number; review_count?: number; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listBoardPinsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listBoardPins("180003385045887010");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listBoardPins("180003385045887010"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listBoardPins \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"boardId":"180003385045887010"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listBoardPins("180003385045887010");listBoardSectionPinsThe pins inside one section of a board, taking the section id listBoardSections returns.Arguments
Name Type Required sectionIdstringYes options{ bookmark?: string }No Returns
{ pins: PinterestPin[]; bookmark: string | null }interface PinterestPin { id: string; grid_title: string; link: string; pinner?: { username: string; full_name?: string }; board?: { id: string; name: string }; images?: Record<string, { width: number; height: number; url: string }>; product_metadata?: { price_val?: number; price_currency?: string; rating?: number; review_count?: number; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listBoardSectionPinsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listBoardSectionPins("5113343207027031305");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listBoardSectionPins("5113343207027031305"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listBoardSectionPins \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"sectionId":"5113343207027031305"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listBoardSectionPins("5113343207027031305");listBoardSectionsThe sections a board is divided into.Arguments
Name Type Required boardIdstringYes Returns
{ sections: PinterestBoardSection[] }interface PinterestSectionPreviewPin { id: string; title?: string; link?: string; } interface PinterestBoardSection { id: string; title: string; slug: string; pin_count?: number; preview_pins?: PinterestSectionPreviewPin[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listBoardSectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listBoardSections("283445438986975093");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listBoardSections("283445438986975093"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listBoardSections \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"boardId":"283445438986975093"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listBoardSections("283445438986975093");listConversationsThe caller's Pinterest inbox.Arguments
None.
Returns
{ conversations: PinterestConversation[] }interface PinterestUser { id: string; username: string; full_name: string; follower_count?: number; board_count?: number; pin_count?: number; is_verified_merchant?: boolean; image_large_url?: string; } interface PinterestConversation { id: string; created_at?: string; name?: string; board?: { id: string; name: string }; emails?: string[]; unread?: number; users?: PinterestUser[]; last_message?: { text?: string; created_at?: string }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listConversationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listConversations();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listConversations())curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listConversations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listConversations();listNotificationsThe caller's own notifications.Arguments
Name Type Required options{ bookmark?: string; pageSize?: number }No Returns
{ notifications: PinterestNotification[]; bookmark: string | null }interface PinterestNotification { id: string; news_type?: string; header_text?: string; text?: string; display_mode?: string; unread?: boolean; created_at?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listNotificationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listNotifications();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listNotifications())curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listNotifications \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listNotifications();listTopicPinsThe best pins in a topic, Pinterest's editorial feed for that interest, which is the closest thing an anonymous caller has to the home feed.Arguments
Name Type Required topicIdstringYes Returns
{ pins: PinterestIdeaPin[] }interface PinterestIdeaPin { id: string; images?: Record<string, { width: number; height: number; url: string }>; dominant_color?: string; videos?: unknown; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listTopicPinsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listTopicPins("918530398158");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listTopicPins("918530398158"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listTopicPins \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"topicId":"918530398158"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listTopicPins("918530398158");listTopicsPinterest's own top-level idea topics.Arguments
None.
Returns
{ topics: PinterestTopic[] }interface PinterestTopic { id: string; name: string; url: string; isHoliday: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listTopicsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listTopics();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listTopics())curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listTopics \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listTopics();listUserBoardsEvery board a person has made public, with id, name, url, pin count and section count.Arguments
Name Type Required usernamestringYes options{ bookmark?: string }No Returns
{ boards: PinterestBoard[]; bookmark: string | null }interface PinterestBoard { id: string; name: string; url: string; pin_count?: number; section_count?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listUserBoardsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listUserBoards("surlatable");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listUserBoards("surlatable"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listUserBoards \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"surlatable"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listUserBoards("surlatable");listUserCreatedPinsThe pins a person made themselves rather than saved from somebody else.Arguments
Name Type Required usernamestringYes options{ bookmark?: string }No Returns
{ pins: PinterestPin[]; bookmark: string | null }interface PinterestPin { id: string; grid_title: string; link: string; pinner?: { username: string; full_name?: string }; board?: { id: string; name: string }; images?: Record<string, { width: number; height: number; url: string }>; product_metadata?: { price_val?: number; price_currency?: string; rating?: number; review_count?: number; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listUserCreatedPinsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listUserCreatedPins("surlatable");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listUserCreatedPins("surlatable"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listUserCreatedPins \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"surlatable"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listUserCreatedPins("surlatable");listUserFollowersWho follows a person, page by page.Arguments
Name Type Required usernamestringYes options{ bookmark?: string; pageSize?: number }No Returns
{ users: PinterestUser[]; bookmark: string | null }interface PinterestUser { id: string; username: string; full_name: string; follower_count?: number; board_count?: number; pin_count?: number; is_verified_merchant?: boolean; image_large_url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listUserFollowersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listUserFollowers("surlatable");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listUserFollowers("surlatable"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listUserFollowers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"surlatable"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listUserFollowers("surlatable");listUserFollowingWho this person follows, people, boards and topics, as the caller's own signed-in session sees it.Arguments
Name Type Required usernamestringYes options{ bookmark?: string }No Returns
{ users: PinterestUser[]; bookmark: string | null }interface PinterestUser { id: string; username: string; full_name: string; follower_count?: number; board_count?: number; pin_count?: number; is_verified_merchant?: boolean; image_large_url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listUserFollowingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listUserFollowing("surlatable");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listUserFollowing("surlatable"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listUserFollowing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"surlatable"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listUserFollowing("surlatable");listUserSavedPinsThe pins a person has saved, newest first, across all their boards.Arguments
Name Type Required usernamestringYes options{ bookmark?: string }No Returns
{ pins: PinterestPin[]; bookmark: string | null }interface PinterestPin { id: string; grid_title: string; link: string; pinner?: { username: string; full_name?: string }; board?: { id: string; name: string }; images?: Record<string, { width: number; height: number; url: string }>; product_metadata?: { price_val?: number; price_currency?: string; rating?: number; review_count?: number; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listUserSavedPinsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listUserSavedPins("surlatable");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listUserSavedPins("surlatable"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listUserSavedPins \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"surlatable"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listUserSavedPins("surlatable");listVisualObjectsThe objects Pinterest's own computer vision found inside a pin's image.Arguments
Name Type Required idstringYes Returns
{ objects: PinterestVisualObject[] }interface PinterestVisualObject { x: number; y: number; w: number; h: number; label?: string; label_id?: number; score?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/listVisualObjectsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.listVisualObjects("11470174045893444");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.listVisualObjects("11470174045893444"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/listVisualObjects \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"11470174045893444"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.listVisualObjects("11470174045893444");reactToPinReact to a pin as the caller.Arguments
Name Type Required pinIdstringYes options{ reactionType?: number; undo?: boolean }No Returns
{ pinId: string; reactionType: number; reacted: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/reactToPinCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.reactToPin("1002684441946297892");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.reactToPin("1002684441946297892"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/reactToPin \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"pinId":"1002684441946297892"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.reactToPin("1002684441946297892");searchBoardsSearch for boards rather than pins.Arguments
Name Type Required querystringYes options{ bookmark?: string }No Returns
{ boards: PinterestBoard[]; bookmark: string | null }interface PinterestBoard { id: string; name: string; url: string; pin_count?: number; section_count?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/searchBoardsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.searchBoards("espresso machine");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.searchBoards("espresso machine"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/searchBoards \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"espresso machine"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.searchBoards("espresso machine");searchMyPinsSearch only inside the caller's own saved pins.Arguments
Name Type Required querystringYes options{ bookmark?: string }No Returns
{ pins: PinterestPin[]; bookmark: string | null }interface PinterestPin { id: string; grid_title: string; link: string; pinner?: { username: string; full_name?: string }; board?: { id: string; name: string }; images?: Record<string, { width: number; height: number; url: string }>; product_metadata?: { price_val?: number; price_currency?: string; rating?: number; review_count?: number; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/searchMyPinsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.searchMyPins("espresso machine");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.searchMyPins("espresso machine"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/searchMyPins \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"espresso machine"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.searchMyPins("espresso machine");searchPinsSearch Pinterest the way a person types into its search box and get the pins back: grid_title, the outbound link and its domain, description, the…Arguments
Name Type Required querystringYes options{ bookmark?: string }No Returns
{ pins: PinterestPin[]; bookmark: string | null }interface PinterestPin { id: string; grid_title: string; link: string; pinner?: { username: string; full_name?: string }; board?: { id: string; name: string }; images?: Record<string, { width: number; height: number; url: string }>; product_metadata?: { price_val?: number; price_currency?: string; rating?: number; review_count?: number; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/searchPinsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.searchPins("espresso machine");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.searchPins("espresso machine"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/searchPins \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"espresso machine"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.searchPins("espresso machine");searchUsersSearch for people and brands by name and get their account back.Arguments
Name Type Required querystringYes options{ bookmark?: string }No Returns
{ users: PinterestUser[]; bookmark: string | null }interface PinterestUser { id: string; username: string; full_name: string; follower_count?: number; board_count?: number; pin_count?: number; is_verified_merchant?: boolean; image_large_url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/searchUsersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.searchUsers("sur la table");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.searchUsers("sur la table"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/searchUsers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"sur la table"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.searchUsers("sur la table");searchVideosSearch only the video pins.Arguments
Name Type Required querystringYes options{ bookmark?: string }No Returns
{ pins: PinterestPin[]; bookmark: string | null }interface PinterestPin { id: string; grid_title: string; link: string; pinner?: { username: string; full_name?: string }; board?: { id: string; name: string }; images?: Record<string, { width: number; height: number; url: string }>; product_metadata?: { price_val?: number; price_currency?: string; rating?: number; review_count?: number; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/searchVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.searchVideos("how to make espresso");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.searchVideos("how to make espresso"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/searchVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"how to make espresso"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.searchVideos("how to make espresso");suggestSearchesAutocomplete a half-typed query the way Pinterest's search box does.Arguments
Name Type Required termstringYes Returns
{ suggestions: PinterestSuggestion[] }interface PinterestSuggestion { type: "query" | "user"; text: string; url?: string; username?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/suggestSearchesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.suggestSearches("espresso");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.suggestSearches("espresso"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/suggestSearches \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"term":"espresso"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.suggestSearches("espresso");
commentOnPinLeave a comment on a pin as the caller.Arguments
Name Type Required pinIdstringYes textstringYes options{ aggregatedPinDataId?: string }No Returns
Record<string, unknown>HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/commentOnPinCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.commentOnPin("<pinId>", "<text>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.commentOnPin("<pinId>", "<text>"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/commentOnPin \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"pinId":"<pinId>","text":"<text>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.commentOnPin("<pinId>", "<text>");createBoardMake a new board on the caller's account, public or secret, with a name and description.Arguments
Name Type Required namestringYes options{ privacy?: "secret" | "public"; description?: string }No Returns
PinterestBoardinterface PinterestBoard { id: string; name: string; url: string; pin_count?: number; section_count?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/createBoardCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.createBoard("<name>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.createBoard("<name>"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/createBoard \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name":"<name>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.createBoard("<name>");createPinCreate a new pin on the caller's account from an image and a destination link, with a title and description.Arguments
Name Type Required boardIdstringYes pin{ imageUrl: string; link?: string; title?: string; description?: string; sectionId?: string }Yes Returns
PinterestPininterface PinterestPin { id: string; grid_title: string; link: string; pinner?: { username: string; full_name?: string }; board?: { id: string; name: string }; images?: Record<string, { width: number; height: number; url: string }>; product_metadata?: { price_val?: number; price_currency?: string; rating?: number; review_count?: number; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/createPinCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.createPin("<boardId>", {});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.createPin("<boardId>", {}))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/createPin \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"boardId":"<boardId>","pin":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.createPin("<boardId>", {});deleteBoardDelete one of the caller's own boards.Arguments
Name Type Required boardIdstringYes Returns
{ boardId: string; deleted: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/deleteBoardCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.deleteBoard("<boardId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.deleteBoard("<boardId>"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/deleteBoard \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"boardId":"<boardId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.deleteBoard("<boardId>");deletePinDelete a pin the caller created or saved.Arguments
Name Type Required pinIdstringYes Returns
{ pinId: string; deleted: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/deletePinCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.deletePin("<pinId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.deletePin("<pinId>"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/deletePin \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"pinId":"<pinId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.deletePin("<pinId>");followBoardFollow a single board rather than everything its owner posts.Arguments
Name Type Required boardIdstringYes Returns
{ boardId: string; following: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/followBoardCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.followBoard("<boardId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.followBoard("<boardId>"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/followBoard \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"boardId":"<boardId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.followBoard("<boardId>");followTopicFollow one of Pinterest's idea topics, which is what steers the caller's home feed.Arguments
Name Type Required topicIdstringYes Returns
{ topicId: string; following: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/followTopicCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.followTopic("<topicId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.followTopic("<topicId>"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/followTopic \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"topicId":"<topicId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.followTopic("<topicId>");followUserFollow a person or a brand on the caller's behalf.Arguments
Name Type Required userIdstringYes Returns
{ userId: string; following: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/followUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.followUser("<userId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.followUser("<userId>"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/followUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"<userId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.followUser("<userId>");savePinSave an existing pin to one of the caller's boards.Arguments
Name Type Required pinIdstringYes boardIdstringYes options{ sectionId?: string; description?: string }No Returns
PinterestPininterface PinterestPin { id: string; grid_title: string; link: string; pinner?: { username: string; full_name?: string }; board?: { id: string; name: string }; images?: Record<string, { width: number; height: number; url: string }>; product_metadata?: { price_val?: number; price_currency?: string; rating?: number; review_count?: number; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/savePinCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.savePin("<pinId>", "<boardId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.savePin("<pinId>", "<boardId>"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/savePin \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"pinId":"<pinId>","boardId":"<boardId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.savePin("<pinId>", "<boardId>");sendPinSend a pin to somebody in a Pinterest message.Arguments
Name Type Required pinIdstringYes recipients{ userIds?: string[]; emails?: string[] }Yes options{ message?: string }No Returns
Record<string, unknown>HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/sendPinCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.sendPin("<pinId>", {});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.sendPin("<pinId>", {}))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/sendPin \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"pinId":"<pinId>","recipients":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.sendPin("<pinId>", {});unfollowBoardStop following a board.Arguments
Name Type Required boardIdstringYes Returns
{ boardId: string; following: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/unfollowBoardCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.unfollowBoard("<boardId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.unfollowBoard("<boardId>"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/unfollowBoard \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"boardId":"<boardId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.unfollowBoard("<boardId>");unfollowTopicStop following an idea topic.Arguments
Name Type Required topicIdstringYes Returns
{ topicId: string; following: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/unfollowTopicCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.unfollowTopic("<topicId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.unfollowTopic("<topicId>"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/unfollowTopic \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"topicId":"<topicId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.unfollowTopic("<topicId>");unfollowUserStop following a person or a brand.Arguments
Name Type Required userIdstringYes Returns
{ userId: string; following: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/unfollowUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.unfollowUser("<userId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.unfollowUser("<userId>"))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/unfollowUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"userId":"<userId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.unfollowUser("<userId>");updateBoardRename a board, change its description, or flip it between public and secret.Arguments
Name Type Required boardIdstringYes changes{ name?: string; description?: string; privacy?: "secret" | "public" }Yes Returns
PinterestBoardinterface PinterestBoard { id: string; name: string; url: string; pin_count?: number; section_count?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/updateBoardCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.updateBoard("<boardId>", {});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.updateBoard("<boardId>", {}))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/updateBoard \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"boardId":"<boardId>","changes":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.updateBoard("<boardId>", {});updateProfileEdit the caller's own profile.Arguments
Name Type Required changes{ firstName?: string; lastName?: string; about?: string; websiteUrl?: string }Yes Returns
Record<string, unknown>HTTP endpoint
POST https://api.bowmark.ai/v1/sites/pinterest/updateProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.pinterest.updateProfile({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.pinterest.updateProfile({}))curl -X POST https://api.bowmark.ai/v1/sites/pinterest/updateProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"changes":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.pinterest.updateProfile({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/pinterest/<function> - OpenAPI
/v1/sites/pinterest/openapi.json