For AI

View as Markdown Open in ChatGPT Open in Claude

Pinterest API

Also known as拼趣pinterest.com

2 endpoints read Pinterest: pins. From $0.0020 a call. No Pinterest login and no cookie; a failed call is free.

Start a free trial Try pin searchUse it in Claude or Cursor: Pinterest MCP →

Endpoints2 endpointsone response shape

PriceFrom $0.0020per call. Failed calls are free

When an upstream failsRetried for youChecked every day with real calls · 4 days on record

DataFetched liveat the moment of the call

One call, as it came back

A recorded call, fields already tidied up: ready for an AI or a spreadsheet.

Recorded

GET/v1/pinterest/pins/search$0.0020

FieldValue

typeimage

published_at2026-10-02 17:34 UTC

author.followers0

The first 3 rows of a response recorded 2026-10-12 22:19 UTC.

Run it in the Playground · $0.0020

Recorded response

{
  "code": "ok",
  "request_id": "8f42c018-b510-4cce-9533-a082757c59a7",
  "data": {
    "items": [
      {
        "id": "870575894658646279",
        "url": "https://www.pinterest.com/pin/870575894658646279/",
        "type": "image",
        "title": "Everything I pack for mid century living room",
        "text": "Three things nobody tells you about mid century living room.",
        "published_at": "2026-10-02T17:34:20.000Z",
        "author": {
          "id": "898579247663867395",
          "username": "sam_outdoors",
          "name": "Sam Okafor",
          "avatar_url": "https://i.pinimg.com/75x75_RS/88/d5/db/38bbe46636de919c5e4e.jpg",
          "verified": null,
          "followers": 0
        },
        "images": [
          "https://i.pinimg.com/736x/89/db/ff/8c70edfa316bb484a26c.jpg"
        ]
      },
      // … 15 more
    ]
  },
  "page": {
    "next_cursor": "c1.Ir7ipI3Y8OQV4RKFBP_omDtW7__SQKYW5lJ8Jrch",
    "cursor_expires_at": "2026-10-12T23:19:13.000Z",
    "has_more": true,
    "returned": 16
  },
  "warnings": [],
  "meta": {
    "capability": "pinterest.pins.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T22:19:13.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "lang": "capability",
      "metrics": "capability",
      "hashtags": "capability",
      "mentions": "capability",
      "is_pinned": "platform",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

From a response recorded 2026-10-12 22:19 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

What you can get

Each row is an endpoint: what it returns and what one call costs.

EndpointPathReturnsPrice

Pins2

Pinterest pin searchGET/v1/pinterest/pins/searchPost list$0.0020

Pinterest pin detailGET/v1/pinterest/pins/getPost$0.0020

Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing.Pinterest API pricing →Pinterest data in your AI →See live status →

What people build with it

Ready-made tasks your AI can run on Pinterest data. Each is a few calls under a spending cap.

Word of mouth and comment insight

Keyword search and mentions

“What is being said about this brand or keyword on each platform?”

Pinterest pin search$0.0020

Example run: 3 calls, at most $0.0240

Trends and topics

Breaking down a hit

“Why did this post take off?”

Pinterest pin detail$0.0020

Example run: 2 calls, at most $0.0040

Ask about Pinterest right inside Claude or Cursor

Add the DataXAPI MCP server and the AI finds the Pinterest endpoint it needs and calls it; answers link back to the source. You pay for the calls it makes.

Pinterest MCP setup →

https://api.dataxapi.com/mcp

Start in three steps

The call shown here is Pinterest pin search. Every other Pinterest endpoint is called the same way and answers in the same envelope.

Get a key

Call it, or let your AI call it

One GET from your code. Or paste this prompt into your agent with your key in it: it sets itself up, then finds and calls these endpoints by itself.

Read https://dataxapi.com/agents.md and set up DataXAPI in this agent. My API key is dx_live_…; use it for every DataXAPI call.

Read the same shape every time

Items are in data.items (one object in data.item), the next page in page.next_cursor, the charge in meta.billing.amount. A failed call is not charged.

Read the quickstart →

curl -G "https://api.dataxapi.com/v1/pinterest/pins/search" \
  --data-urlencode "query=mid century living room" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.pinterest.pins.search(query="mid century living room")
print(result["data"]["items"])

import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.pinterest.pins.search({ query: "mid century living room" });
console.log(result.data.items);

dataxapi call pinterest.pins.search 'query=mid century living room'

{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

Add this to your MCP client, then ask your agent to call pinterest.pins.search.

Edge cases

What the Pinterest endpoints do at their edges, and what to check when a call does not return what you expected.

Page sizes: A list returns 20 to 50 items a page, depending on the endpoint. Every list goes on to a next page: page.next_cursor, passed back as cursor, each page a call of its own.
Fields it cannot give: 2 of the 2 endpoints cannot fill every field of the object they return. Each endpoint's page lists which, and every answer repeats them in meta.unavailable: a missing field is never a silent zero.
The pin ID and link: A pin is named by its digits or its link (pinterest.com/pin/<id>); pin.it short links are not taken.
Search has no counts: Pins found by search carry no counts; read the pin itself for reactions, comments and saves.
Two kinds of saves: metrics.favorites is how often this pin was saved; ext.saves is the total for the same content across every copy, and comments are counted across every copy too.
Pages can be short: Pins with neither a title nor a description are dropped, and so are blocks of related searches, so a page can hold fewer pins than usual.

Questions about the Pinterest API

Short answers. The details are on each endpoint's page.

How is the Pinterest API priced?

Per call, no subscription. All 2 endpoints cost $0.0020 a call. You are charged when data comes back; a failed call costs nothing.

Do I need a Pinterest account or a cookie?

No. One DataXAPI key is all you hold: no Pinterest login, no cookie, no device to keep alive. The endpoints return publicly visible data only.

Is the data live?

A call fetches from Pinterest at that moment, and meta.fetched_at says when. A result is kept for 24 hours, so a retry with the same Idempotency-Key is not charged again.

Is an empty result charged?

A list that comes back empty is charged its price: the search was run. Reading one object that does not exist answers not_found and is free.

What happens when Pinterest changes something?

A call that fails is not charged, whatever the reason. An endpoint that is paused answers capability_paused, also free, and GET /v1/catalog/status says what is up right now.

Call Pinterest with one key.

Free trial on sign-up: up to 50 calls at $0.0020. No card. No Pinterest login, no cookie, no subscription. A failed call is free.

Start free