# Pinterest Search API (https://www.socialcrawl.dev/platforms/pinterest/search)

> Searches Pinterest for pins matching a keyword query. Returns a list of matching pins with titles, image URLs, save counts, author info, and board details.

TL;DR: `GET /v1/pinterest/search` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search query |
| `cursor` | no | Cursor |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/pinterest/search?query=home%20decor%20ideas" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search Pinterest pins by keyword with an API?

Send a GET request to /v1/pinterest/search with a query parameter. SocialCrawl returns matching pins with titles, image URLs, save counts, author info, and board details — ranked by Pinterest relevance.

### What data does each Pinterest search result include?

Each result returns pin id, title, description, image URL at multiple resolutions, save count, author info, and the board it's pinned to. All normalised into the unified SocialCrawl post schema.

### Can I paginate through Pinterest search results?

Yes. Pass the cursor parameter returned in the previous response to fetch the next page. Combined with trim=true, this makes it easy to stream thousands of pins for trend analysis without blowing up bandwidth.

### How is this different from the official Pinterest API?

The official Pinterest API requires OAuth, a business account, and app review, and does not expose keyword pin search at the depth SocialCrawl does. Our search endpoint works with any x-api-key — no Pinterest login.

### How much does the Pinterest Search API cost?

Each search costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required — enough to run 100 Pinterest keyword searches before you pay anything.

See the full Pinterest API: https://www.socialcrawl.dev/platforms/pinterest

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to search Pinterest pins by keyword with an API
- What does the SocialCrawl Pinterest Search endpoint return?