{ "openapi": "3.0.1", "info": { "title": "Pinterest Keyword Tool with Search Volume", "description": "Pinterest keyword research tool with real Pinterest search volume. Type one keyword and get thousands of Pinterest keywords grouped by topic, with post ideas and full export. No login. Free to try.", "version": "0.2", "x-build-id": "gdbVq55nliE6NnvDc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hamdisaidani~pinterest-keyword-tool/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hamdisaidani-pinterest-keyword-tool", "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/hamdisaidani~pinterest-keyword-tool/runs": { "post": { "operationId": "runs-sync-hamdisaidani-pinterest-keyword-tool", "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/hamdisaidani~pinterest-keyword-tool/run-sync": { "post": { "operationId": "run-sync-hamdisaidani-pinterest-keyword-tool", "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", "required": [ "seeds" ], "properties": { "seeds": { "title": "Seed keywords", "type": "array", "description": "One keyword per line, 1 to 6 words each. Example: pioneer woman, slow cooker chicken, fall nails. Any language works.", "items": { "type": "string" } }, "depth": { "title": "Search depth", "enum": [ "standard", "deep", "max", "full" ], "type": "string", "description": "Start with Quick to see the tool. Pinterest shows only 12 suggestions per search, so most keywords are hidden: Deep searches every keyword again for its own children (pioneer woman > pioneer woman chili > pioneer woman chili mac) and digs by letter wherever Pinterest has more. Results appear in the table while the run is still working.", "default": "standard" }, "keywordTree": { "title": "Search the children of every keyword (keyword tree)", "type": "boolean", "description": "Each keyword found is searched again to get the longer keywords under it. Turn off to dig by letters only.", "default": true }, "searchVolume": { "title": "Pinterest search volume", "enum": [ "all", "main", "off" ], "type": "string", "description": "Adds the number Pinterest shows on its Ideas pages (\"N people searched this\") and the keyword's category. The number is worldwide and long-term; Pinterest does not publish the exact period. Not every keyword has one.", "default": "all" }, "estimateMissing": { "title": "Estimate searches when Pinterest has no number", "type": "boolean", "description": "Many long keywords have no published number. Pinterest still ranks them with a popularity score, and that score follows the real numbers very closely (tested on 414 keywords: half of the estimates are within x1.22 of the real number, 90% within x1.56). Estimated numbers are always marked as estimated. Available on paid Apify plans.", "default": true }, "includeLetters": { "title": "Add A to Z after the keyword", "type": "boolean", "description": "Searches \"keyword a\", \"keyword b\" ... \"keyword z\". Arabic seeds use the Arabic alphabet.", "default": true }, "includeNumbers": { "title": "Add 0 to 9 after the keyword", "type": "boolean", "description": "Finds things like \"3 ingredient\", \"30 minute\", \"2026 trends\".", "default": true }, "includePrefixLetters": { "title": "Add A to Z before the keyword", "type": "boolean", "description": "Searches \"a keyword\", \"b keyword\" ... Finds words people put in front, like \"easy\" or \"best\".", "default": false }, "includeQuestionWords": { "title": "Add question and buying words", "type": "boolean", "description": "Adds words like how, what, best, easy, for, with, without, ideas.", "default": false }, "customModifiers": { "title": "Your own extra words", "type": "array", "description": "Optional. Each word is added after the keyword, like \"keyword christmas\".", "items": { "type": "string" } }, "onlyWithSeedWords": { "title": "Keep only keywords that contain all my seed words", "type": "boolean", "description": "Pinterest sometimes suggests related phrases that drop one of your words. Turn this on to remove them.", "default": false }, "dedupeAcrossSeeds": { "title": "Never return the same keyword twice", "type": "boolean", "description": "If two seeds find the same keyword, you get it (and pay for it) only once.", "default": true }, "maxKeywordsPerSeed": { "title": "Max keywords per seed", "minimum": 0, "type": "integer", "description": "Stop after this many keywords for one seed. 0 = no limit. Use it to control cost.", "default": 0 }, "language": { "title": "Language hint", "enum": [ "en-US", "en-GB", "fr-FR", "de-DE", "es-ES", "it-IT", "pt-BR", "nl-NL", "ar" ], "type": "string", "description": "Language sent to Pinterest. The language of your seed keyword matters most.", "default": "en-US" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is recommended. If a run reports failed searches, switch to Residential.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }