---
title: "Pinterest API: Search Pins, No App Review · SocialToAI"
canonical: https://socialtoai.app/platforms/pinterest/
updated: 2026-10-17
---

# Pinterest API

The Pinterest API lets you search posts and read post details, with no Pinterest account or login. Each call costs 2 credits ($0.004 to $0.0067); failed calls are free. Pinterest does not give view counts, so that field is returned as null. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-19.

- Page: https://socialtoai.app/platforms/pinterest/
- Last updated: 2026-10-17
- Last tested: 2026-11-19

## Actions

| Action | What it returns | Selected by | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- | --- |
| `search` | Find posts by keyword: text, author and publish time. | — | `pinterest.search` | 2 | [Pinterest Search API](https://socialtoai.app/pinterest-search-api.md) |
| `detail` | One post by ID or link: text, author, likes, comment count and publish time. | — | `pinterest.detail` | 2 | [Pinterest Detail API](https://socialtoai.app/pinterest-detail-api.md) |

Not offered on Pinterest: trending, comments, user_profile and user_posts.

Compared with Instagram: Pinterest posts also give title, author followers, shares and saves but do not give views or hashtags.

Lighter for your AI: across 2 interfaces measured on the same recorded data, the platform's raw JSON is about 43,466 tokens and SocialToAI's answers about 4,677, 89% fewer (2026-11-06; the method is on the "How we measure" page).

## Example call

```bash
curl https://socialtoai.app/v1/search \
  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "pinterest",
    "query": "mid century living room"
  }'
```

## Fields Pinterest cannot give

These fields are always null on the calls named, and are listed in the response's `unavailable`.

| Field | On |
| --- | --- |
| `metrics.likes` | search |
| `metrics.comments` | search |
| `metrics.shares` | search |
| `metrics.collects` | search |
| `metrics.views` | search, detail |
| `metrics.reposts` | search, detail |
| `hashtags` | search, detail |
| `is_pinned` | search, detail |

## What a whole job costs

| The job | How it adds up | Credits | About |
| --- | --- | --- | --- |
| Search 1,000 results on Pinterest | usually 20 a page, 50 pages | 100 credits | about $0.33 |

Priced at the $10 pack; larger purchases bring it down. A watch runs only while it is on, and you can pause it at any time. There is no subscription.

## Ask in your AI

- Which is bigger on Pinterest this week: home coffee or matcha? → search, search: 4 credits

[Pinterest MCP Server](https://socialtoai.app/mcp/pinterest.md)

## Ready-made tools that read Pinterest

- [Brand buzz](https://socialtoai.app/tools/brand-buzz.md): How people feel about it on each platform, what comes up most, and the posts behind it

## Official API

Pinterest offers an official API for creators, advertisers and merchants. Apps must be submitted for review, start with Trial access, and need a further review with a demo of the OAuth flow for Standard access; the docs list reading boards and Pins but do not describe a public content search.

Source: [Pinterest's developer documentation](https://developers.pinterest.com/docs/key-concepts/access-tiers/), checked 2026-10-17.

1,000 posts here: about 50 `pinterest.search` calls (typically 20 a page), 100 credits, $0.33 at the first pack. [Estimate your cost](https://socialtoai.app/free-tools/api-cost-estimator.md)

[Pinterest official API: access, prices and limits](https://socialtoai.app/does-pinterest-have-an-api.md)

- [Pinterest MCP server](https://socialtoai.app/mcp/pinterest.md): Let your AI read Pinterest.
