{ "openapi": "3.0.1", "info": { "title": "Pinterest Trends Scraper & Monitor - Rising Keywords", "description": "Pinterest Trends keywords for US, UK, DE, FR, BR and more: rank, weekly, monthly and yearly change, seasonality. Growing, top monthly, top yearly or seasonal lists. Watch mode returns only new terms. No login.", "version": "0.1", "x-build-id": "gry9ctj2Rktd7SVhb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~pinterest-trends-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-pinterest-trends-monitor", "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/neverempty~pinterest-trends-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-pinterest-trends-monitor", "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/neverempty~pinterest-trends-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-pinterest-trends-monitor", "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", "type": "array", "description": "Country codes as Pinterest Trends uses them: US, CA, GB, DE, FR, IT, ES, BR, MX, AR, CO, IN, ID, KR, TR, MY, PH, TH, SA, EG, or a group such as GB+IE, DE+AT+CH, AU+NZ, MX+AR+CO+CL, SE+DK+FI+NO, NL+BE+LU. One per line. Each country is one list and each term is one result row. A code Pinterest does not accept (for example AU alone, or JP) comes back as a free row that says so. Up to 40 per run. Empty = US (not allowed in watch mode).", "items": { "type": "string" } }, "trendType": { "title": "List type", "enum": [ "growing", "monthly", "yearly", "seasonal" ], "type": "string", "description": "Which Pinterest Trends list to read. Empty = growing (the terms rising fastest, the same list Pinterest Trends opens with)." }, "maxTermsPerCountry": { "title": "Terms per country", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many terms to take from the top of each list, 1 to 100 (Pinterest Trends gives at most 100). Empty = 100. In watch mode this is the part of the list being watched." }, "onlyNew": { "title": "Only return terms not returned before (watch mode)", "type": "boolean", "description": "On = for scheduled runs and alerts. The first run returns the whole list for each country (changeType first-check). Later runs return only terms this watch has not returned before for that country and list type (changeType new). A country with nothing new comes back as a free no-new-trends row. A term not seen in the list for 28 days is forgotten, so it is returned again if it comes back. Each row has dataEndDate, the last day Pinterest's data covers. Off (or empty) = always return the whole list." }, "watchName": { "title": "Watch name", "pattern": "^[A-Za-z0-9._-]{0,40}$", "type": "string", "description": "Optional, used with watch mode. Runs with the same watch name share what has already been returned. Give a different name to each schedule. Do not run two schedules with the same watch name at the same time. Letters, digits, dot, dash and underscore." }, "resetMonitoringState": { "title": "Reset monitoring state", "type": "boolean", "description": "Forget what this watch remembered at the start of this run, so every list is a first check again. Turn it off again for scheduled runs." } } }, "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 } } } } } } } } } }