{ "openapi": "3.0.1", "info": { "title": "Wikipedia Brand Mention Finder", "description": "Find every Wikipedia article that mentions your brand, product or name, in any language, and see which ones link to your website and which don't. Each mention comes with the text snippet and 30-day pageviews.", "version": "1.0", "x-build-id": "19rUxrH2FfqgIZu4d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sculptural_delphinium~wikipedia-brand-mentions/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sculptural_delphinium-wikipedia-brand-mentions", "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/sculptural_delphinium~wikipedia-brand-mentions/runs": { "post": { "operationId": "runs-sync-sculptural_delphinium-wikipedia-brand-mentions", "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/sculptural_delphinium~wikipedia-brand-mentions/run-sync": { "post": { "operationId": "run-sync-sculptural_delphinium-wikipedia-brand-mentions", "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": [ "brands" ], "properties": { "brands": { "title": "Brands or names", "type": "array", "description": "Brand, product, company or project names to look for, for example \"Cloudflare\" or \"Raspberry Pi\". Each is searched as an exact phrase. Distinctive names give the cleanest results.", "items": { "type": "string" } }, "domain": { "title": "Your website domain", "type": "string", "description": "Optional. Your domain, for example \"cloudflare.com\". Each article is marked \"linked\" if it has at least one external link to this domain or a subdomain of it, otherwise \"unlinked\". Leave empty to only list mentions." }, "wikis": { "title": "Wikipedia languages", "type": "array", "description": "Language codes (en, de, fr, es, ja...) or Wikimedia hosts such as en.wikivoyage.org. Every brand is searched on every wiki. Default: en.", "items": { "type": "string" } }, "maxArticlesPerBrand": { "title": "Max articles per brand and wiki", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many of the top matching articles to return for each brand on each wiki. Wikipedia's search returns at most 10,000.", "default": 100 }, "onlyUnlinked": { "title": "Only return articles that don't link to you", "type": "boolean", "description": "Return (and charge for) unlinked mentions only. Needs a domain.", "default": false }, "exactPhrase": { "title": "Exact phrase", "type": "boolean", "description": "Wrap each name in quotes so only the exact phrase matches. Turn off to pass names to Wikipedia's search as written, for example to use operators like -word or intitle:. Names that already contain quotes or operators are always passed as written.", "default": true }, "includePageviews": { "title": "Include 30-day pageviews", "type": "boolean", "description": "Add the number of views each article had in the last 30 days, from Wikimedia's pageview statistics.", "default": 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 }, "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 } } } } } } } } } }