{ "openapi": "3.0.1", "info": { "title": "Keyword Search Volume: Google + Amazon + Trademark Check", "description": "Bulk monthly search volume for Google and Amazon, with CPC, competition, 12-month trend, keyword difficulty and intent, plus a USPTO trademark-risk flag per keyword. Built for print-on-demand, Amazon Merch, KDP and Etsy sellers.", "version": "1.0", "x-build-id": "g3obWt4rmnGioxdGM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vncntlabs~keyword-search-volume/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vncntlabs-keyword-search-volume", "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/vncntlabs~keyword-search-volume/runs": { "post": { "operationId": "runs-sync-vncntlabs-keyword-search-volume", "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/vncntlabs~keyword-search-volume/run-sync": { "post": { "operationId": "run-sync-vncntlabs-keyword-search-volume", "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": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Keywords to look up, one per item (up to 50,000 per run). Case and extra spaces are ignored and duplicates are looked up once. Max 80 characters and 10 words each; characters Google rejects (, ! ? % * : ; \" etc.) and emoji are reported as skipped and never charged.", "items": { "type": "string" } }, "sources": { "title": "Data sources", "type": "array", "description": "Where to get search volume. Leave empty to use every source available for your market. Amazon volume is available for US, UK, CA, AU, DE, FR, IT, ES, NL, AT, IN, MX, SG, AE, SA and EG.", "items": { "type": "string", "enum": [ "google", "amazon" ], "enumTitles": [ "Google search volume (+ CPC, competition, trend)", "Amazon search volume" ] } }, "location": { "title": "Country", "type": "string", "description": "Country name, 2-letter code or DataForSEO location code, e.g. 'United States', 'GB', 'DE', 2840.", "default": "United States" }, "language": { "title": "Language", "type": "string", "description": "Language code or name (e.g. 'en', 'de'). Leave empty for English where available, otherwise the market's main language." }, "trademarkCheck": { "title": "Trademark-risk flag (USPTO)", "type": "boolean", "description": "Screen every keyword against live US federal trademarks in print-on-demand product classes, using the same engine as our POD & KDP Trademark Checker. Adds high/medium/low risk, matched marks, owners and TSDR links. Automated screening, not legal advice.", "default": true }, "trademarkClasses": { "title": "Trademark classes (Nice / IC)", "type": "array", "description": "USPTO classes to screen. Empty = POD default (025 clothing, 021 mugs, 016 paper/stickers/books, 009 phone cases, 014 jewelry, 018 bags, 020 decor, 024 textiles, 028 toys). The product word in the keyword (shirt, mug, sticker...) narrows the classes automatically.", "items": { "type": "string" } }, "maxTotalChargeUsd": { "title": "Maximum charge for this run (USD)", "minimum": 0, "type": "number", "description": "Optional hard cap. The run looks up only as many keywords as fit, and stops cleanly. Apify's own 'Max cost per run' setting is also respected." }, "trendMonths": { "title": "Months of history", "minimum": 0, "maximum": 48, "type": "integer", "description": "How many months of Google monthly search volume to include per keyword (newest first).", "default": 12 } } }, "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 } } } } } } } } } }