Search Pinterest pins
/v1/pinterest/searchBuild a visual inspiration finder from keyword-matched pins, their images, descriptions and destination links.
Search Pins, boards and creators, read Pin, profile and board details, follow related Pins and measure how often your pages are saved. Keep inspiration connected to its source.
WHAT YOU CAN BUILD / 13 ENDPOINTS
Find your use case, then explore the request and response.
/v1/pinterest/searchBuild a visual inspiration finder from keyword-matched pins, their images, descriptions and destination links.
/v1/pinterest/search/boardsBuild a curated-collection finder from keyword-matched boards with owners, pin and follower counts and cover images.
/v1/pinterest/search/usersBuild a creator discovery list from keyword-matched accounts with follower, pin and board counts and verification.
/v1/pinterest/search/suggestionsBuild keyword research autocomplete from the queries and accounts Pinterest suggests for a partial search term.
/v1/pinterest/pinBuild a visual research card from a pin’s image, description, creator and engagement information.
/v1/pinterest/pin/metadataBuild a pin enrichment pipeline using media, destination, author, board and engagement metadata.
/v1/pinterest/pin/relatedBuild a “more like this” shelf from the pins Pinterest recommends next to a seed pin, with their images and destinations.
/v1/pinterest/profileBuild a creator profile card from a username’s bio, website, follower and pin counts and monthly profile views.
/v1/pinterest/user/boardsBuild a creator mood-board directory from public board names, descriptions, covers, creation dates and counts.
/v1/pinterest/user/pinsBuild a creator content feed by paging through the pins an account saved, newest first, with images and links.
/v1/pinterest/boardBuild a visual collection browser by paging through a board’s pins with their destinations, summaries and reactions.
/v1/pinterest/board/metadataBuild a board tracker that records a collection’s owner, pin, follower and section counts without loading its pins.
/v1/pinterest/url-statsBuild a content performance report showing how many times each of your article or product URLs was saved to Pinterest.
HOW IT WORKS
Run a sample below without a key.
Create a free account and copy your key. You start with 100 free credits; no card needed.
Pick one of the 13 Pinterest endpoints and add its input, such as a search query.
Call it with your key in the x-api-key header. ScrapeAtlas reads the public Pinterest data and retries when a read fails.
Get structured JSON with a coverage status. Only successful requests use a credit.
TRY IT HERE / LIVE SAMPLE
Try the Pinterest API right here. This sample uses the Search Pinterest pins endpoint and returns live JSON. No API key needed.
Start with minimalist kitchen, or change the query field to your own value.
Execute the sample code and see the response in the JSON response tab.
Open the full playground to try more parameters and copy code for your app.
// Run this sample here — no API key needed.
const value = "minimalist kitchen";
const url = new URL("/website/demo/pinterest",
"https://api.scrapeatlas.com");
url.searchParams.set("value", value);
const response = await fetch(url);
const data = await response.json();
console.log(data);
Run the sample to see the live JSON response here.
/v1/pinterest/searchA live example from our playground. Change the value above, then select Run sample.
CUSTOMER STORIES
Watch Nigel’s story
Watch Janu’s storyEmail Viktor with a testimonial & receive 10,000 free credits.
Pay as you go
One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.
Try the API with your next idea.
$0No credit card needed
100 free credits
One starter grant per account
For a new idea or a one-off project.
$19USD / one-time
10,000 credits
$1.90 per 1,000 successful requests
For regular workflows and bigger builds.
$89USD / one-time
50,000 credits
$1.78 per 1,000 successful requests
Enterprise Plan
Let’s talk about a plan that fits your scale.
Pinterest API
Search public pins, boards and users, retrieve pin details, metadata and related pins, read profiles with their boards and saved pins, browse the pins on a board and count how often web pages were saved. Responses include image, description, destination and creator information for visual research workflows.
Use Pin Details or Pin Metadata with a public pin URL to retrieve its description, images, media references and associated author or board information. Use Search to discover pins around a keyword first.
Yes. Pin Details and Pin Metadata accept a public pin URL and return its descriptive and media fields. Keep the pin’s author, board context and destination alongside the image references in your visual research application.
Yes. Search Pins retrieves matching records with images, descriptions, destinations and associated metadata. Pass the returned cursor to continue the search, and select compact records when you want a smaller projection. Search Boards and Search Users cover collections and creators, and Search Suggestions returns Pinterest’s autocomplete for a partial term.
List a user’s boards to find the board you need, then use Board Pins to retrieve its pin records. Continue with the cursor and board identity from the response to build your application’s collection. Board Metadata returns the board’s owner and counts without its pins.
Pin Details includes repin, share and reaction fields in its compact projection. Combine the returned counters with the pin description and creator to compare the engagement information associated with selected pins.
Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.
Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.
Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.
Make something with it
Bring social data into your next project.
Start with 100 free credits and see what you can build.
We use essential storage to keep the site working. With your permission, optional analytics cookies help us understand visits. You can change your choice anytime. Privacy policy
Google Analytics and PostHog measure visits, page engagement, signup-link clicks and website performance. Rejecting optional cookies does not affect access to the site.
Allow Affonso to record your referral visit and store a cookie for 30 days. If you sign up, we share your verified email with Affonso to attribute purchases. Privacy policy