# Pinterest Trends API (https://www.socialcrawl.dev/platforms/pinterest/trends)

> Returns what people in one market are searching for on Pinterest, with no keyword in: the Pinterest Trends list for a country and a table. `type` picks the table: `growing` (terms rising fastest, the default), `seasonal` (terms that come back at this time every year), `top_monthly` or `top_yearly` (the most searched). Each item has `rank` (1 is the top), `term`, `country`, `market` (the list Pinterest reads it from: Ireland reads GB+IE, Australia and New Zealand read AU+NZ, Great Britain alone has its own list), `type`, `search_index` (relative search volume, 0 to 100 within the answer), `weekly_change`, `monthly_change` and `yearly_change` (as Pinterest reports them, a fraction where 0.3 is +30%; Pinterest reports 100.01 for a term that was near zero before), `seasonality` (0 to 1), `url` (the term's Pinterest Trends page) and `as_of` (the date Pinterest's weekly data is as of; null on the rare call served while Pinterest throttles the primary route). Narrow with `include` and `exclude`, comma-separated keywords. Filters that match nothing, and a list Pinterest has empty, return 404 at 0 credits. Flat 10 credits whatever the depth. Exact repeats within 6 hours are served from cache at 0 credits.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `country` | no | ISO country code, in any case: AR, AU, BR, CA, CO, DE, EG, ES, FR, GB, ID, IE, IN, IT, KR, MX, MY, NZ, PH, SA, TH, TR, US. Pinterest publishes no list for other countries, and one of them is a free 400. IE reads Pinterest's GB+IE list and AU and NZ read AU+NZ; GB alone has its own list. Defaults to US. (AR \| AU \| BR \| CA \| CO \| DE \| EG \| ES \| FR \| GB \| ID \| IE \| IN \| IT \| KR \| MX \| MY \| NZ \| PH \| SA \| TH \| TR \| US) |
| `type` | no | Which Pinterest Trends table: growing (the default), seasonal, top_monthly or top_yearly. (growing \| seasonal \| top_monthly \| top_yearly) |
| `limit` | no | How many terms to return, from the top, 1 to 50. Defaults to 25. The price is the same at any depth. |
| `include` | no | Keep only terms containing one of these keywords, comma-separated (up to 10, e.g. nails,wedding). |
| `exclude` | no | Drop terms containing any of these keywords, comma-separated (up to 10, e.g. fall). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/pinterest/trends" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### Is there a Pinterest Trends API?

Yes. /v1/pinterest/trends returns the Pinterest Trends list for a country as JSON, with no keyword needed. Each item has rank, term, country, market, type, search_index, weekly_change, monthly_change, yearly_change, seasonality, url and as_of.

### What are the Pinterest Trends tables I can pull?

type picks the table: growing (terms rising fastest, the default), seasonal (terms that return every year), top_monthly and top_yearly (the most searched). Add country (default US) and limit (1 to 50, default 25).

### What do search_index and the change fields mean?

search_index is relative search volume from 0 to 100 within the answer. weekly_change, monthly_change and yearly_change are as Pinterest reports them, a fraction where 0.3 is +30%, and Pinterest reports 100.01 for a term that was near zero before. as_of is the date Pinterest's weekly data is as of.

### Can I filter Pinterest trends by keyword?

Yes. include keeps terms containing one of up to 10 comma-separated keywords, such as nails,wedding, and exclude drops terms containing any of up to 10 keywords. Filters that match nothing return 404 at 0 credits.

### Which countries does the Pinterest Trends API cover?

Only countries Pinterest publishes a list for. Any other country is a free 400 that names the accepted codes. Ireland reads Pinterest's GB+IE list, Australia and New Zealand read AU+NZ, and Great Britain alone has its own list.

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

Each call costs 10 credits on the premium tier at any depth, whatever limit you set. Pinterest publishes weekly, so exact repeats within 6 hours come from cache at 0 credits, and credits for failed or empty calls are refunded automatically.

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:

- Is there a Pinterest Trends API for trending search terms by country?
- How do I get growing Pinterest search terms as JSON with SocialCrawl?
- Can I pull Pinterest seasonal trends with an API?