{
"openapi": "3.0.1",
"info": {
"title": "Wikidata Scraper - Knowledge Graph Entity Data",
"description": "Search Wikidata or resolve Q-ids to clean structured entity data: label, description, aliases, instance-of, country, industry, founders, CEO, headquarters, website, coordinates, ISIN and the Wikipedia link. Entity resolution for AI agents and data enrichment. No API key, no browser.",
"version": "0.1",
"x-build-id": "fvV7tkeD0hyYVU9qQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~wikidata-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-wikidata-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/scrapesage~wikidata-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-wikidata-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/scrapesage~wikidata-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-wikidata-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": {
"searchQueries": {
"title": "Search terms",
"type": "array",
"description": "Names or terms to search Wikidata for, one per line - e.g. Apify, Tesla, Marie Curie. Each resolves to the matching entities. Leave empty and the run returns a small free sample.",
"items": {
"type": "string"
}
},
"entityIds": {
"title": "Wikidata Q-ids (exact lookup)",
"type": "array",
"description": "Specific Wikidata item ids to fetch exactly, one per line - e.g. Q42, Q95. A full entity URL also works.",
"items": {
"type": "string"
}
},
"language": {
"title": "Language",
"type": "string",
"description": "Language code for labels/descriptions - e.g. en, de, fr. Falls back to English when a label is missing."
},
"searchQueriesFromFile": {
"title": "Import terms or Q-ids from a file",
"type": "string",
"description": "Bulk-load search terms or Q-ids (auto-detected). Either paste the whole list (one per line), or give a single link to a public .txt/.csv, a Google Sheet/Drive link, or an Apify key-value-store record. A file that cannot be read says so and charges nothing."
},
"maxItemsPerQuery": {
"title": "Max entities per search term",
"minimum": 1,
"type": "integer",
"description": "How many matching entities to resolve for each search term.",
"default": 25
},
"maxItems": {
"title": "Max entities (total)",
"minimum": 1,
"type": "integer",
"description": "Overall cap across all searches and Q-ids. You are only charged for entities actually saved.",
"default": 1000
},
"outputFields": {
"title": "Output fields (leave empty for all)",
"type": "array",
"description": "Pick the fields you want and every record is trimmed to exactly those - handy for lean CSV/Sheets exports.",
"items": {
"type": "string",
"enum": [
"type",
"id",
"label",
"description",
"aliases",
"aliasCount",
"dataType",
"instanceOf",
"subclassOf",
"country",
"inception",
"officialWebsite",
"headquartersLocation",
"industry",
"employees",
"founders",
"ceo",
"coordinates",
"image",
"logo",
"officialName",
"ownedBy",
"parentOrg",
"stockExchange",
"isin",
"revenue",
"legalForm",
"partOf",
"claimPropertyCount",
"wikipediaUrl",
"wikidataUrl",
"scrapedAt"
],
"enumTitles": [
"Record type (type)",
"Q-id (id)",
"Label (label)",
"Description (description)",
"Aliases (aliases)",
"Alias count (aliasCount)",
"Data type (dataType)",
"Instance of (instanceOf)",
"Subclass of (subclassOf)",
"Country (country)",
"Inception (inception)",
"Official website (officialWebsite)",
"Headquarters (headquartersLocation)",
"Industry (industry)",
"Employees (employees)",
"Founders (founders)",
"CEO (ceo)",
"Coordinates (coordinates)",
"Image (image)",
"Logo (logo)",
"Official name (officialName)",
"Owned by (ownedBy)",
"Parent org (parentOrg)",
"Stock exchange (stockExchange)",
"ISIN (isin)",
"Revenue (revenue)",
"Legal form (legalForm)",
"Part of (partOf)",
"Claim property count (claimPropertyCount)",
"Wikipedia URL (wikipediaUrl)",
"Wikidata URL (wikidataUrl)",
"Scraped at (scrapedAt)"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}