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.

100 credits per call.

get/v1/pinterest/trends

Request

Base URL: https://api.insightsocial.app
URL: https://api.insightsocial.app/v1/pinterest/trends
Auth: API key in header x-api-key

Query parameters

country'AR' | 'AU' | 'BR' | 'CA' | 'CO' | 'DE' | 'EG' | 'ES' | 'FR' | 'GB' | 'ID' | 'IE' | 'IN' | 'IT' | 'KR' | 'MX' | 'MY' | 'NZ' | 'PH' | 'SA' | 'TH' | 'TR' | 'US'

Example:DE

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.

type'growing' | 'seasonal' | 'top_monthly' | 'top_yearly'

Example:growing

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

limitinteger

Example:5

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

includestring

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

excludestring

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

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required

platformstring required

endpointstring required

schema_version'2' required

dataConventionsData required

unavailablestring[] required

credits_usedinteger required

credits_remaininginteger required

request_idstring required

cachedboolean required

idempotent_replayboolean required

charge_reasonstring required

free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.