{ "openapi": "3.0.1", "info": { "title": "Pinterest Trends Scraper — Rising Search Terms", "description": "Top trending Pinterest search terms for 34 markets, each with week-on-week, month-on-month and year-on-year change plus a seasonality score. Choose growing, seasonal, monthly or yearly lists, filter by growth, sort by volume, and expand any term into related searches. No Pinterest account needed.", "version": "0.0", "x-build-id": "8OTO0IBwfG4zLWhGc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apt_marble~pinterest-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apt_marble-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/apt_marble~pinterest-trends-scraper/runs": { "post": { "operationId": "runs-sync-apt_marble-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/apt_marble~pinterest-trends-scraper/run-sync": { "post": { "operationId": "run-sync-apt_marble-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": { "countries": { "title": "Countries", "maxItems": 34, "uniqueItems": true, "type": "array", "description": "Which markets to pull trending search terms for. Pinterest publishes trends for some countries on their own and for others only as part of a grouped market, so use these exact values: US, CA, GB, GB+IE, FR, DE, DE+AT+CH, IT, ES, IT+ES+PT+GR+MT, NL+BE+LU, SE+DK+FI+NO, PL+RO+HU+SK, PL+RO+HU+SK+CZ, CY+CZ+GR+HU+MT+PL+RO+SK, TR, BR, MX, AR, CO, MX+AR+CO+CL, CR+DO+EC+GT+PE, AU+NZ, IN, ID, MY, PH, TH, KR, SA, EG, AE+SA+KW+QA+OM+BH+EG+IQ+DZ, IL+NG+PK+ZA+TR+MA+IN, JP. Anything else is reported and skipped rather than failing the run, with a note pointing at the grouped market it belongs to.", "default": [ "US" ], "items": { "type": "string" } }, "trendType": { "title": "Trend type", "enum": [ "growing", "seasonal", "topMonthly", "topYearly" ], "type": "string", "description": "Which of Pinterest's own trend lists to read. Growing shows terms accelerating fastest right now. Seasonal shows terms that reliably peak at this point in the year. Top monthly and Top yearly show the biggest terms over a longer window.", "default": "growing" }, "maxTermsPerCountry": { "title": "Maximum terms per country", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many trending terms to keep for each country, after filtering and sorting. Pinterest publishes at most 100 terms per country per day.", "default": 100 }, "sortBy": { "title": "Sort terms by", "enum": [ "weekly", "monthly", "yearly", "volume" ], "type": "string", "description": "Which growth window decides the order of the terms you keep. Search volume orders by relative popularity instead of growth.", "default": "weekly" }, "minWeekOverWeekGrowth": { "title": "Minimum week-on-week growth (%)", "minimum": -100, "maximum": 10001, "type": "integer", "description": "Keep only terms that grew at least this much versus the previous week. Leave empty to keep everything. Use a negative value to allow declining terms through." }, "expandWithSuggestions": { "title": "Add related search terms", "type": "boolean", "description": "Also collect Pinterest's own related search terms for the leading trends, as extra rows marked \"suggestion\". Great for long-tail keyword ideas, but Pinterest publishes no growth or volume figures for them, so those columns stay empty.", "default": false }, "suggestionSeedCount": { "title": "Terms to expand", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many of the leading trends per country to expand into related search terms. Only used when \"Add related search terms\" is on.", "default": 10 } } }, "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 } } }, "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 } } } } } } } } } }