Pinterest API

Pinterest Scraper API for Pins, Boards and Profiles

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

Put Pinterest data to work.

Find your use case, then explore the request and response.

Search Pinterest pins

GET/v1/pinterest/search

Build a visual inspiration finder from keyword-matched pins, their images, descriptions and destination links.

Search Pinterest boards

GET/v1/pinterest/search/boards

Build a curated-collection finder from keyword-matched boards with owners, pin and follower counts and cover images.

Search Pinterest users

GET/v1/pinterest/search/users

Build a creator discovery list from keyword-matched accounts with follower, pin and board counts and verification.

Get search suggestions

GET/v1/pinterest/search/suggestions

Build keyword research autocomplete from the queries and accounts Pinterest suggests for a partial search term.

Get a Pinterest pin

GET/v1/pinterest/pin

Build a visual research card from a pin’s image, description, creator and engagement information.

Get pin metadata

GET/v1/pinterest/pin/metadata

Build a pin enrichment pipeline using media, destination, author, board and engagement metadata.

Get related pins

GET/v1/pinterest/pin/related

Build a “more like this” shelf from the pins Pinterest recommends next to a seed pin, with their images and destinations.

Get a Pinterest profile

GET/v1/pinterest/profile

Build a creator profile card from a username’s bio, website, follower and pin counts and monthly profile views.

Get a user’s boards

GET/v1/pinterest/user/boards

Build a creator mood-board directory from public board names, descriptions, covers, creation dates and counts.

Get a user’s pins

GET/v1/pinterest/user/pins

Build a creator content feed by paging through the pins an account saved, newest first, with images and links.

Show more endpoints (3)Show fewer endpoints

Get pins from a board

GET/v1/pinterest/board

Build a visual collection browser by paging through a board’s pins with their destinations, summaries and reactions.

Get board metadata

GET/v1/pinterest/board/metadata

Build a board tracker that records a collection’s owner, pin, follower and section counts without loading its pins.

Get URL save counts

GET/v1/pinterest/url-stats

Build a content performance report showing how many times each of your article or product URLs was saved to Pinterest.

HOW IT WORKS

From API key to Pinterest data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 13 Pinterest endpoints and add its input, such as a search query.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Pinterest data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

TRY IT HERE / LIVE SAMPLE

Try a sample request.

Try the Pinterest API right here. This sample uses the Search Pinterest pins endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with minimalist kitchen, or change the query field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Search Pinterest pinsNo API key needed

Preparing the sample…

// 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);
GET/v1/pinterest/search

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 successful requests

Growth

Save 6.3%

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 successful requests

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Pinterest API

Frequently Asked Questions

Explore the API reference

Pinterest API and scraping

What pin and board data can I retrieve with the 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.

How do I scrape Pinterest pins and their image metadata?

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.

Can the Pinterest API retrieve one pin from its URL?

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.

Pinterest: keyword search and board collections

Can the Pinterest search API return keyword-matched pins?

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.

How do I scrape a Pinterest board into a visual collection?

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.

Can I retrieve Pinterest pin reactions and repin counts?

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.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

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.

Can I call the scraping API from Python, JavaScript or the CLI?

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.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

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

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

No credit card needed.Building with an AI agent?