{ "openapi": "3.0.1", "info": { "title": "Pinterest Trends Scraper — Keywords, Growth, History", "description": "Pinterest Trends without login: top, growing and seasonal keywords with weekly, monthly and yearly growth, weekly history of your own keywords, related terms and audience age and gender. 29 countries and regions.", "version": "0.1", "x-build-id": "JW5N0dIFrMkFzmrIj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/talvok~pinterest-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-talvok-pinterest-trends-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/talvok~pinterest-trends-scraper/runs": { "post": { "operationId": "runs-sync-talvok-pinterest-trends-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/talvok~pinterest-trends-scraper/run-sync": { "post": { "operationId": "run-sync-talvok-pinterest-trends-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "What to get", "enum": [ "trends", "history", "related" ], "type": "string", "description": "Trends: the trending keywords that Pinterest lists for a country. Keyword history: the weekly history and growth of your own keywords. Related terms: up to 5 related keywords for each of your keywords, each with its own history and growth.", "default": "trends" }, "country": { "title": "Country or region", "enum": [ "US", "CA", "GB+IE", "FR", "DE", "DE+AT+CH", "IT", "ES", "IT+ES+PT+GR+MT", "SE+DK+FI+NO", "NL+BE+LU", "PL+RO+HU+SK+CZ", "CY+CZ+GR+HU+MT+PL+RO+SK", "AU+NZ", "BR", "MX", "AR", "CO", "MX+AR+CO+CL", "CR+DO+EC+GT+PE", "IN", "ID", "MY", "PH", "TH", "KR", "SA", "EG", "TR" ], "type": "string", "description": "Country or region of the Pinterest users. Regions are the groups shown on trends.pinterest.com, e.g. \"GB+IE\" for Great Britain & Ireland.", "default": "US" }, "trendType": { "title": "Trend type (Trends mode)", "enum": [ "growing", "top_monthly", "top_yearly", "seasonal" ], "type": "string", "description": "Which Pinterest list to read in Trends mode. Growing: fastest-growing keywords. Top monthly / Top yearly: most searched keywords of the last month / year. Seasonal: keywords that come back every year at this time.", "default": "growing" }, "terms": { "title": "Keywords (history and related modes)", "type": "array", "description": "Your keywords, e.g. \"fall nails\", \"halloween costume ideas\". Pinterest tracks lowercase search terms: the scraper lowercases them for you. A keyword Pinterest does not track returns no data, and the log suggests similar keywords that do have data. Ignored in Trends mode.", "items": { "type": "string" } }, "interests": { "title": "Interests (Trends mode)", "type": "array", "description": "Optional. Only trends from these Pinterest interest categories. Leave empty for all interests.", "items": { "type": "string", "enum": [ "Animals", "Architecture", "Art", "Beauty", "Children's Fashion", "DIY and Crafts", "Design", "Education", "Electronics", "Entertainment", "Event Planning", "Finance", "Food and Drinks", "Gardening", "Health", "Home Decor", "Men's Fashion", "Parenting", "Quotes", "Sport", "Travel", "Vehicles", "Wedding", "Women's Fashion" ] } }, "ageGroups": { "title": "Age groups", "type": "array", "description": "Optional. Only searches made by people of these ages. Works in all modes. Leave empty for all ages.", "items": { "type": "string", "enum": [ "18-24", "25-34", "35-44", "45-49", "50-54", "55-64", "65+" ] } }, "genders": { "title": "Genders", "type": "array", "description": "Optional. Only searches made by people of these genders. Works in all modes. Leave empty for all genders.", "items": { "type": "string", "enum": [ "female", "male", "unspecified" ], "enumTitles": [ "Female", "Male", "Unspecified" ] } }, "includeKeywords": { "title": "Only trends containing (Trends mode)", "type": "array", "description": "Optional. Keep only trends that contain at least one of these words, e.g. \"nails\".", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude trends containing (Trends mode)", "type": "array", "description": "Optional. Drop trends that contain any of these words.", "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of keywords to save. In Trends mode Pinterest returns at most 100 trends per list. In Related mode Pinterest gives up to 5 related terms per keyword.", "default": 50 }, "historyPeriod": { "title": "History period", "enum": [ "90", "180", "365", "730" ], "type": "string", "description": "Length of the weekly history. Pinterest computes the yearly change only with 24 months of history; with shorter periods yearlyChangePercent is empty in history and related modes.", "default": "365" }, "includeHistory": { "title": "Add weekly history to trends (Trends mode)", "type": "boolean", "description": "Trends mode: also add the weekly history of each trend (one extra request per 20 trends). History and related modes always include it.", "default": false }, "includeDemographics": { "title": "Add audience age and gender", "type": "boolean", "description": "Add the share of searches by age group and gender for each keyword (one extra request per 20 keywords).", "default": false }, "includeForecast": { "title": "Add 13-week forecast (United States only)", "type": "boolean", "description": "Add Pinterest's forecast for the next 13 weeks, with lower and upper bounds, to the weekly history. Available only for the United States, without age or gender filters, for the latest week. With the forecast on, history and forecast share one 0-100 scale.", "default": false }, "endDate": { "title": "Week ending on", "type": "string", "description": "Optional, format YYYY-MM-DD. Leave empty for the latest week available (recommended). Pinterest uses weeks that end on a Friday: another day is moved back to the Friday before. Pinterest keeps the last 12 months." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Use a proxy if Pinterest starts rate-limiting requests (HTTP 429).", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }