{ "openapi": "3.0.1", "info": { "title": "SEO Agent - AI Keyword Research & Competitor Reports", "description": "Research keywords and competitors with an AI agent: describe your SEO goal in plain words and get a report with search volume, CPC, keyword difficulty, intent and competitor domains, all from live keyword data. $0.25 per report plus the lookups it runs; failed reports are free.", "version": "1.0", "x-build-id": "RjQCIlHJp2hvKgdWL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tenfoldfleet~seo-agent/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tenfoldfleet-seo-agent", "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/tenfoldfleet~seo-agent/runs": { "post": { "operationId": "runs-sync-tenfoldfleet-seo-agent", "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/tenfoldfleet~seo-agent/run-sync": { "post": { "operationId": "run-sync-tenfoldfleet-seo-agent", "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": [ "goal" ], "properties": { "goal": { "title": "Research goal", "type": "string", "description": "What you want to find out, in plain words. Examples: \"Find 15 low-competition keywords for an online store selling vegan protein powder\", \"Which keywords do my competitors rank for that I don't?\", \"Does Google show AI Overviews for my main keywords, and who gets cited?\". Name the business and topic; add your site and competitors below." }, "website": { "title": "Your website (optional)", "type": "string", "description": "Your domain, e.g. mystore.com. The agent uses it for competitor, keyword-gap, backlink and AI Overview lookups." }, "competitors": { "title": "Competitor websites (optional)", "type": "array", "description": "Up to 10 competitor domains, one per line. Leave empty and the agent can find your organic competitors itself.", "items": { "type": "string" } }, "location": { "title": "Country", "type": "string", "description": "Country for search volume, CPC, difficulty and rankings. A country name or 2-letter code works (\"United States\", \"AU\", \"GB\"); 94 countries.", "default": "United States" }, "language": { "title": "Language", "type": "string", "description": "Search language, as a name or code (\"English\", \"en\", \"de\"). If the language has no data for the chosen country, the country's main language is used instead (for example Germany + English uses German). 21 countries support more than one language, for example United States English/Spanish, Canada English/French, Switzerland German/French/Italian, Belgium French/Dutch/German and India English/Hindi. English is also available in Cyprus, Egypt, Greece, Saudi Arabia and the UAE.", "default": "English" }, "model": { "title": "AI model", "enum": [ "fast", "deep" ], "type": "string", "description": "fast (Qwen3 30B) suits most goals and is quicker. deep gives the same lookups and budget to a different, larger model (Llama 4 Scout) for a second opinion; it is slower and costs the same. The free Apify plan always uses fast.", "default": "fast" }, "maxToolCalls": { "title": "Max lookups (free Apify plan: 3)", "minimum": 1, "maximum": 20, "type": "integer", "description": "Most data lookups (child actor runs) the agent may run for this report, 1-20. Each lookup bills its own rows.", "default": 8 }, "maxChildSpendUsd": { "title": "Max tool charges, USD (free Apify plan: $0.10)", "minimum": 0.01, "maximum": 5, "type": "number", "description": "Hard cap on what all lookups together may charge you through the data actors, on top of the report price. Each lookup gets only the budget that is left, so the total can never pass this amount.", "default": 0.5 } } }, "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 } } } } } } } } } }