{
"openapi": "3.0.1",
"info": {
"title": "SpyFu Scraper | SEO, PPC and Competitor Data",
"description": "SpyFu scraper for SEO and PPC competitor research: 20 domains in 20 seconds, 44 fields each. Get organic keywords, clicks and traffic value, Google Ads budget, paid keywords, domain strength, top competitors, best and new keywords and monthly history. Start from a domain, keyword or link. No login.",
"version": "1.0",
"x-build-id": "xeJ2GMGBG3qPpUHiu"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~spyfu-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-spyfu-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/silentflow~spyfu-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-spyfu-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/silentflow~spyfu-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-spyfu-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": {
"domains": {
"title": "🌐 Domains",
"type": "array",
"description": "Websites to analyze, one per line: nike.com, hubspot.com. A full address works too (https://www.nike.com/shoes reads nike.com). Each domain becomes one row with its organic keywords, organic clicks and their value, ad budget, paid keywords, competitors and history. A domain SpyFu does not track gives no row.",
"items": {
"type": "string"
}
},
"keywords": {
"title": "🔑 Keywords",
"type": "array",
"description": "Find who competes on a search term: running shoes, crm software. Each keyword brings up the domain ranked first on Google and every domain SpyFu saw bidding on it in Google Ads, the steadiest bidders first, and each one becomes a full domain row: crm software brings up salesforce.com, zoho.com, monday.com, hubspot.com and pipedrive.com first. Use Max domains to keep the list short.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "🔗 SpyFu or website links",
"type": "array",
"description": "Paste links copied from a browser:- a SpyFu domain page:
https://www.spyfu.com/overview/domain?query=nike.com (SEO, PPC and competitor pages work too) - a SpyFu keyword page:
https://www.spyfu.com/keyword/overview?query=running+shoes - any web page, for its domain:
https://www.hubspot.com/pricing
",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"country": {
"title": "🌍 SpyFu country",
"type": "string",
"description": "Google results of which country: keywords, clicks, ad budgets, competitors and keyword lists are those of that country. Pick one of SpyFu's 32 countries, or type its code (uk, gbr) or its English name. A domain SpyFu does not track in that country gives no row.",
"default": "us"
},
"maxItems": {
"title": "🔢 Max domains",
"minimum": 1,
"type": "integer",
"description": "Stop after this many domains, across domains, keywords and links. A domain takes about a second. Domains you type are read first, then the domains of your keywords.",
"default": 100
},
"historyMonths": {
"title": "📅 Months of history",
"minimum": 0,
"maximum": 300,
"type": "integer",
"description": "How many months of SpyFu history each row carries in monthlyHistory, latest month first: organic keywords, clicks and value, paid keywords, clicks and ad budget, average positions and domain strength. 12 is a year, 300 keeps everything SpyFu has (back to 2006 for the oldest domains), 0 leaves it out.",
"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
}
}
}
}
}
}
}
}
}
}