Pinterest Search API
Our Pinterest Search API allows you to scrape Pinterest search results: the pins that match your query, with their images and details.
Set type to search videos, products, boards, or profiles instead. To narrow a search, see Filtering, and to get more results, see Pagination.
The API endpoint is https://serpapi.com/search?engine=pinterest
Head to the playground for a live and interactive demo.
API parameters
Advanced filters
Pagination
next_page_token
Optional
Parameter defines the next page token. It is used for retrieving the next page of results. Up to 25 pins, or up to 50 boards or profiles, are returned per page.
The next page token can be found in the SerpApi JSON response: serpapi_pagination -> next_page_token. It must be used with the same q, type, and less_ai as the search it comes from.
SerpApi parameters
no_cache
Optional
Parameter will force SerpApi to fetch the Pinterest results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.
async
Optional
Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.
zero_trace
Optional
Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
output
Optional
Parameter defines the format of the result. It can be set to json (default) to get a structured JSON of the results, html to get the raw HTML retrieved, or md to get a Markdown-formatted version optimized for LLMs and AI agents.
json_restrictor
Optional
Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.
API results
JSON results
JSON output includes structured data for Pins, Boards, Profiles, Shopping Results, Featured Boards, Related Searches, Filters, and Pagination.
A search status is accessible through search_metadata.status.
It flows this way: Processing -> Success || Error.
If a search has failed, error will contain an error message.
search_metadata.id is the search ID inside SerpApi.
HTML results
This API does not have a full HTML response, only text.
search_metadata.prettify_html_file contains a link to the prettified version of the result.
It is displayed in the playground.
Markdown results
Markdown output is optimized for LLMs and AI agents. It provides a curated view of the JSON results
in a token-efficient format using tables, markdown links, and YAML frontmatter.
To access, use the output=md parameter, the /search.md endpoint, or request header Accept: text/markdown.
API examples
Result for q: coffee corner ideas
Each pin in pins has its Pinterest ID in pin_id, its link on Pinterest in pin_link, and the website it links to in link. Pinterest encrypts the ID of most pins it shows logged-out visitors (starting with e1_), and doesn't open pins by their encrypted ID, so they have no pin_link: their closest page on Pinterest is their board, in board.link. related_searches and filters are the refinements of the query under Pinterest's search bar, each related search and filter option with its serpapi_link.
{
"search_metadata": {
"id": "6ad27d0c16fc4d68f5e2c876",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/U-icszdTHIPol9dckOA2IDWwLMIr2TZ5A-lLGH9UTB4/6ad27d0c16fc4d68f5e2c876.json",
"markdown_endpoint": "https://serpapi.com/searches/U-icszdTHIPol9dckOA2IDWwLMIr2TZ5A-lLGH9UTB4/6ad27d0c16fc4d68f5e2c876.md",
"created_at": "2026-10-16 19:37:48 UTC",
"processed_at": "2026-10-16 19:37:48 UTC",
"pinterest_url": "https://www.pinterest.com/search/pins/?q=coffee%20corner%20ideas&rs=typed",
"raw_html_file": "https://serpapi.com/searches/U-icszdTHIPol9dckOA2IDWwLMIr2TZ5A-lLGH9UTB4/6ad27d0c16fc4d68f5e2c876.html",
"prettify_html_file": "https://serpapi.com/searches/U-icszdTHIPol9dckOA2IDWwLMIr2TZ5A-lLGH9UTB4/6ad27d0c16fc4d68f5e2c876.prettify",
"total_time_taken": 0.93
},
"search_parameters": {
"engine": "pinterest",
"q": "coffee corner ideas"
},
"related_searches": [
{
"name": "Small spaces",
"query": "coffee corner ideas small spaces",
"thumbnail": "https://i.pinimg.com/60x60/b1/4d/d7/b14dd795be300ef5ee4aea1d0c6121f2.jpg",
"link": "https://www.pinterest.com/search/pins/?q=coffee%20corner%20ideas%20small%20spaces&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=coffee+corner+ideas+small+spaces"
},
{
"name": "Countertop",
"query": "coffee corner ideas countertop",
"thumbnail": "https://i.pinimg.com/60x60/8a/e7/eb/8ae7ebdeb7e8647220c5b9b660c1d6d4.jpg",
"link": "https://www.pinterest.com/search/pins/?q=coffee%20corner%20ideas%20countertop&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=coffee+corner+ideas+countertop"
},
...
],
"filters": [
{
"name": "Style",
"options": [
{
"name": "Modern",
"query": "coffee corner ideas modern",
"link": "https://www.pinterest.com/search/pins/?q=coffee%20corner%20ideas%20modern&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=coffee+corner+ideas+modern"
},
{
"name": "Simple",
"query": "simple coffee corner ideas",
"link": "https://www.pinterest.com/search/pins/?q=simple%20coffee%20corner%20ideas&rs=typed",
"serpapi_link": "https://serpapi.com/search.json?engine=pinterest&q=simple+coffee+corner+ideas"
},
...
]
},
...
],
"pins": [
{
"pin_id": "e1_AfqPShwb11qcfjG6PuRMosJIHZdd_BsxWGWMlVrKVepZRnegfauA",
"title": "Turn an Empty Small Space Into a Coffee Station",
"description": "An unused stretch of wall can become a complete coffee zone without adding permanent cabinetry. A properly sized cart creates room for brewing, everyday supplies and storage while preserving the kitchen workspace.",
"link": "https://inplanty.com/c/coffee-stations-espresso-setups/best-coffee-carts-for-small-spaces",
"source": "inplanty.com",
"thumbnail": "https://i.pinimg.com/236x/2b/36/75/2b367566fcaf193124014ca647271759.jpg",
"original": "https://i.pinimg.com/originals/2b/36/75/2b367566fcaf193124014ca647271759.webp",
"original_width": 1000,
"original_height": 1500,
"dominant_color": "#997c5f",
"alt_text": "Small apartment space transformed into a complete rolling coffee station with brewing surface and organized storage.",
"reactions": 22,
"iso_date": "2026-09-20T08:33:55Z",
"pinner": {
"name": "INPLANTY | Home Transformations",
"username": "girly_wishlist",
"link": "https://www.pinterest.com/girly_wishlist/",
"followers": 220703,
"thumbnail": "https://i.pinimg.com/75x75_RS/15/8a/b0/158ab033898f9aff08ded75aadf529a3.jpg"
},
"board": {
"board_id": "124200970913004618",
"name": "Small Home Design Ideas",
"link": "https://www.pinterest.com/girly_wishlist/small-home-design-ideas/",
"pins": 16
}
},
{
"pin_id": "e1_AfqPShyeeGGFKbeBoEUx1Hbo3JHIrS-uJVzHX_m2SgdgFP4uM6r5",
"description": "#CoffeeCorner #CoffeeBar #CoffeeStation #CoffeeLovers #InteriorDesign #WarmHome",
"thumbnail": "https://i.pinimg.com/236x/df/5f/47/df5f47a45129753c1dfa07515e4806da.jpg",
"original": "https://i.pinimg.com/originals/df/5f/47/df5f47a45129753c1dfa07515e4806da.jpg",
"original_width": 736,
"original_height": 1307,
"dominant_color": "#a0876b",
"alt_text": "a kitchen with white cupboards and shelves filled with wine glasses, pots and plants",
"reactions": 5,
"iso_date": "2026-09-21T17:54:59Z",
...
},
...
],
"featured_boards": [
...
],
"serpapi_pagination": {
"next_page_token": "Y2JVSG81V2sxcmNHRlpWM1J5VFVad1YxWllaR3hpVmtZMldWVmFRMVV4U2xaWFZFWlhVak5v...",
"next": "https://serpapi.com/search.json?engine=pinterest&next_page_token=Y2JVSG81V2sxcmNHRlpWM1J5VFVad1YxWllaR3hpVmtZMldWVmFRMVV4U2xaWFZFWlhVak5v...&q=coffee+corner+ideas"
}
}
Result for type: videos
type sets the type of results, like Pinterest's search filter: pins (default), videos, boards, profiles, or products. Video pins have their video in video, with its duration, and its link to an HLS stream (.m3u8).
{
...
"search_parameters": {
"engine": "pinterest",
"q": "chocolate chip cookies",
"type": "videos"
},
...
"pins": [
{
"pin_id": "e1_AfqPShzJggLS7rH6WpRuFoJnTl7IakBcNlVgilkqPVpqulOOqO3P",
"title": "BEST Easy Chocolate Chip Cookies",
"description": "The BEST easy chocolate chip cookies you'll ever make. This homemade cookie recipe yields cookies that are perfectly thick, chewy, soft, gooey, and full of chocolate chips. You're going to love these from scratch Bakery Style Chocolate Chip Cookies. Better than Toll House!",
"link": "https://handletheheat.com/bakery-style-chocolate-chip-cookies/",
"source": "handletheheat.com",
"thumbnail": "https://i.pinimg.com/236x/da/d1/e5/dad1e524f0314ee943723a1e0c9582a7.jpg",
"original": "https://i.pinimg.com/originals/da/d1/e5/dad1e524f0314ee943723a1e0c9582a7.jpg",
"original_width": 736,
"original_height": 1472,
"dominant_color": "#97683d",
"alt_text": "the best easy chocolate chip cookies are made with only 3 ingredients and they're so good to eat",
"reactions": 206,
"iso_date": "2024-01-24T01:01:31Z",
"video": {
"link": "https://v1.pinimg.com/videos/iht/hls/77/00/e1/7700e1c7d02a9cd88dac852e3ea60fcc.m3u8",
"duration": "0:54",
"thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/77/00/e1/7700e1c7d02a9cd88dac852e3ea60fcc.0000000.jpg"
},
"pinner": {
"name": "Handle the Heat | Tessa Arias",
"username": "handleheat",
"link": "https://www.pinterest.com/handleheat/",
"followers": 273118,
"thumbnail": "https://i.pinimg.com/75x75_RS/66/2b/32/662b3217f09988712464003da08d1f82.jpg"
},
"board": {
"board_id": "168040698535624960",
"name": "Chocolate Chip Cookies",
"link": "https://www.pinterest.com/handleheat/chocolate-chip-cookies/",
"pins": 507
}
},
{
"pin_id": "e1_AfqPShwAOMpOSWnew_2lfHU4x4iK0R-p_IyZd497iNLAZ8bH",
"title": "Thick Chocolate Chip Cookies",
...
"video": {
"link": "https://v1.pinimg.com/videos/iht/hls/9c/a5/6e/9ca56e8e9c51cf84713936d65ae6ee95.m3u8",
"duration": "0:06",
"thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/9c/a5/6e/9ca56e8e9c51cf84713936d65ae6ee95.0000000.jpg"
},
...
},
...
],
...
}
Result for type: boards
Boards are in boards, with their name, description, number of pins, cover, and owner. Pinterest returns up to 50 boards per page.
{
...
"search_parameters": {
"engine": "pinterest",
"q": "coffee corner ideas",
"type": "boards"
},
"boards": [
{
"board_id": "477240960452986607",
"name": "Coffee Corner Ideas",
"description": "Coffee corner ideas in one place! This Pinterest board is full of inspiring coffee corner setups for small kitchens, cozy living rooms, or any little space in your home. Discover stylish coffee stations, smart storage solutions, shelves, and decor ideas to create your own cozy coffee spot. If you love coffee and beautiful interiors, this board will give you plenty of inspiration.",
"link": "https://www.pinterest.com/coffeelifestyleblog/coffee-corner-ideas/",
"pins": 77,
"sections": 0,
"collaborators": 0,
"thumbnail": "https://i.pinimg.com/474x/90/1b/c2/901bc2a6b5a1b65316fc995284622e18.jpg",
"pin_thumbnails": [
"https://i.pinimg.com/150x150/3e/d9/c5/3ed9c54beb747437307408f384f54d9e.jpg",
"https://i.pinimg.com/150x150/35/a5/57/35a557b702545c7be909daadc6e960d2.jpg",
...
],
"owner": {
"name": "Coffee Lifestyle Blog | Coffee Tips and Lifestyle Ideas",
"username": "coffeelifestyleblog",
"link": "https://www.pinterest.com/coffeelifestyleblog/",
"followers": 1146,
"thumbnail": "https://i.pinimg.com/75x75_RS/c1/ea/dc/c1eadce6b495b9dc1e2491315577c358.jpg"
}
},
{
"board_id": "64598644594538418",
"name": "Coffee corner ideas",
"link": "https://www.pinterest.com/klarso34/coffee-corner-ideas/",
"pins": 20,
...
},
...
],
...
}
Result for type: profiles
Profiles are in profiles, with their name, username, number of followers, pins, and boards, and whether they're verified merchants. Pinterest returns up to 50 profiles per page.
{
...
"search_parameters": {
"engine": "pinterest",
"q": "coffee",
"type": "profiles"
},
"profiles": [
{
"user_id": "130393489119643810",
"name": "This Coffee Life",
"username": "andipreston",
"link": "https://www.pinterest.com/andipreston/",
"followers": 3409,
"pins": 7605,
"boards": 62,
"thumbnail": "https://i.pinimg.com/140x140_RS/ad/8c/76/ad8c7667cf17cc1da9ac0637cb4b5039.jpg",
"pin_thumbnails": [
"https://i.pinimg.com/75x75/2d/6d/ca/2d6dca6c1bc75e6d9affce794b4225e7.jpg",
"https://i.pinimg.com/75x75/24/6a/e2/246ae265a9f9f5098d4de5e03c54ebb8.jpg",
...
]
},
...
{
"user_id": "225180187526956911",
"name": "Prima Coffee Equipment",
"username": "primacoffee",
"link": "https://www.pinterest.com/primacoffee/",
"followers": 1886,
"pins": 78351,
"boards": 22,
"verified_merchant": true,
"thumbnail": "https://i.pinimg.com/140x140_RS/56/31/bd/5631bde56a6fe7112a4b584615529593.jpg",
"pin_thumbnails": [
"https://i.pinimg.com/75x75/fe/a1/f0/fea1f0320e38f655ab004e8c42b5c892.jpg",
"https://i.pinimg.com/75x75/ef/3d/57/ef3d5794c01f0b5bc3f64508f0dff46b.jpg",
...
]
},
...
],
...
}
Result for type: products
products only shows the pins of products for sale, with their price, currency, and whether they're in_stock. Discounted products have their price before the discount in old_price.
{
...
"search_parameters": {
"engine": "pinterest",
"q": "coffee table",
"type": "products"
},
...
"pins": [
{
"pin_id": "e1_AfqPShxukFikJvKSS_389L13IRwl9yhrwx-pXle5KOGcvFrgTGIhHg",
"title": "Rectangle Coffee Table Solid Wood Coffee Table with Storage Shelf,Farmhouse 2-Tier Center Table Lacquered Classical Legs",
"description": "SOLID WOOD LEGS WITH MDF VENEER CONSTRUCTION: This coffee table features four sturdy solid wood legs paired with an MDF core wrapped in premium real wood veneer.",
"link": "https://www.bedbathandbeyond.com/c/living-room-tables/coffee-tables?t=24449&featuredproduct=44315735&featuredoption=93852388",
"source": "bedbathandbeyond.com",
"thumbnail": "https://i.pinimg.com/236x/7b/b1/75/7bb1757853f4308e1751051e64048cdd.jpg",
"original": "https://i.pinimg.com/originals/7b/b1/75/7bb1757853f4308e1751051e64048cdd.jpg",
"original_width": 2048,
"original_height": 2048,
"dominant_color": "#b6ab96",
"alt_text": "a green couch sitting next to a wooden table on top of a carpeted floor",
"reactions": 0,
"iso_date": "2026-08-21T08:32:55Z",
"price": "$249.99",
"extracted_price": 249.99,
"currency": "USD",
"in_stock": true,
"pinner": {
"name": "Bed Bath & Beyond",
"username": "bedbathbeyond",
"link": "https://www.pinterest.com/bedbathbeyond/",
"followers": 1468595,
"verified": true,
"thumbnail": "https://i.pinimg.com/75x75_RS/c0/9c/96/c09c9683cd82955f4a176436a8811268.jpg"
},
"board": {
"board_id": "246924060758592597",
"name": "Products",
"link": "https://www.pinterest.com/bedbathbeyond/_products/",
"pins": 58014489
}
},
...
{
"pin_id": "e1_AfqPShwM2nvDO5I3Qo34lsMEx-Ri2W2zFIpwTfM4-XyYp8aV4ZtOCw",
"title": "33.5\" Round 2-Tier Industrial Coffee Table with Open Shelf, Rustic Brown 18.5 H x 33.5 W x 33.5 D in Brown Steel",
"link": "https://www.wayfair.com/17-Stories--33.5-Round-2Tier-Industrial-Coffee-Table-with-Open-Shelf-Rustic-Brown-X233853770-L441-K~W122742669.html?refid=PSO49-W122742669",
"source": "wayfair.com",
...
"price": "$133.99",
"extracted_price": 133.99,
"old_price": "$229.99",
"extracted_old_price": 229.99,
"currency": "USD",
"in_stock": true,
...
},
...
],
...
}
Result for q: weding dreses (misspelled)
Pinterest searches for its correction of misspelled queries. The query it searched for is in search_information.
{
...
"search_parameters": {
"engine": "pinterest",
"q": "weding dreses"
},
"search_information": {
"showing_results_for": "wedding dresses",
"spelling_fix": "wedding dresses"
},
...
"pins": [
{
"pin_id": "e1_AfqPShytnFZFTcj5yy0aK73-0T9DZTudePAc01yqdiwVSWBlc0xH",
"title": "Arienne White Off-the-Shoulder Mermaid Maxi Dress",
"link": "https://www.lulus.com/products/arienne-white-off-the-shoulder-mermaid-maxi-dress/2525711.html",
"source": "lulus.com",
"thumbnail": "https://i.pinimg.com/236x/62/e7/1b/62e71bfcf977bf881143c7f6406e8eba.jpg",
...
},
...
],
...
}
JSON structure overview
{
...
"search_information": {
"showing_results_for": "String - Query Pinterest searched for instead of a misspelled query.",
"spelling_fix": "String - Correction of a misspelled query.",
"results_state": "String - 'Fully empty' when Pinterest has no results."
},
"related_searches": [
{
"name": "String - Name of the related search. (Ex. Small spaces)",
"query": "String - Query of the related search. (Ex. coffee corner ideas small spaces)",
"thumbnail": "String - Link to the thumbnail of the related search.",
"link": "String - Link to the related search on Pinterest.",
"serpapi_link": "String - SerpApi link to the related search."
}
],
"filters": [
{
"name": "String - Name of the filter. (Ex. Style)",
"options": [
{
"name": "String - Name of the option. (Ex. Modern)",
"query": "String - Query of the option. Search it in q to apply the option. (Ex. coffee corner ideas modern)",
"link": "String - Link to the search of the option on Pinterest.",
"serpapi_link": "String - SerpApi link to the search of the option."
}
]
}
],
"shopping_results": [
{
"...": "Pin - Pin of a product for sale, in a carousel of products of some searches for pins. Same fields as pins."
}
],
"pins": [
{
"pin_id": "String - Pinterest ID of the pin. Encrypted (starting with e1_) for most pins.",
"pin_link": "String - Link to the pin on Pinterest. Only for pins with a numeric ID.",
"title": "String - Title of the pin.",
"description": "String - Description of the pin.",
"link": "String - Link to the website the pin links to.",
"source": "String - Domain of the website the pin links to. (Ex. handletheheat.com)",
"thumbnail": "String - Link to the image of the pin, 236 pixels wide.",
"original": "String - Link to the original image of the pin.",
"original_width": "Integer - Width of the original image, in pixels.",
"original_height": "Integer - Height of the original image, in pixels.",
"dominant_color": "String - Dominant color of the image, as a hex code. (Ex. #916b45)",
"alt_text": "String - Alternative text of the image.",
"reactions": "Integer - Number of reactions to the pin.",
"iso_date": "String - Date the pin was created, in ISO 8601 format.",
"price": "String - Price of the product for sale, as displayed, or its lowest price if it's sold at several prices. (Ex. $249.99)",
"extracted_price": "Number - Price of the product for sale.",
"old_price": "String - Price of the product before its discount, as displayed.",
"extracted_old_price": "Number - Price of the product before its discount.",
"currency": "String - Currency of the price. (Ex. USD)",
"in_stock": "Boolean - True if the product is in stock.",
"video": {
"link": "String - Link to the video, as an HLS stream (.m3u8).",
"duration": "String - Duration of the video. (Ex. 0:54)",
"thumbnail": "String - Link to the thumbnail of the video."
},
"pinner": {
"name": "String - Name of the pinner.",
"username": "String - Username of the pinner.",
"link": "String - Link to the profile of the pinner.",
"followers": "Integer - Number of followers of the pinner.",
"verified": "Boolean - True if the pinner is verified.",
"thumbnail": "String - Link to the profile picture of the pinner."
},
"board": {
"board_id": "String - Pinterest ID of the board the pin is saved to.",
"name": "String - Name of the board.",
"link": "String - Link to the board.",
"pins": "Integer - Number of pins of the board."
}
}
],
"boards": [
{
"board_id": "String - Pinterest ID of the board.",
"name": "String - Name of the board.",
"description": "String - Description of the board.",
"link": "String - Link to the board on Pinterest.",
"pins": "Integer - Number of pins of the board.",
"sections": "Integer - Number of sections of the board.",
"collaborators": "Integer - Number of collaborators of the board.",
"thumbnail": "String - Link to the cover of the board.",
"pin_thumbnails": [
"String - Link to the thumbnail of a pin of the board."
],
"owner": {
"name": "String - Name of the owner of the board.",
"username": "String - Username of the owner.",
"link": "String - Link to the profile of the owner.",
"followers": "Integer - Number of followers of the owner.",
"verified": "Boolean - True if the owner is verified.",
"thumbnail": "String - Link to the profile picture of the owner."
}
}
],
"featured_boards": [
{
"...": "Board - Board in the carousel of featured boards of some searches for pins. Same fields as boards."
}
],
"profiles": [
{
"user_id": "String - Pinterest ID of the profile.",
"name": "String - Name of the profile.",
"username": "String - Username of the profile.",
"link": "String - Link to the profile on Pinterest.",
"followers": "Integer - Number of followers.",
"pins": "Integer - Number of pins.",
"boards": "Integer - Number of boards.",
"verified": "Boolean - True if the profile is verified.",
"verified_merchant": "Boolean - True if the profile is a verified merchant.",
"thumbnail": "String - Link to the profile picture.",
"pin_thumbnails": [
"String - Link to the thumbnail of a pin of the profile."
]
}
],
"serpapi_pagination": {
"next_page_token": "String - Token of the next page.",
"next": "String - SerpApi link to the next page."
}
}