Fetch and process content from specified URLs & sources using the Oxylabs Web Scraper API.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
HTTP Basic auth with your Oxylabs Web Scraper API username and password: 'Basic <base64(username:password)>'
Your Oxylabs AI Studio API key
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Run the browser agent and return the data in the specified format. This tool is useful if you need navigate around the website and do some actions. It allows navigating to any url, clicking on links, filling forms, scrolling, etc. Finally it returns the data in the specified format. Schema is required only if output_format is json, csv or toon. 'task_prompt' describes what browser agent should achieve
The URL to start the browser agent navigation from.
What browser agent should do.
The schema to use for the scrape. Only required if output_format is json, csv or toon.
Two letter ISO country code to use for the browser proxy.
The output format. Markdown returns full text of the page including links. Toon(Token-Oriented Object Notation) returns data in Toon format, which is optimized for AI agents. If json, csv or toon, the schema is required.
Run the browser agent and return the data in the specified format. This tool is useful if you need navigate around the website and do some actions. It allows navigating to any url, clicking on links, filling forms, scrolling, etc. Finally it returns the data in the specified format. Schema is required only if output_format is json, csv or toon. 'task_prompt' describes what browser agent should achieve
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL to start the browser agent navigation from. |
| schema | any | The schema to use for the scrape. Only required if output_format is json, csv or toon. |
| task_prompt* | string | What browser agent should do. |
| geo_location | any | Two letter ISO country code to use for the browser proxy. |
| output_format | string | The output format. Markdown returns full text of the page including links. Toon(Token-Oriented Object Notation) returns data in Toon format, which is optimized for AI agents. If json, csv or toon, the schema is required. |
{
"type": "object",
"required": [
"url",
"task_prompt"
],
"properties": {
"url": {
"type": "string",
"description": "The URL to start the browser agent navigation from."
},
"schema": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"default": null,
"description": "The schema to use for the scrape. Only required if output_format is json, csv or toon."
},
"task_prompt": {
"type": "string",
"description": "What browser agent should do."
},
"geo_location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Two letter ISO country code to use for the browser proxy."
},
"output_format": {
"enum": [
"json",
"markdown",
"html",
"csv",
"toon"
],
"type": "string",
"default": "markdown",
"description": "The output format. Markdown returns full text of the page including links. Toon(Token-Oriented Object Notation) returns data in Toon format, which is optimized for AI agents. If json, csv or toon, the schema is required."
}
},
"additionalProperties": false
}Tool useful for crawling a website from starting url and returning data in a specified format. Schema is required only if output_format is json, csv or toon. 'render_javascript' is used to render javascript heavy websites. 'return_sources_limit' is used to limit the number of sources to return, for example if you expect results from single source, you can set it to 1.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL from which crawling will be started. |
| schema | any | The JSON schema to use for structured data extraction from the crawled pages. Only required if output_format is json, csv or toon. |
| user_prompt* | string | What information user wants to extract from the domain. |
| geo_location | any | Two letter ISO country code to use for the crawl proxy. |
| output_format | string | The format of the output. If json, csv or toon, the schema is required. Markdown returns full text of the page. CSV returns data in CSV format. Toon(Token-Oriented Object Notation) returns data in Toon format, which is optimized for AI agents. |
| render_javascript | boolean | Whether to render the HTML of the page using javascript. Much slower, therefore use it only for websites that require javascript to render the page. Unless user asks to use it, first try to crawl the page without it. If results are unsatisfactory, try to use it. |
Tool useful for mapping website's URLs.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL from which URLs mapping will be started. |
| limit | integer | The maximum number of URLs to return. |
| user_prompt | any | What kind of URLs user wants to find. Can be used together with 'search_keywords'. |
| geo_location | any | Two letter ISO country code to use for the mapping proxy. |
| max_crawl_depth | integer | The maximum depth of the crawl. |
| search_keywords | any | The keywords to use for URLs paths filtering. Keywords are matched as OR condition. Meaning, one keyword is enough to match the url path. |
| allow_subdomains | boolean | Whether to map subdomains URLs as well. |
| render_javascript | boolean | Whether to render the HTML of the page using javascript. Much slower, therefore use it only for websites that require javascript to render the page. Unless user asks to use it, first try to crawl the page without it. If results are unsatisfactory, try to use it. |
Scrape the contents of the web page and return the data in the specified format. Schema is required only if output_format is json or csv. 'render_javascript' is used to render javascript heavy websites.
| Argument | Type | Description |
|---|---|---|
| url* | string | The URL to scrape |
| schema | any | The JSON schema to use for structured data extraction from the scraped page. Only required if output_format is json, csv or toon. |
| geo_location | any | Two letter ISO country code to use for the scrape proxy. |
| output_format | string | The format of the output. If json, csv or toon, the schema is required. Markdown returns full text of the page. CSV returns data in CSV format, tabular like data. Toon(Token-Oriented Object Notation) returns data in Toon format, which is optimized for AI agents. |
| render_javascript | boolean | Whether to render the HTML of the page using javascript. Much slower, therefore use it only for websites that require javascript to render the page.Unless user asks to use it, first try to scrape the page without it. If results are unsatisfactory, try to use it. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The URL to scrape"
},
"schema": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"default": null,
"description": "The JSON schema to use for structured data extraction from the scraped page. Only required if output_format is json, csv or toon."
},
"geo_location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Two letter ISO country code to use for the scrape proxy."
},
"output_format": {
"enum": [
"json",
"markdown",
"csv",
"toon"
],
"type": "string",
"default": "markdown",
"description": "The format of the output. If json, csv or toon, the schema is required. Markdown returns full text of the page. CSV returns data in CSV format, tabular like data. Toon(Token-Oriented Object Notation) returns data in Toon format, which is optimized for AI agents."
},
"render_javascript": {
"type": "boolean",
"default": false,
"description": "Whether to render the HTML of the page using javascript. Much slower, therefore use it only for websites that require javascript to render the page.Unless user asks to use it, first try to scrape the page without it. If results are unsatisfactory, try to use it."
}
},
"additionalProperties": false
}Search the web based on a provided query. 'return_content' is used to return markdown content for each search result. If 'return_content' is set to True, you don't need to use ai_scraper to get the content of the search results urls, because it is already included in the search results. if 'return_content' is set to True, prefer lower 'limit' to reduce payload size.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return. |
| query* | string | The query to search for. |
| geo_location | any | Two letter ISO country code to use for the search proxy. |
| return_content | boolean | Whether to return markdown content of the search results. |
| render_javascript | boolean | Whether to render the HTML of the page using javascript. Much slower, therefore use it only if user asks to use it.First try to search with setting it to False. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"description": "Maximum number of results to return."
},
"query": {
"type": "string",
"description": "The query to search for."
},
"geo_location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Two letter ISO country code to use for the search proxy."
},
"return_content": {
"type": "boolean",
"default": false,
"description": "Whether to return markdown content of the search results."
},
"render_javascript": {
"type": "boolean",
"default": false,
"description": "Whether to render the HTML of the page using javascript. Much slower, therefore use it only if user asks to use it.First try to search with setting it to False. "
}
},
"additionalProperties": false
}Scrape Amazon products. Supports content parsing, different user agent types, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as currency and getting more accurate pricing data with auto select variant.
| Argument | Type | Description |
|---|---|---|
| parse | boolean | Should result be parsed. If the result is not parsed, the output_format parameter is applied. |
| query* | string | Keyword to search for. |
| domain | any | Domain localization for Google. Use country top level domains. For example: - 'co.uk' for United Kingdom - 'us' for United States - 'fr' for France |
| locale | any | Set 'Accept-Language' header value which changes your Google search page web interface language. Examples: - 'en-US' for English, United States - 'de-AT' for German, Austria - 'fr-FR' for French, France |
| render | any | Whether a headless browser should be used to render the page. For example: - 'html' when browser is required to render the page. |
| currency | any | Currency that will be used to display the prices. |
Scrape Amazon search results. Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as category id, merchant id, currency.
| Argument | Type | Description |
|---|---|---|
| pages | integer | Number of pages to retrieve. |
| parse | boolean | Should result be parsed. If the result is not parsed, the output_format parameter is applied. |
| query* | string | Keyword to search for. |
| domain | any | Domain localization for Google. Use country top level domains. For example: - 'co.uk' for United Kingdom - 'us' for United States - 'fr' for France |
| locale | any | Set 'Accept-Language' header value which changes your Google search page web interface language. Examples: - 'en-US' for English, United States - 'de-AT' for German, Austria - 'fr-FR' for French, France |
| render | any | Whether a headless browser should be used to render the page. For example: - 'html' when browser is required to render the page. |
Generate a json schema in openapi format.
| Argument | Type | Description |
|---|---|---|
| app_name* | string | |
| user_prompt* | string |
{
"type": "object",
"required": [
"user_prompt",
"app_name"
],
"properties": {
"app_name": {
"enum": [
"ai_crawler",
"ai_scraper",
"browser_agent"
],
"type": "string"
},
"user_prompt": {
"type": "string"
}
},
"additionalProperties": false
}Scrape Google Search results. Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Number of results to retrieve in each page. |
| pages | integer | Number of pages to retrieve. |
| parse | boolean | Should result be parsed. If the result is not parsed, the output_format parameter is applied. |
| query* | string | URL-encoded keyword to search for. |
| domain | any | Domain localization for Google. Use country top level domains. For example: - 'co.uk' for United Kingdom - 'us' for United States - 'fr' for France |
| locale | any | Set 'Accept-Language' header value which changes your Google search page web interface language. Examples: - 'en-US' for English, United States - 'de-AT' for German, Austria - 'fr-FR' for French, France |
| render | any | Whether a headless browser should be used to render the page. For example: - 'html' when browser is required to render the page. |
Get a content of any webpage. Supports browser rendering, parsing of certain webpages and different output formats.
| Argument | Type | Description |
|---|---|---|
| url* | string | Website url to scrape. |
| render | any | Whether a headless browser should be used to render the page. For example: - 'html' when browser is required to render the page. |
| geo_location | any | The geographical location that the result should be adapted for. Use ISO-3166 country codes. Examples: - 'California, United States' - 'Mexico' - 'US' for United States - 'DE' for Germany - 'FR' for France |
| output_format | any | The format of the output. Works only when parse parameter is false. - links - Most efficient when the goal is navigation or finding specific URLs. Use this first when you need to locate a specific page within a website. - md - Best for extracting and reading visible content once you've found the right page. Use this to get structured content that's easy to read and process. - html - Should be used sparingly only when you need the raw HTML structure, JavaScript code, or styling information. |
| user_agent_type | any | Device type and browser that will be used to determine User-Agent header value. |
| return_sources_limit | integer | The maximum number of sources to return. |
{
"type": "object",
"required": [
"url",
"user_prompt"
],
"properties": {
"url": {
"type": "string",
"description": "The URL from which crawling will be started."
},
"schema": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"default": null,
"description": "The JSON schema to use for structured data extraction from the crawled pages. Only required if output_format is json, csv or toon."
},
"user_prompt": {
"type": "string",
"description": "What information user wants to extract from the domain."
},
"geo_location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Two letter ISO country code to use for the crawl proxy."
},
"output_format": {
"enum": [
"json",
"markdown",
"csv",
"toon"
],
"type": "string",
"default": "markdown",
"description": "The format of the output. If json, csv or toon, the schema is required. Markdown returns full text of the page. CSV returns data in CSV format. Toon(Token-Oriented Object Notation) returns data in Toon format, which is optimized for AI agents."
},
"render_javascript": {
"type": "boolean",
"default": false,
"description": "Whether to render the HTML of the page using javascript. Much slower, therefore use it only for websites that require javascript to render the page. Unless user asks to use it, first try to crawl the page without it. If results are unsatisfactory, try to use it."
},
"return_sources_limit": {
"type": "integer",
"default": 25,
"maximum": 50,
"description": "The maximum number of sources to return."
}
},
"additionalProperties": false
}| allow_external_domains | boolean | Whether to include external domains URLs. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The URL from which URLs mapping will be started."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 50,
"description": "The maximum number of URLs to return."
},
"user_prompt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What kind of URLs user wants to find. Can be used together with 'search_keywords'."
},
"geo_location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Two letter ISO country code to use for the mapping proxy."
},
"max_crawl_depth": {
"type": "integer",
"default": 1,
"maximum": 5,
"description": "The maximum depth of the crawl."
},
"search_keywords": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"default": null,
"description": "The keywords to use for URLs paths filtering. Keywords are matched as OR condition. Meaning, one keyword is enough to match the url path."
},
"allow_subdomains": {
"type": "boolean",
"default": false,
"description": "Whether to map subdomains URLs as well."
},
"render_javascript": {
"type": "boolean",
"default": false,
"description": "Whether to render the HTML of the page using javascript. Much slower, therefore use it only for websites that require javascript to render the page. Unless user asks to use it, first try to crawl the page without it. If results are unsatisfactory, try to use it."
},
"allow_external_domains": {
"type": "boolean",
"default": false,
"description": "Whether to include external domains URLs."
}
},
"additionalProperties": false
}| geo_location | any | The geographical location that the result should be adapted for. Use ISO-3166 country codes. Examples: - 'California, United States' - 'Mexico' - 'US' for United States - 'DE' for Germany - 'FR' for France |
| output_format | any | The format of the output. Works only when parse parameter is false. - links - Most efficient when the goal is navigation or finding specific URLs. Use this first when you need to locate a specific page within a website. - md - Best for extracting and reading visible content once you've found the right page. Use this to get structured content that's easy to read and process. - html - Should be used sparingly only when you need the raw HTML structure, JavaScript code, or styling information. |
| user_agent_type | any | Device type and browser that will be used to determine User-Agent header value. |
| autoselect_variant | boolean | To get accurate pricing/buybox data, set this parameter to true. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"parse": {
"type": "boolean",
"default": true,
"description": "Should result be parsed. If the result is not parsed, the output_format parameter is applied."
},
"query": {
"type": "string",
"description": "Keyword to search for."
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"uk",
"us",
"fr"
],
"description": "\n Domain localization for Google.\n Use country top level domains.\n For example:\n - 'co.uk' for United Kingdom\n - 'us' for United States\n - 'fr' for France\n "
},
"locale": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"en-US",
"de-AT",
"fr-FR"
],
"description": "\n Set 'Accept-Language' header value which changes your Google search page web interface language.\n Examples:\n - 'en-US' for English, United States\n - 'de-AT' for German, Austria\n - 'fr-FR' for French, France\n "
},
"render": {
"anyOf": [
{
"type": "string",
"const": "html"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"html"
],
"description": "\n Whether a headless browser should be used to render the page.\n For example:\n - 'html' when browser is required to render the page.\n "
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"USD",
"EUR",
"AUD"
],
"description": "Currency that will be used to display the prices."
},
"geo_location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"US",
"DE",
"FR"
],
"description": "\n The geographical location that the result should be adapted for.\n Use ISO-3166 country codes.\n Examples:\n - 'California, United States'\n - 'Mexico'\n - 'US' for United States\n - 'DE' for Germany\n - 'FR' for France\n "
},
"output_format": {
"anyOf": [
{
"enum": [
"links",
"md",
"html"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "\n The format of the output. Works only when parse parameter is false.\n - links - Most efficient when the goal is navigation or finding specific URLs. Use this first when you need to locate a specific page within a website.\n - md - Best for extracting and reading visible content once you've found the right page. Use this to get structured content that's easy to read and process.\n - html - Should be used sparingly only when you need the raw HTML structure, JavaScript code, or styling information.\n "
},
"user_agent_type": {
"anyOf": [
{
"enum": [
"desktop",
"desktop_chrome",
"desktop_firefox",
"desktop_safari",
"desktop_edge",
"desktop_opera",
"mobile",
"mobile_ios",
"mobile_android",
"tablet"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Device type and browser that will be used to determine User-Agent header value."
},
"autoselect_variant": {
"type": "boolean",
"default": false,
"description": "To get accurate pricing/buybox data, set this parameter to true."
}
},
"additionalProperties": false
}| currency |
| any |
| Currency that will be used to display the prices. |
| start_page | integer | Starting page number. |
| category_id | any | Search for items in a particular browse node (product category). |
| merchant_id | any | Search for items sold by a particular seller. |
| geo_location | any | The geographical location that the result should be adapted for. Use ISO-3166 country codes. Examples: - 'California, United States' - 'Mexico' - 'US' for United States - 'DE' for Germany - 'FR' for France |
| output_format | any | The format of the output. Works only when parse parameter is false. - links - Most efficient when the goal is navigation or finding specific URLs. Use this first when you need to locate a specific page within a website. - md - Best for extracting and reading visible content once you've found the right page. Use this to get structured content that's easy to read and process. - html - Should be used sparingly only when you need the raw HTML structure, JavaScript code, or styling information. |
| user_agent_type | any | Device type and browser that will be used to determine User-Agent header value. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"pages": {
"type": "integer",
"default": 0,
"description": "Number of pages to retrieve."
},
"parse": {
"type": "boolean",
"default": true,
"description": "Should result be parsed. If the result is not parsed, the output_format parameter is applied."
},
"query": {
"type": "string",
"description": "Keyword to search for."
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"uk",
"us",
"fr"
],
"description": "\n Domain localization for Google.\n Use country top level domains.\n For example:\n - 'co.uk' for United Kingdom\n - 'us' for United States\n - 'fr' for France\n "
},
"locale": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"en-US",
"de-AT",
"fr-FR"
],
"description": "\n Set 'Accept-Language' header value which changes your Google search page web interface language.\n Examples:\n - 'en-US' for English, United States\n - 'de-AT' for German, Austria\n - 'fr-FR' for French, France\n "
},
"render": {
"anyOf": [
{
"type": "string",
"const": "html"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"html"
],
"description": "\n Whether a headless browser should be used to render the page.\n For example:\n - 'html' when browser is required to render the page.\n "
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"USD",
"EUR",
"AUD"
],
"description": "Currency that will be used to display the prices."
},
"start_page": {
"type": "integer",
"default": 0,
"description": "Starting page number."
},
"category_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Search for items in a particular browse node (product category)."
},
"merchant_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Search for items sold by a particular seller."
},
"geo_location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"US",
"DE",
"FR"
],
"description": "\n The geographical location that the result should be adapted for.\n Use ISO-3166 country codes.\n Examples:\n - 'California, United States'\n - 'Mexico'\n - 'US' for United States\n - 'DE' for Germany\n - 'FR' for France\n "
},
"output_format": {
"anyOf": [
{
"enum": [
"links",
"md",
"html"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "\n The format of the output. Works only when parse parameter is false.\n - links - Most efficient when the goal is navigation or finding specific URLs. Use this first when you need to locate a specific page within a website.\n - md - Best for extracting and reading visible content once you've found the right page. Use this to get structured content that's easy to read and process.\n - html - Should be used sparingly only when you need the raw HTML structure, JavaScript code, or styling information.\n "
},
"user_agent_type": {
"anyOf": [
{
"enum": [
"desktop",
"desktop_chrome",
"desktop_firefox",
"desktop_safari",
"desktop_edge",
"desktop_opera",
"mobile",
"mobile_ios",
"mobile_android",
"tablet"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Device type and browser that will be used to determine User-Agent header value."
}
},
"additionalProperties": false
}| ad_mode | boolean | If true will use the Google Ads source optimized for the paid ads. |
| start_page | integer | Starting page number. |
| geo_location | any | The geographical location that the result should be adapted for. Use ISO-3166 country codes. Examples: - 'California, United States' - 'Mexico' - 'US' for United States - 'DE' for Germany - 'FR' for France |
| output_format | any | The format of the output. Works only when parse parameter is false. - links - Most efficient when the goal is navigation or finding specific URLs. Use this first when you need to locate a specific page within a website. - md - Best for extracting and reading visible content once you've found the right page. Use this to get structured content that's easy to read and process. - html - Should be used sparingly only when you need the raw HTML structure, JavaScript code, or styling information. |
| user_agent_type | any | Device type and browser that will be used to determine User-Agent header value. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 0,
"description": "Number of results to retrieve in each page."
},
"pages": {
"type": "integer",
"default": 0,
"description": "Number of pages to retrieve."
},
"parse": {
"type": "boolean",
"default": true,
"description": "Should result be parsed. If the result is not parsed, the output_format parameter is applied."
},
"query": {
"type": "string",
"description": "URL-encoded keyword to search for."
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"uk",
"us",
"fr"
],
"description": "\n Domain localization for Google.\n Use country top level domains.\n For example:\n - 'co.uk' for United Kingdom\n - 'us' for United States\n - 'fr' for France\n "
},
"locale": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"en-US",
"de-AT",
"fr-FR"
],
"description": "\n Set 'Accept-Language' header value which changes your Google search page web interface language.\n Examples:\n - 'en-US' for English, United States\n - 'de-AT' for German, Austria\n - 'fr-FR' for French, France\n "
},
"render": {
"anyOf": [
{
"type": "string",
"const": "html"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"html"
],
"description": "\n Whether a headless browser should be used to render the page.\n For example:\n - 'html' when browser is required to render the page.\n "
},
"ad_mode": {
"type": "boolean",
"default": false,
"description": "If true will use the Google Ads source optimized for the paid ads."
},
"start_page": {
"type": "integer",
"default": 0,
"description": "Starting page number."
},
"geo_location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"US",
"DE",
"FR"
],
"description": "\n The geographical location that the result should be adapted for.\n Use ISO-3166 country codes.\n Examples:\n - 'California, United States'\n - 'Mexico'\n - 'US' for United States\n - 'DE' for Germany\n - 'FR' for France\n "
},
"output_format": {
"anyOf": [
{
"enum": [
"links",
"md",
"html"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "\n The format of the output. Works only when parse parameter is false.\n - links - Most efficient when the goal is navigation or finding specific URLs. Use this first when you need to locate a specific page within a website.\n - md - Best for extracting and reading visible content once you've found the right page. Use this to get structured content that's easy to read and process.\n - html - Should be used sparingly only when you need the raw HTML structure, JavaScript code, or styling information.\n "
},
"user_agent_type": {
"anyOf": [
{
"enum": [
"desktop",
"desktop_chrome",
"desktop_firefox",
"desktop_safari",
"desktop_edge",
"desktop_opera",
"mobile",
"mobile_ios",
"mobile_android",
"tablet"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Device type and browser that will be used to determine User-Agent header value."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Website url to scrape."
},
"render": {
"anyOf": [
{
"type": "string",
"const": "html"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"html"
],
"description": "\n Whether a headless browser should be used to render the page.\n For example:\n - 'html' when browser is required to render the page.\n "
},
"geo_location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"examples": [
"US",
"DE",
"FR"
],
"description": "\n The geographical location that the result should be adapted for.\n Use ISO-3166 country codes.\n Examples:\n - 'California, United States'\n - 'Mexico'\n - 'US' for United States\n - 'DE' for Germany\n - 'FR' for France\n "
},
"output_format": {
"anyOf": [
{
"enum": [
"links",
"md",
"html"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "\n The format of the output. Works only when parse parameter is false.\n - links - Most efficient when the goal is navigation or finding specific URLs. Use this first when you need to locate a specific page within a website.\n - md - Best for extracting and reading visible content once you've found the right page. Use this to get structured content that's easy to read and process.\n - html - Should be used sparingly only when you need the raw HTML structure, JavaScript code, or styling information.\n "
},
"user_agent_type": {
"anyOf": [
{
"enum": [
"desktop",
"desktop_chrome",
"desktop_firefox",
"desktop_safari",
"desktop_edge",
"desktop_opera",
"mobile",
"mobile_ios",
"mobile_android",
"tablet"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Device type and browser that will be used to determine User-Agent header value."
}
},
"additionalProperties": false
}