InsightSocial API
Pinterest

Trends

GET
/v1/pinterest/trends

Returns the Pinterest Trends list for one country: ranked search terms with a relative search index, for growing, seasonal, monthly or yearly tables.

Use it when you want what a market is searching for on Pinterest right now, with no keyword to start from.

200 credits per call.

Re-running the exact same call within 6h is free.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

country?string

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.

Value in

  • "AR"
  • "AU"
  • "BR"
  • "CA"
  • "CO"
  • "DE"
  • "EG"
  • "ES"
  • "FR"
  • "GB"
  • "ID"
  • "IE"
  • "IN"
  • "IT"
  • "KR"
  • "MX"
  • "MY"
  • "NZ"
  • "PH"
  • "SA"
  • "TH"
  • "TR"
  • "US"
type?string

Which Pinterest Trends table: growing (the default), seasonal, top_monthly or top_yearly.

Value in

  • "growing"
  • "seasonal"
  • "top_monthly"
  • "top_yearly"
limit?integer

How many terms to return, from the top, 1 to 50. Defaults to 25. The price is the same at any depth.

Range1 <= value <= 50
include?string

Keep only terms containing one of these keywords, comma-separated (up to 10, e.g. nails,wedding).

exclude?string

Drop terms containing any of these keywords, comma-separated (up to 10, e.g. fall).

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/pinterest/trends"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}

Search GET

Returns Pinterest pins matching a keyword, each with its text, original image, pinner and pin date; include=engagement adds save, reaction, comment and share counts. Use it to discover pins on a topic; add include=engagement for each pin's saves, or call pin when you already have one pin URL. **Metered: 20–520 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes. Re-running the exact same call within 1h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).

Url Stats GET

Returns how many times each of up to 10 external URLs has been saved to Pinterest through the Save Button. Use it to measure a page's pull on Pinterest, passing URLs exactly as used, since http vs https and a trailing slash count as different URLs. **20 credits** per call. Re-running the exact same call within 6h is free.