---
title: "Trends"
method: GET
path: "/v1/pinterest/trends"
tags: ["pinterest"]
---

# Trends

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

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.

## 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'
- `type` 'growing' | 'seasonal' | 'top_monthly' | 'top_yearly'
- `limit` integer
- `include` string
- `exclude` string
- `dry_run` '1'

## Response `200`

Success.

- object
  - `success` true, required
  - `platform` string, required
  - `endpoint` string, required
  - `schema_version` '2', required
  - `data` ConventionsData, required
  - `pagination` Pagination
    - `next_cursor` string, nullable, required
    - `has_more` boolean, required
    - `page_size` integer, required
    - `stopped_at` 'since' | 'known_id' | 'end', nullable
  - `unavailable` string[], required
  - `credits_used` integer, required
  - `credits_remaining` integer, required
  - `request_id` string, required
  - `cached` boolean, required
  - `idempotent_replay` boolean, required
  - `charge_reason` string, required
  - `free_call` boolean, required

## Other responses

- `400`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `401`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `402`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `404`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `409`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `429`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `500`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `503`: See [Error handling](https://www.insightsocial.app/docs/errors).

---

[API](https://skmtc.dev/insightsocial/apis/insightsocial-api.md) · [All operations](https://skmtc.dev/insightsocial/apis/insightsocial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/insightsocial/apis/insightsocial-api/revisions/c82924cdabf2?raw)