# 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"
```

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