{ "openapi": "3.0.3", "info": { "title": "Wikipedia Article Lookup by URL or Keyword (server mode)", "version": "1.1", "description": "Send one lookup and get the results back in the response. It takes the same input as a normal run: query parameters with GET, or a JSON body with POST. At most 20 results and 240 seconds per request; start a normal run for bigger jobs. Requests run in your own Apify account at the Actor's normal price.", "x-oa-server-mode": "1.1" }, "paths": { "/": { "get": { "operationId": "lookupGet", "summary": "Run one lookup (query parameters)", "parameters": [ { "name": "articleUrls", "in": "query", "required": false, "description": "Wikipedia article URLs to look up. Works with desktop, mobile and index.php URLs, and with any language edition. Example: https://en.wikipedia.org/wiki/Albert_Einstein (GET: repeat the parameter once per value.)", "schema": { "type": "array", "items": { "type": "string" }, "maxItems": 10 }, "style": "form", "explode": true }, { "name": "articleTitles", "in": "query", "required": false, "description": "Exact article titles to look up in the selected language edition. Spaces or underscores are both accepted; redirects are followed. Example: Albert Einstein. (GET: repeat the parameter once per value.)", "schema": { "type": "array", "items": { "type": "string" }, "maxItems": 10 }, "style": "form", "explode": true, "example": [ "Ada Lovelace" ] }, { "name": "searchQueries", "in": "query", "required": false, "description": "Keywords to search with Wikipedia's full-text search. Returns the top-ranked matching articles per query. (GET: repeat the parameter once per value.)", "schema": { "type": "array", "items": { "type": "string" }, "maxItems": 3 }, "style": "form", "explode": true }, { "name": "maxArticlesPerQuery", "in": "query", "required": false, "description": "Maximum search results to fetch for each query (1-500).", "schema": { "type": "integer", "default": 5, "minimum": 1, "maximum": 10 } }, { "name": "categoryNames", "in": "query", "required": false, "description": "Wikipedia category names to browse, with or without the Category: prefix. Each member page becomes an article record. (GET: repeat the parameter once per value.)", "schema": { "type": "array", "items": { "type": "string" }, "maxItems": 2 }, "style": "form", "explode": true }, { "name": "maxArticlesPerCategory", "in": "query", "required": false, "description": "Maximum category members to fetch for each category (1-500).", "schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 20 } }, { "name": "language", "in": "query", "required": false, "description": "Wikipedia language edition for titles, searches and categories. URL lookups use the language in each URL instead.", "schema": { "type": "string", "enum": [ "aa", "ab", "ace", "ady", "af", "ak", "als", "alt", "am", "ami", "an", "ang", "ann", "anp", "ar", "arc", "ary", "arz", "as", "ast", "atj", "av", "avk", "awa", "ay", "az", "azb", "ba", "ban", "bar", "bat-smg", "bbc", "bcl", "bdr", "be", "be-tarask", "be-x-old", "bew", "bg", "bh", "bi", "bjn", "blk", "bm", "bn", "bo", "bol", "bpy", "br", "bs", "btm", "bug", "bxr", "ca", "cbk-zam", "cdo", "ce", "ceb", "ch", "cho", "chr", "chy", "ckb", "co", "cr", "crh", "cs", "csb", "cu", "cv", "cy", "da", "dag", "de", "dga", "din", "diq", "dsb", "dtp", "dty", "dv", "dz", "ee", "el", "eml", "en", "eo", "es", "et", "eu", "ext", "fa", "fat", "ff", "fi", "fiu-vro", "fj", "fo", "fon", "fr", "frp", "frr", "fur", "fy", "ga", "gag", "gan", "gcr", "gd", "gl", "glk", "gn", "gom", "gor", "got", "gpe", "gsw", "gu", "guc", "gur", "guw", "gv", "ha", "hak", "haw", "he", "hi", "hif", "ho", "hr", "hsb", "ht", "hu", "hy", "hyw", "hz", "ia", "iba", "id", "ie", "ig", "igl", "ii", "ik", "ilo", "inh", "io", "is", "isv", "it", "iu", "ja", "jam", "jbo", "jv", "ka", "kaa", "kab", "kai", "kaj", "kbd", "kbp", "kcg", "kg", "kge", "ki", "kj", "kk", "kl", "km", "kn", "knc", "ko", "koi", "kr", "krc", "ks", "ksh", "ku", "kus", "kv", "kw", "ky", "la", "lad", "lb", "lbe", "lez", "lfn", "lg", "li", "lij", "lld", "lmo", "ln", "lo", "lrc", "lt", "ltg", "lv", "lzh", "mad", "mag", "mai", "map-bms", "mdf", "mg", "mh", "mhr", "mi", "min", "mk", "ml", "mn", "mni", "mnw", "mo", "mos", "mr", "mrj", "ms", "mt", "mus", "mwl", "my", "myv", "mzn", "na", "nah", "nan", "nap", "nds", "nds-nl", "ne", "new", "ng", "nia", "nl", "nn", "no", "nov", "nqo", "nr", "nrm", "nso", "nup", "nv", "ny", "oc", "olo", "om", "or", "os", "pa", "pag", "pam", "pap", "pcd", "pcm", "pdc", "pfl", "pi", "pih", "pl", "pms", "pnb", "pnt", "ppl", "ps", "pt", "pwn", "qu", "rki", "rm", "rmy", "rn", "ro", "roa-rup", "roa-tara", "rsk", "ru", "rue", "rup", "rw", "sa", "sah", "sat", "sc", "scn", "sco", "sd", "se", "sg", "sgs", "sh", "shi", "shn", "shy", "si", "simple", "sk", "skr", "sl", "sm", "smn", "sn", "so", "sq", "sr", "srn", "ss", "st", "stq", "su", "sv", "sw", "syl", "szl", "szy", "ta", "tay", "tcy", "tdd", "te", "tet", "tg", "th", "ti", "tig", "tk", "tl", "tly", "tn", "to", "tok", "tpi", "tr", "trv", "ts", "tt", "tum", "tw", "ty", "tyv", "udm", "ug", "uk", "ur", "uz", "ve", "vec", "vep", "vi", "vls", "vo", "vro", "wa", "war", "wo", "wuu", "xal", "xh", "xmf", "yi", "yo", "yue", "za", "zea", "zgh", "zh", "zh-classical", "zh-min-nan", "zh-yue", "zu" ], "default": "en" } }, { "name": "maxItems", "in": "query", "required": false, "description": "Hard cap on total article records emitted across all modes.", "schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 20 } }, { "name": "includeFullContent", "in": "query", "required": false, "description": "Add the complete article body as plain text in fullText (not only the lead summary).", "schema": { "type": "boolean", "default": false } }, { "name": "includeSections", "in": "query", "required": false, "description": "Add the article's heading outline (title, level, anchor) in sections.", "schema": { "type": "boolean", "default": false } }, { "name": "includeExternalLinks", "in": "query", "required": false, "description": "Add the outbound external URLs cited or listed by the article in externalLinks.", "schema": { "type": "boolean", "default": false } }, { "name": "includeLinks", "in": "query", "required": false, "description": "Add the titles of other Wikipedia articles linked from the article in links.", "schema": { "type": "boolean", "default": false } }, { "name": "includeReferences", "in": "query", "required": false, "description": "Add the number of inline citations in referencesCount.", "schema": { "type": "boolean", "default": false } }, { "name": "includePageviews", "in": "query", "required": false, "description": "Add a pageview series and total in pageviews, from Wikimedia's pageview API.", "schema": { "type": "boolean", "default": false } }, { "name": "pageviewsGranularity", "in": "query", "required": false, "description": "Monthly or daily pageview points. Used when Include pageviews is on.", "schema": { "type": "string", "enum": [ "monthly", "daily" ], "default": "monthly" } }, { "name": "pageviewsPeriods", "in": "query", "required": false, "description": "Number of pageview periods to return: 1-12 months for monthly, or 1-365 days for daily.", "schema": { "type": "integer", "default": 12, "minimum": 1, "maximum": 365 } } ], "responses": { "200": { "description": "The results as a JSON array (at most 20). They are also saved to the run's dataset and billed per result, like a normal run.", "headers": { "X-Item-Count": { "schema": { "type": "integer" }, "description": "Results returned." }, "X-Status-Message": { "schema": { "type": "string" }, "description": "The Actor's last status message, e.g. why nothing was found." } }, "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Item" } }, "example": [ { "title": "Ada Lovelace", "url": "https://en.wikipedia.org/wiki/Ada_Lovelace", "canonicalUrl": "https://en.wikipedia.org/wiki/Ada_Lovelace", "displayTitle": "Ada Lovelace", "summary": "Augusta Ada King, Countess of Lovelace (née Byron; 10 December 1815 – 27 November 1852), also known as Ada Lovelace, was an English mathematician and writer ...", "description": "English mathematician (1815–1852)", "language": "en", "pageId": 974, "wikidataId": "Q7259", "lastModified": "2026-11-06T19:02:23Z", "categories": [ "1815 births", "1852 deaths", "19th-century British women mathematicians" ], "thumbnail": { "source": "https://upload.wikimedia.org/wikipedia/commons/4/4c/Ada_Lovelace_daguerreotype_by_Antoine_Claudet_1843_-_cropped.png", "width": 957, "height": 1239 }, "images": [ "https://upload.wikimedia.org/wikipedia/commons/9/9e/Square_root_of_x.svg", "https://upload.wikimedia.org/wikipedia/commons/a/aa/Newton%27s_reflecting_telescope.jpg", "https://upload.wikimedia.org/wikipedia/commons/e/e7/Miniature_of_Ada_Byron.jpg" ], "languageCount": 113, "availableLanguages": [ "af", "an", "ar" ], "revisionId": 1384127064, "lastEditor": "Vitorperrut555", "lastEditComment": "Copying from [[Category:British women computer scientists]] to [[Category:British computer scientists]] using [[c:Help:Cat-a-lot|Cat-a-lot]]", "revisionSize": 98391, "wordCount": 476, "requestedTitle": "Ada Lovelace", "requestedTitles": [ "Ada Lovelace" ], "scrapedAt": "2026-11-10T15:33:49.311825+00:00" } ] } } }, "400": { "description": "Invalid, missing or unknown input fields. Nothing ran.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "invalid_input", "errorDescription": "articleUrls: required" } } } }, "422": { "description": "The Actor could not complete this request (for example, nothing matches). No results were delivered.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Unexpected failure. Safe to retry.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "The request used up its 240 s budget. The results found so far are in partialItems.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "partialItems": { "type": "array", "items": { "$ref": "#/components/schemas/Item" } } } } ] } } } } } }, "post": { "operationId": "lookupPost", "summary": "Run one lookup (JSON body)", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "articleUrls": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "Wikipedia article URLs to look up. Works with desktop, mobile and index.php URLs, and with any language edition. Example: https://en.wikipedia.org/wiki/Albert_Einstein" }, "articleTitles": { "type": "array", "items": { "type": "string" }, "maxItems": 10, "description": "Exact article titles to look up in the selected language edition. Spaces or underscores are both accepted; redirects are followed. Example: Albert Einstein." }, "searchQueries": { "type": "array", "items": { "type": "string" }, "maxItems": 3, "description": "Keywords to search with Wikipedia's full-text search. Returns the top-ranked matching articles per query." }, "maxArticlesPerQuery": { "type": "integer", "default": 5, "minimum": 1, "maximum": 10, "description": "Maximum search results to fetch for each query (1-500)." }, "categoryNames": { "type": "array", "items": { "type": "string" }, "maxItems": 2, "description": "Wikipedia category names to browse, with or without the Category: prefix. Each member page becomes an article record." }, "maxArticlesPerCategory": { "type": "integer", "default": 20, "minimum": 1, "maximum": 20, "description": "Maximum category members to fetch for each category (1-500)." }, "language": { "type": "string", "enum": [ "aa", "ab", "ace", "ady", "af", "ak", "als", "alt", "am", "ami", "an", "ang", "ann", "anp", "ar", "arc", "ary", "arz", "as", "ast", "atj", "av", "avk", "awa", "ay", "az", "azb", "ba", "ban", "bar", "bat-smg", "bbc", "bcl", "bdr", "be", "be-tarask", "be-x-old", "bew", "bg", "bh", "bi", "bjn", "blk", "bm", "bn", "bo", "bol", "bpy", "br", "bs", "btm", "bug", "bxr", "ca", "cbk-zam", "cdo", "ce", "ceb", "ch", "cho", "chr", "chy", "ckb", "co", "cr", "crh", "cs", "csb", "cu", "cv", "cy", "da", "dag", "de", "dga", "din", "diq", "dsb", "dtp", "dty", "dv", "dz", "ee", "el", "eml", "en", "eo", "es", "et", "eu", "ext", "fa", "fat", "ff", "fi", "fiu-vro", "fj", "fo", "fon", "fr", "frp", "frr", "fur", "fy", "ga", "gag", "gan", "gcr", "gd", "gl", "glk", "gn", "gom", "gor", "got", "gpe", "gsw", "gu", "guc", "gur", "guw", "gv", "ha", "hak", "haw", "he", "hi", "hif", "ho", "hr", "hsb", "ht", "hu", "hy", "hyw", "hz", "ia", "iba", "id", "ie", "ig", "igl", "ii", "ik", "ilo", "inh", "io", "is", "isv", "it", "iu", "ja", "jam", "jbo", "jv", "ka", "kaa", "kab", "kai", "kaj", "kbd", "kbp", "kcg", "kg", "kge", "ki", "kj", "kk", "kl", "km", "kn", "knc", "ko", "koi", "kr", "krc", "ks", "ksh", "ku", "kus", "kv", "kw", "ky", "la", "lad", "lb", "lbe", "lez", "lfn", "lg", "li", "lij", "lld", "lmo", "ln", "lo", "lrc", "lt", "ltg", "lv", "lzh", "mad", "mag", "mai", "map-bms", "mdf", "mg", "mh", "mhr", "mi", "min", "mk", "ml", "mn", "mni", "mnw", "mo", "mos", "mr", "mrj", "ms", "mt", "mus", "mwl", "my", "myv", "mzn", "na", "nah", "nan", "nap", "nds", "nds-nl", "ne", "new", "ng", "nia", "nl", "nn", "no", "nov", "nqo", "nr", "nrm", "nso", "nup", "nv", "ny", "oc", "olo", "om", "or", "os", "pa", "pag", "pam", "pap", "pcd", "pcm", "pdc", "pfl", "pi", "pih", "pl", "pms", "pnb", "pnt", "ppl", "ps", "pt", "pwn", "qu", "rki", "rm", "rmy", "rn", "ro", "roa-rup", "roa-tara", "rsk", "ru", "rue", "rup", "rw", "sa", "sah", "sat", "sc", "scn", "sco", "sd", "se", "sg", "sgs", "sh", "shi", "shn", "shy", "si", "simple", "sk", "skr", "sl", "sm", "smn", "sn", "so", "sq", "sr", "srn", "ss", "st", "stq", "su", "sv", "sw", "syl", "szl", "szy", "ta", "tay", "tcy", "tdd", "te", "tet", "tg", "th", "ti", "tig", "tk", "tl", "tly", "tn", "to", "tok", "tpi", "tr", "trv", "ts", "tt", "tum", "tw", "ty", "tyv", "udm", "ug", "uk", "ur", "uz", "ve", "vec", "vep", "vi", "vls", "vo", "vro", "wa", "war", "wo", "wuu", "xal", "xh", "xmf", "yi", "yo", "yue", "za", "zea", "zgh", "zh", "zh-classical", "zh-min-nan", "zh-yue", "zu" ], "default": "en", "description": "Wikipedia language edition for titles, searches and categories. URL lookups use the language in each URL instead." }, "maxItems": { "type": "integer", "default": 20, "minimum": 1, "maximum": 20, "description": "Hard cap on total article records emitted across all modes." }, "includeFullContent": { "type": "boolean", "default": false, "description": "Add the complete article body as plain text in fullText (not only the lead summary)." }, "includeSections": { "type": "boolean", "default": false, "description": "Add the article's heading outline (title, level, anchor) in sections." }, "includeExternalLinks": { "type": "boolean", "default": false, "description": "Add the outbound external URLs cited or listed by the article in externalLinks." }, "includeLinks": { "type": "boolean", "default": false, "description": "Add the titles of other Wikipedia articles linked from the article in links." }, "includeReferences": { "type": "boolean", "default": false, "description": "Add the number of inline citations in referencesCount." }, "includePageviews": { "type": "boolean", "default": false, "description": "Add a pageview series and total in pageviews, from Wikimedia's pageview API." }, "pageviewsGranularity": { "type": "string", "enum": [ "monthly", "daily" ], "default": "monthly", "description": "Monthly or daily pageview points. Used when Include pageviews is on." }, "pageviewsPeriods": { "type": "integer", "default": 12, "minimum": 1, "maximum": 365, "description": "Number of pageview periods to return: 1-12 months for monthly, or 1-365 days for daily." } }, "additionalProperties": false }, "example": { "articleTitles": [ "Ada Lovelace" ] } } } }, "responses": { "200": { "description": "The results as a JSON array (at most 20). They are also saved to the run's dataset and billed per result, like a normal run.", "headers": { "X-Item-Count": { "schema": { "type": "integer" }, "description": "Results returned." }, "X-Status-Message": { "schema": { "type": "string" }, "description": "The Actor's last status message, e.g. why nothing was found." } }, "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Item" } }, "example": [ { "title": "Ada Lovelace", "url": "https://en.wikipedia.org/wiki/Ada_Lovelace", "canonicalUrl": "https://en.wikipedia.org/wiki/Ada_Lovelace", "displayTitle": "Ada Lovelace", "summary": "Augusta Ada King, Countess of Lovelace (née Byron; 10 December 1815 – 27 November 1852), also known as Ada Lovelace, was an English mathematician and writer ...", "description": "English mathematician (1815–1852)", "language": "en", "pageId": 974, "wikidataId": "Q7259", "lastModified": "2026-11-06T19:02:23Z", "categories": [ "1815 births", "1852 deaths", "19th-century British women mathematicians" ], "thumbnail": { "source": "https://upload.wikimedia.org/wikipedia/commons/4/4c/Ada_Lovelace_daguerreotype_by_Antoine_Claudet_1843_-_cropped.png", "width": 957, "height": 1239 }, "images": [ "https://upload.wikimedia.org/wikipedia/commons/9/9e/Square_root_of_x.svg", "https://upload.wikimedia.org/wikipedia/commons/a/aa/Newton%27s_reflecting_telescope.jpg", "https://upload.wikimedia.org/wikipedia/commons/e/e7/Miniature_of_Ada_Byron.jpg" ], "languageCount": 113, "availableLanguages": [ "af", "an", "ar" ], "revisionId": 1384127064, "lastEditor": "Vitorperrut555", "lastEditComment": "Copying from [[Category:British women computer scientists]] to [[Category:British computer scientists]] using [[c:Help:Cat-a-lot|Cat-a-lot]]", "revisionSize": 98391, "wordCount": 476, "requestedTitle": "Ada Lovelace", "requestedTitles": [ "Ada Lovelace" ], "scrapedAt": "2026-11-10T15:33:49.311825+00:00" } ] } } }, "400": { "description": "Invalid, missing or unknown input fields. Nothing ran.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "invalid_input", "errorDescription": "articleUrls: required" } } } }, "422": { "description": "The Actor could not complete this request (for example, nothing matches). No results were delivered.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Unexpected failure. Safe to retry.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "The request used up its 240 s budget. The results found so far are in partialItems.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Error" }, { "type": "object", "properties": { "partialItems": { "type": "array", "items": { "$ref": "#/components/schemas/Item" } } } } ] } } } } } } } }, "components": { "schemas": { "Item": { "type": "object", "description": "One result, the same record a normal run saves to its dataset.", "properties": { "title": { "type": "string" }, "url": { "type": "string" }, "canonicalUrl": { "type": "string" }, "displayTitle": { "type": "string" }, "summary": { "type": "string" }, "description": { "type": "string" }, "language": { "type": "string" }, "pageId": { "type": "integer" }, "wikidataId": { "type": "string" }, "lastModified": { "type": "string" }, "categories": { "type": "array", "items": { "type": "string" } }, "thumbnail": { "type": "object" }, "images": { "type": "array", "items": { "type": "string" } }, "languageCount": { "type": "integer" }, "availableLanguages": { "type": "array", "items": { "type": "string" } }, "revisionId": { "type": "integer" }, "lastEditor": { "type": "string" }, "lastEditComment": { "type": "string" }, "revisionSize": { "type": "integer" }, "wordCount": { "type": "integer" }, "requestedTitle": { "type": "string" }, "requestedTitles": { "type": "array", "items": { "type": "string" } }, "scrapedAt": { "type": "string" } }, "example": { "title": "Ada Lovelace", "url": "https://en.wikipedia.org/wiki/Ada_Lovelace", "canonicalUrl": "https://en.wikipedia.org/wiki/Ada_Lovelace", "displayTitle": "Ada Lovelace", "summary": "Augusta Ada King, Countess of Lovelace (née Byron; 10 December 1815 – 27 November 1852), also known as Ada Lovelace, was an English mathematician and writer ...", "description": "English mathematician (1815–1852)", "language": "en", "pageId": 974, "wikidataId": "Q7259", "lastModified": "2026-11-06T19:02:23Z", "categories": [ "1815 births", "1852 deaths", "19th-century British women mathematicians" ], "thumbnail": { "source": "https://upload.wikimedia.org/wikipedia/commons/4/4c/Ada_Lovelace_daguerreotype_by_Antoine_Claudet_1843_-_cropped.png", "width": 957, "height": 1239 }, "images": [ "https://upload.wikimedia.org/wikipedia/commons/9/9e/Square_root_of_x.svg", "https://upload.wikimedia.org/wikipedia/commons/a/aa/Newton%27s_reflecting_telescope.jpg", "https://upload.wikimedia.org/wikipedia/commons/e/e7/Miniature_of_Ada_Byron.jpg" ], "languageCount": 113, "availableLanguages": [ "af", "an", "ar" ], "revisionId": 1384127064, "lastEditor": "Vitorperrut555", "lastEditComment": "Copying from [[Category:British women computer scientists]] to [[Category:British computer scientists]] using [[c:Help:Cat-a-lot|Cat-a-lot]]", "revisionSize": 98391, "wordCount": 476, "requestedTitle": "Ada Lovelace", "requestedTitles": [ "Ada Lovelace" ], "scrapedAt": "2026-11-10T15:33:49.311825+00:00" } }, "Error": { "type": "object", "required": [ "error", "errorDescription" ], "properties": { "error": { "type": "string", "enum": [ "invalid_input", "request_failed", "internal_error", "timeout", "busy", "not_found", "method_not_allowed", "payload_too_large" ] }, "errorDescription": { "type": "string" } } } }, "securitySchemes": { "apifyToken": { "type": "http", "scheme": "bearer", "description": "Your Apify API token (Apify Console, Settings, API and integrations)." } } }, "servers": [ { "url": "https://vexaloom-labs--wikipedia-article-lookup-by-url-or-keyword.apify.actor" } ], "security": [ { "apifyToken": [] } ] }