Web Scraper API documentation

Get to know how Web Scraper API works and integrate it into your app.

API Key

To find your Scraper API key, go to My Scraper API in the left sidebar and click your active Scraper API subscription.

Your API key will be displayed on the subscription details page.

Live API Key: {YOUR_SECRET_API_KEY}

Authentication

All requests must include an X-API-Key header with a valid API key. For example:

X-API-Key: YOUR_SECRET_API_KEY

Scraper and API endpoint

POST https://scrape.infatica.io/

Purpose: Fetches a webpage at a given URL, optionally using a specified country proxy and/or language headers.
Auth: Requires X-API-Key in the request header (Light or Advanced plan; not available on the SearchAI plan).
Requests: Each call consumes 1 request.

Features:

Ability to specify ISO 3166-1 country code (e.g. "US", "GB", "DE") to use a localized proxy.
Optionally set language (e.g., "en-US", "de-DE") to shape the Accept-Language header.
Return raw HTML (return_html = true) or a JSON structure (return_html = false, default).
Return the upstream file as a direct binary download (return_file = true) for assets such as images.
Support for custom HTTP methods (GET, POST).
Support for custom headers and request body.
Session management for maintaining state across requests.
Browser selection (chrome, firefox) and proxy type selection (datacenter, residential).

Request body (JSON):

Field	Type	Required?	Description
`url`	string	yes	The URL to fetch (e.g. `"https://www.example.com"`)
`country`	string	no	ISO 3166-1 alpha-2 code (e.g. `"US"`, `"GB"`, `"DE"`). Uses localized proxy
`language`	string	no	Language code in `"xx-YY"` format (e.g., `"en-US"`, `"de-DE"`)
`return_html`	boolean	no	`true` returns raw HTML; `false` returns JSON with HTML sample (default)
`return_file`	boolean	no	`true` returns the upstream response body as a binary file download
`method`	string	no	HTTP method: `"GET"` or `"POST"` (default: `"GET"`)
`body`	string	no	Request body for POST requests
`device`	string	no	Device type: `"desktop"`, `"mobile"`, `"macos"` (default: `"desktop"`)
`headers`	object	no	Custom HTTP headers as key-value pairs
`referer`	string	no	Referer URL
`session_id`	string	no	UUID for session persistence
`browser`	string	no	Browser type: `"chrome"` or `"firefox"` (default: `"firefox"`)
`proxy_type`	string	no	Proxy type: `"datacenter"` or `"residential"` (default: `"datacenter"`)

Example cURL Request:

curl -X POST "https://scrape.infatica.io/" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SECRET_API_KEY" \
  -d '{
    "url": "https://www.example.com",
    "country": "US"
  }'

Compatibility GET Request

The root endpoint also accepts a ScraperAPI-style GET request with api_key and url query parameters and returns the upstream response body directly.

curl "https://scrape.infatica.io/?api_key=YOUR_SECRET_API_KEY&url=https://cf.bstatic.com/xdata/images/hotel/max1024x768/692878307.jpg?k=38338b7873225e5d80a251d8bfdd5134217f9c3f0bd70d1ea47608d644e524ff&o=" \
  -o hotel.jpg

This compatibility mode reconstructs unencoded nested query parameters after url= for cases like ...jpg?k=...&o=.

Success Response

HTTP Status: 200 OK

If return_html = false (default):

{
  "status_code": 200,
  "requests_used": 1,
  "elapsed_time": 123,
  "html": "Base64 encoded HTML"
}

If return_html = true, the response is raw HTML:

<!DOCTYPE html>
<html>
<head>...</head>
<body>Full HTML of the requested page</body>
</html>

If return_file = true, the response body is streamed back as the fetched file with the upstream Content-Type, so browsers can render images and other supported files inline.

Example: Download an image

curl -X POST "https://scrape.infatica.io/" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SECRET_API_KEY" \
  -o image.png \
  -d '{
    "url": "https://www.example.com/image.png",
    "return_file": true
  }'

Google SERP endpoint

Google SERP scraping endpoint with auto-retry, sequential page fetching, and Google AI Overview support.

Endpoint: POST https://scrape.infatica.io/serp
Auth: X-API-Key header

Parameters

Parameter	Type	Default	Description
`url`	string	required	Google search URL
`results`	int	10	Total results to fetch (max 100)
`pages`	string	null	Specific pages as CSV (e.g., "1,3,5", max 10 pages)
`mode`	string	"scrape"	"scrape" or "render" (forces browser + Google AI)
`country`	string	null	ISO 3166-1 country code
`language`	string	null	Language code
`return_html`	bool	false	Return raw concatenated HTML of all pages. Mutually exclusive with `return_json`
`return_json`	bool	false	Return parsed SERP results as structured JSON. Mutually exclusive with `return_html`
`timeout`	int	2000	Request timeout in milliseconds
`screenshot`	bool	false	Capture screenshot
`device`	string	"desktop"	Device type: "desktop", "mobile", "macos"
`headers`	object	{}	Custom HTTP headers

Note: pages takes precedence over results if both specified.

Response

{
  "status_code": 200,
  "requests_used": 45,
  "elapsed_time": 3500,
  "html": "base64_encoded_html",
  "pages": {
    "page_url": "base64_encoded_html"
  }
}

Behavior

First request: scrape mode (fast) → auto-switches to render if blocked
Render mode: forces browser execution + enables scrape_google_ai=true for AI Overview
Retry logic: up to 3 attempts on bans
Additional pages: fetched sequentially (scrape mode, 1 request each)
HTML: all pages concatenated

Examples

Basic (10 results)

curl -X POST "https://scrape.infatica.io/serp" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.google.com/search?q=python+scraping"}'

Multiple pages (50 results)

curl -X POST "https://scrape.infatica.io/serp" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.google.com/search?q=machine+learning",
    "results": 50
  }'

Specific pages only

curl -X POST "https://scrape.infatica.io/serp" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.google.com/search?q=ai",
    "pages": "1,3,5"
  }'

Force render + Google AI Overview

curl -X POST "https://scrape.infatica.io/serp" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.google.com/search?q=climate+change",
    "mode": "render",
    "results": 20
  }'

Geo-targeted search

curl -X POST "https://scrape.infatica.io/serp" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.google.com/search?q=restaurants",
    "country": "DE",
    "results": 30
  }'

Decode Base64 HTML

Python:

import base64, json
html = base64.b64decode(response["html"]).decode("utf-8")

Node.js:

const html = Buffer.from(response.html, 'base64').toString('utf-8');

Bash:

echo "$RESPONSE_HTML" | base64 -d

Pricing

scrape: 1 request per page
Additional pages: 1 request each (scrape mode)

Examples:

10 results (1 page), scrape: ~1 request
50 results (5 pages), scrape: ~5 requests

Error Codes

Code	Reason	Solution
400	Invalid payload	Check JSON format
429	Rate limit exceeded	Reduce request frequency
500	All retries failed	Try render mode or adjust params

Limits

Max results: 100
Max pages: 10

Tips

Use pages for selective scraping
Use render mode when you need Google AI Overview

AI Search Endpoints

Query AI-powered search engines (ChatGPT, Gemini and Perplexity) and receive the answer as raw HTML or as parsed JSON.

Endpoints:

POST https://scrape.infatica.io/chatgpt
POST https://scrape.infatica.io/gemini
POST https://scrape.infatica.io/perplexity

Auth: X-API-Key header (Advanced or SearchAI plan required). The SearchAI plan covers these three endpoints only.

Parameters

Parameter	Type	Required	Description
`query`	string	yes	The search query to send to the AI service
`country`	string	no	ISO 3166-1 alpha-2 code (e.g. `"US"`, `"GB"`, `"DE"`). Uses localized proxy (default: `"US"`)
`language`	string	no	Language code in `"xx-YY"` format (e.g., `"en-US"`, `"de-DE"`) (default: `"en-US"`)
`return_html`	boolean	no	`true` returns raw HTML; `false` returns JSON (default). Ignored when `json_response` is `true`
`json_response`	boolean	no	`true` returns the answer as clean parsed JSON in `results` (provider, answer text, sources, model); `false` (default) returns the JSON envelope with the answer as raw HTML
`raw_sse`	boolean	no	`true` additionally includes the raw SSE stream from the AI service as `raw_sse` inside `results`. Only applies when `json_response` is `true`

Example: ChatGPT

curl -X POST "https://scrape.infatica.io/chatgpt" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"query": "scraping tools"}'

Example: Gemini

curl -X POST "https://scrape.infatica.io/gemini" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"query": "audi vs bmw"}'

Example: Perplexity

curl -X POST "https://scrape.infatica.io/perplexity" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"query": "best programming languages 2026"}'

Example: Raw HTML Response

curl -X POST "https://scrape.infatica.io/gemini" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"query": "climate change effects", "return_html": true}'

Example: Parsed JSON Response

curl -X POST "https://scrape.infatica.io/perplexity" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"query": "best electric cars 2026", "json_response": true}'

Success Response

HTTP Status: 200 OK

If return_html = false (default):

{
  "api_key": "YOUR_API_KEY",
  "query": "audi vs bmw",
  "created_at": "2025-01-21T12:00:00.123456",
  "processed_at": "2025-01-21T12:00:02.456789",
  "time_spent_ms": 2333,
  "requests_used": 1,
  "html": "<html>...response content...</html>"
}

If return_html = true, the response is raw HTML from the AI service.

If json_response = true, the answer is returned as parsed JSON:

{
  "status_code": 200,
  "request_id": "1f0c7e2a-9b1d-4e57-8a30-6c2f9d4b5e01",
  "elapsed_time": 8342,
  "query": {
    "prompt": "best electric cars 2026",
    "country": "US",
    "language": "en-US"
  },
  "results": {
    "provider": "perplexity",
    "response_text": "The most popular electric cars in 2026 are ...",
    "sources": [
      {
        "title": "Best Electric Cars of 2026",
        "url": "https://example.com/best-evs-2026",
        "text": "Our test of 40 EVs shows ...",
        "description": "Review roundup of 2026 electric cars"
      }
    ],
    "model": "<model name>",
    "raw_sse": "event: message\ndata: ... (only when raw_sse = true)"
  }
}

On an error status, results carries the error detail instead.

Error Codes

Code	Reason	Solution
403	Advanced or SearchAI plan required	Upgrade your plan
500	No html_content in response	AI service issue, retry later

Notes

You are charged only for successful responses
Response times may vary based on query complexity

Render JS endpoint

POST https://scrape.infatica.io/render

Purpose: Fetches a webpage at a given URL and renders it via browser, optionally using a specified country proxy and/or language headers.
Auth: Requires X-API-Key in the request header.
Requests: Each call consumes 1 request.

Features:

Ability to specify ISO 3166-1 country code (e.g. "US", "GB", "DE") to use a localized proxy.
Optionally set language (e.g., "en-US", "de-DE") to shape the Accept-Language header.
Return raw HTML (return_html = true) or a JSON structure (return_html = false, default).

Request body (JSON):

Field	Type	Required?	Description
`url`	string	yes	The URL to fetch (e.g. `"https://www.example.com"`)
`country`	string	no	ISO 3166-1 alpha-2 code (e.g. `"US"`, `"GB"`, `"DE"`). Uses localized proxy
`language`	string	no	Language code in `"xx-YY"` format (e.g., `"en-US"`, `"de-DE"`)
`return_html`	boolean	no	`true` returns raw HTML; `false` returns JSON with HTML sample (default)

Example cURL Request:

curl -X POST "https://scrape.infatica.io/render" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SECRET_API_KEY" \
  -d '{
    "url": "https://www.example.com",
    "country": "US",
  }'

Success Response

HTTP Status: 200 OK

If return_html = false (default):

{
  "status_code": 200,
  "requests_used": 45,
  "elapsed_time": 3500,
  "html": "base64_encoded_html"
}

If return_html = true, the response is raw HTML:

<!DOCTYPE html>
<html>
<head>...</head>
<body>Full HTML of the requested page</body>
</html>

Indeed endpoint

POST https://scrape.infatica.io/indeed

Purpose: Fetches Indeed job data: either a job-search results page (listing) or a single job by its Indeed job key (description).
Auth: Requires X-API-Key in the request header (Advanced plan).
Requests: Each call consumes 1 request. You are charged only for successful responses.

Features:

type = "listing": renders an indeed.com/jobs search URL in a browser and returns the parsed job cards, or the raw page HTML with return_html = true. Any Indeed country site works (www.indeed.com, ca.indeed.com, fr.indeed.com, ...).
type = "description": fetches one job by job_id and returns its details as JSON (job and company groups).

Request body (JSON):

Field	Type	Required?	Description
`type`	string	yes	`"listing"` or `"description"`
`url`	string	for `listing`	Indeed job-search URL, e.g. `"https://www.indeed.com/jobs?q=python&l=Remote"`. Host must be `indeed.com` or one of its country subdomains and the path must be `/jobs`.
`job_id`	string	for `description`	Indeed job key: the `jk` value of a job URL, e.g. `"3856fa2f4d9425b9"`
`return_html`	boolean	no (`listing` only)	`true` returns the rendered page as raw HTML; `false` returns parsed jobs as JSON (default)

Example: Job listing (parsed JSON)

curl -X POST "https://scrape.infatica.io/indeed" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SECRET_API_KEY" \
  -d '{
    "type": "listing",
    "url": "https://www.indeed.com/jobs?q=python+developer&l=Remote"
  }'

Example: Job listing (raw HTML)

curl -X POST "https://scrape.infatica.io/indeed" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SECRET_API_KEY" \
  -d '{
    "type": "listing",
    "url": "https://ca.indeed.com/jobs?q=warehouse&l=Ontario",
    "return_html": true
  }'

Example: Job description

curl -X POST "https://scrape.infatica.io/indeed" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SECRET_API_KEY" \
  -d '{
    "type": "description",
    "job_id": "3856fa2f4d9425b9"
  }'

Success Response

HTTP Status: 200 OK

All JSON responses share one envelope. results holds the parsed data, request echoes the payload as received, and error is always null on a 200.

type = "listing" (default, return_html = false). results is a list in page order; it is empty when the search matched no jobs (still a valid, charged response):

{
  "status_code": 200,
  "request_id": "11dcf259-0b20-4031-a34d-1a4483a4b07d",
  "elapsed_time": 15080,
  "requests_used": 1,
  "request": {
    "type": "listing",
    "url": "https://www.indeed.com/jobs?q=python+developer&l=Remote",
    "return_html": false
  },
  "results": [
    {
      "job_id": "3856fa2f4d9425b9",
      "job_title": "Warehouse Outbound Scheduler - Weekend Shift",
      "company_name": "Amer Sports Canada Inc.",
      "location": "Belleville, ON K8N 0A3"
    }
  ],
  "error": null
}

type = "listing" with return_html = true: the response is the rendered page as raw HTML (text/html).

type = "description". Fields Indeed did not provide are null (or an empty list):

{
  "status_code": 200,
  "request_id": "11dcf259-0b20-4031-a34d-1a4483a4b07d",
  "elapsed_time": 812,
  "requests_used": 1,
  "request": {
    "type": "description",
    "job_id": "851e3d5c695dc544",
    "return_html": false
  },
  "results": {
    "job": {
      "job_id": "851e3d5c695dc544",
      "job_title": "Service associate M-F 9am-5:30pm PST",
      "job_url": "https://www.indeed.com/viewjob?jk=851e3d5c695dc544",
      "job_description": "<div><p><b>...</b></p>...</div>",
      "job_description_text": "Plain-text version of the description",
      "job_location": "Ontario, CA 91761",
      "job_country": "US",
      "remote": null,
      "job_types": ["Full-time"],
      "schedule": ["Monday to Friday"],
      "attributes": {"Work setting": ["In person"]},
      "benefits": ["401(k)", "Health insurance", "Paid holidays"],
      "salary": {
        "text": "$17.45 - $28.35 an hour",
        "min": 17.45,
        "max": 28.35,
        "currency": "USD",
        "type": "HOURLY",
        "source": "EXTRACTION"
      },
      "posted": "30+ days ago",
      "date_published": null,
      "urgently_hiring": false,
      "sponsored": false,
      "expired": false,
      "language": "en",
      "apply_url": "https://www.indeed.com/applystart?jk=851e3d5c695dc544",
      "apply_type": "company_site"
    },
    "company": {
      "company_name": "UPS",
      "company_url": "https://www.indeed.com/cmp/UPS",
      "company_logo_url": "https://d2q79iu7y748jz.cloudfront.net/s/_squarelogo/256x256/...",
      "company_rating": 3.7,
      "company_review_count": 63927,
      "company_address": "1754 East Cedar Street, Ontario, CA 91761",
      "latitude": 34.037083,
      "longitude": -117.613686
    }
  },
  "error": null
}

job.remote is Indeed's remote-work type (for example "REMOTE_ALWAYS") or null. job.apply_type is "indeed" when the job uses Indeed Apply and "company_site" when it links to the employer's site.

Error Codes

Code	Reason	Solution
403	Advanced plan required	Upgrade your plan
422	Invalid payload: unknown `type`, missing `url`/`job_id`, or a `url` that is not an Indeed `/jobs` page	Check the request body
429	Concurrency limit exceeded	Reduce parallel requests
502	The Indeed page could not be retrieved	Retry later; nothing was charged
504	The request took too long to complete	Retry later; nothing was charged

Failures return {"detail": "Failed to retrieve content"}.

Possible Error Responses

HTTP Status Codes

Status Code	Cause
401	Invalid API key; Not enough prepaid requests; Missing API key
403	The account is suspended
400	The provided country is not a valid ISO 3166-1 code
422	The request body fails validation
500	Server errors or unexpected issues

Country codes

If you want to define the geolocation for your request, you may set the country code (string) parameter with one country code at the creation of the request.

Supported country codes can be found in the collapsible table below:

Where US is a two-letter uppercase country code according to ISO 3166-1:

Country codes (click here to expand)

Code	Country name	Code	Country name	Code	Country name
AD	Andorra	GL	Greenland	NO	Norway
AE	United Arab Emirates	GM	Gambia	NP	Nepal
AF	Afghanistan	GN	Guinea	NR	Nauru
AG	Antigua and Barbuda	GP	Guadeloupe	NU	Niue
AI	Anguilla	GQ	Equatorial Guinea	NZ	New Zealand
AL	Albania	GR	Greece	OM	Oman
AM	Armenia	GS	South Georgia and the South Sandwich Islands	PA	Panama
AO	Angola	GT	Guatemala	PE	Peru
AQ	Antarctica	GU	Guam	PF	French Polynesia
AR	Argentina	GW	Guinea-Bissau	PG	Papua New Guinea
AS	American Samoa	GY	Guyana	PH	Philippines
AT	Austria	HK	Hong Kong	PK	Pakistan
AU	Australia	HM	Heard Island and McDonald Islands	PL	Poland
AW	Aruba	HN	Honduras	PM	Saint Pierre and Miquelon
AX	Åland Islands	HR	Croatia	PN	Pitcairn
AZ	Azerbaijan	HT	Haiti	PR	Puerto Rico
BA	Bosnia and Herzegovina	HU	Hungary	PS	Palestine, State of
BB	Barbados	ID	Indonesia	PT	Portugal
BD	Bangladesh	IE	Ireland	PW	Palau
BE	Belgium	IL	Israel	PY	Paraguay
BF	Burkina Faso	IM	Isle of Man	QA	Qatar
BG	Bulgaria	IN	India	RE	Réunion
BH	Bahrain	IO	British Indian Ocean Territory	RO	Romania
BI	Burundi	IQ	Iraq	RS	Serbia
BJ	Benin	IR	Iran (Islamic Republic of)	RU	Russian Federation
BL	Saint Barthélemy	IS	Iceland	RW	Rwanda
BM	Bermuda	IT	Italy	SA	Saudi Arabia
BN	Brunei Darussalam	JE	Jersey	SB	Solomon Islands
BO	Bolivia (Plurinational State of)	JM	Jamaica	SC	Seychelles
BQ	Bonaire, Sint Eustatius and Saba	JO	Jordan	SD	Sudan
BR	Brazil	JP	Japan	SE	Sweden
BS	Bahamas	KE	Kenya	SG	Singapore
BT	Bhutan	KG	Kyrgyzstan	SH	Saint Helena, Ascension and Tristan da Cunha
BV	Bouvet Island	KH	Cambodia	SI	Slovenia
BW	Botswana	KI	Kiribati	SJ	Svalbard and Jan Mayen
BY	Belarus	KM	Comoros	SK	Slovakia
BZ	Belize	KN	Saint Kitts and Nevis	SL	Sierra Leone
CA	Canada	KP	Korea (Democratic People's Republic of)	SM	San Marino
CC	Cocos (Keeling) Islands	KR	Korea, Republic of	SN	Senegal
CD	Congo, Democratic Republic of the	KW	Kuwait	SO	Somalia
CF	Central African Republic	KY	Cayman Islands	SR	Suriname
CG	Congo	KZ	Kazakhstan	SS	South Sudan
CH	Switzerland	LA	Lao People's Democratic Republic	ST	Sao Tome and Principe
CI	Côte d'Ivoire	LB	Lebanon	SV	El Salvador
CK	Cook Islands	LC	Saint Lucia	SX	Sint Maarten (Dutch part)
CL	Chile	LI	Liechtenstein	SY	Syrian Arab Republic
CM	Cameroon	LK	Sri Lanka	SZ	Eswatini
CN	China	LR	Liberia	TC	Turks and Caicos Islands
CO	Colombia	LS	Lesotho	TD	Chad
CR	Costa Rica	LT	Lithuania	TF	French Southern Territories
CU	Cuba	LU	Luxembourg	TG	Togo
CV	Cabo Verde	LV	Latvia	TH	Thailand
CW	Curaçao	LY	Libya	TJ	Tajikistan
CX	Christmas Island	MA	Morocco	TK	Tokelau
CY	Cyprus	MC	Monaco	TL	Timor-Leste
CZ	Czechia	MD	Moldova, Republic of	TM	Turkmenistan
DE	Germany	ME	Montenegro	TN	Tunisia
DJ	Djibouti	MF	Saint Martin (French part)	TO	Tonga
DK	Denmark	MG	Madagascar	TR	Türkiye
DM	Dominica	MH	Marshall Islands	TT	Trinidad and Tobago
DO	Dominican Republic	MK	North Macedonia	TV	Tuvalu
DZ	Algeria	ML	Mali	TW	Taiwan, Province of China
EC	Ecuador	MM	Myanmar	TZ	Tanzania, United Republic of
EE	Estonia	MN	Mongolia	UA	Ukraine
EG	Egypt	MO	Macao	UG	Uganda
EH	Western Sahara	MP	Northern Mariana Islands	UM	United States Minor Outlying Islands
ER	Eritrea	MQ	Martinique	US	United States of America
ES	Spain	MR	Mauritania	UY	Uruguay
ET	Ethiopia	MS	Montserrat	UZ	Uzbekistan
FI	Finland	MT	Malta	VA	Holy See
FJ	Fiji	MU	Mauritius	VC	Saint Vincent and the Grenadines
FK	Falkland Islands (Malvinas)	MV	Maldives	VE	Venezuela (Bolivarian Republic of)
FM	Micronesia (Federated States of)	MW	Malawi	VG	Virgin Islands (British)
FO	Faroe Islands	MX	Mexico	VI	Virgin Islands (U.S.)
FR	France	MY	Malaysia	VN	Viet Nam
GA	Gabon	MZ	Mozambique	VU	Vanuatu
GB	United Kingdom of Great Britain and Northern Ireland	NA	Namibia	WF	Wallis and Futuna
GD	Grenada	NC	New Caledonia	WS	Samoa
GE	Georgia	NE	Niger	YE	Yemen
GF	French Guiana	NF	Norfolk Island	YT	Mayotte
GG	Guernsey	NG	Nigeria	ZA	South Africa
GH	Ghana	NI	Nicaragua	ZM	Zambia
GI	Gibraltar	NL	Netherlands	ZW	Zimbabwe

Language codes

If you want to define the language in your request, you may set the language (string) parameter with one language tag at the creation of the request.

Language codes can be found in the collapsible table below:

All language codes/tags (click here to expand)

Language Tag	Language	Region	Description
ar-SA	Arabic	Saudi Arabia	Arabic (Saudi Arabia)
bn-BD	Bangla	Bangladesh	Bangla (Bangladesh)
bn-IN	Bangla	India	Bangla (India)
cs-CZ	Czech	Czech Republic	Czech (Czech Republic)
da-DK	Danish	Denmark	Danish (Denmark)
de-AT	German	Austria	Austrian German
de-CH	German	Switzerland	"Swiss" German
de-DE	German	Germany	Standard German (as spoken in Germany)
el-GR	Greek	Greece	Modern Greek
en-AU	English	Australia	Australian English
en-CA	English	Canada	Canadian English
en-GB	English	United Kingdom	British English
en-IE	English	Ireland	Irish English
en-IN	English	India	Indian English
en-NZ	English	New Zealand	New Zealand English
en-US	English	United States	US English
en-ZA	English	South Africa	English (South Africa)
es-AR	Spanish	Argentina	Argentine Spanish
es-CL	Spanish	Chile	Chilean Spanish
es-CO	Spanish	Columbia	Colombian Spanish
es-ES	Spanish	Spain	Castilian Spanish (as spoken in Central-Northern Spain)
es-MX	Spanish	Mexico	Mexican Spanish
es-US	Spanish	United States	American Spanish
fi-FI	Finnish	Finland	Finnish (Finland)
fr-BE	French	Belgium	Belgian French
fr-CA	French	Canada	Canadian French
fr-CH	French	Switzerland	"Swiss" French
fr-FR	French	France	Standard French (especially in France)
he-IL	Hebrew	Israel	Hebrew (Israel)
hi-IN	Hindi	India	Hindi (India)
hu-HU	Hungarian	Hungary	Hungarian (Hungary)
id-ID	Indonesian	Indonesia	Indonesian (Indonesia)
it-CH	Italian	Switzerland	"Swiss" Italian
it-IT	Italian	Italy	Standard Italian (as spoken in Italy)
ja-JP	Japanese	Japan	Japanese (Japan)
ko-KR	Korean	Republic of Korea	Korean (Republic of Korea)
nl-BE	Dutch	Belgium	Belgian Dutch
nl-NL	Dutch	The Netherlands	Standard Dutch (as spoken in The Netherlands)
no-NO	Norwegian	Norway	Norwegian (Norway)
pl-PL	Polish	Poland	Polish (Poland)
pt-BR	Portugese	Brazil	Brazilian Portuguese
pt-PT	Portugese	Portugal	European Portuguese (as written and spoken in Portugal)
ro-RO	Romanian	Romania	Romanian (Romania)
ru-RU	Russian	Russian Federation	Russian (Russian Federation)
sk-SK	Slovak	Slovakia	Slovak (Slovakia)
sv-SE	Swedish	Sweden	Swedish (Sweden)
ta-IN	Tamil	India	Indian Tamil
ta-LK	Tamil	Sri Lanka	Sri Lankan Tamil
th-TH	Thai	Thailand	Thai (Thailand)
tr-TR	Turkish	Turkey	Turkish (Turkey)
zh-CN	Chinese	China	Mainland China, simplified characters
zh-HK	Chinese	Hond Kong	Hong Kong, traditional characters
zh-TW	Chinese	Taiwan	Taiwan, traditional characters

Web Scraper API documentation

API Key​

Authentication​

Scraper and API endpoint​

Request body (JSON):​

Example cURL Request:​

Compatibility GET Request​

Success Response​

Example: Download an image​

Google SERP endpoint​

Parameters​

Response​

Behavior​

Examples​

Basic (10 results)​

Multiple pages (50 results)​

Specific pages only​

Force render + Google AI Overview​

Geo-targeted search​

Decode Base64 HTML​

Pricing​

Error Codes​

Limits​

Tips​

AI Search Endpoints​

Parameters​

Example: ChatGPT​

Example: Gemini​

Example: Perplexity​

Example: Raw HTML Response​

Example: Parsed JSON Response​

Success Response​

Error Codes​

Notes​

Render JS endpoint​

Request body (JSON):​

Example cURL Request:​

Success Response​

Indeed endpoint​

Request body (JSON):​

Example: Job listing (parsed JSON)​

Example: Job listing (raw HTML)​

Example: Job description​

Success Response​

Error Codes​

Possible Error Responses​

HTTP Status Codes​

Country codes​

Language codes​

API Key

Authentication

Scraper and API endpoint

Request body (JSON):

Example cURL Request:

Compatibility GET Request

Success Response

Example: Download an image

Google SERP endpoint

Parameters

Response

Behavior

Examples

Basic (10 results)

Multiple pages (50 results)

Specific pages only

Force render + Google AI Overview

Geo-targeted search

Decode Base64 HTML

Pricing

Error Codes

Limits

Tips

AI Search Endpoints

Parameters

Example: ChatGPT

Example: Gemini

Example: Perplexity

Example: Raw HTML Response

Example: Parsed JSON Response

Success Response

Error Codes

Notes

Render JS endpoint

Request body (JSON):

Example cURL Request:

Success Response

Indeed endpoint

Request body (JSON):

Example: Job listing (parsed JSON)

Example: Job listing (raw HTML)

Example: Job description

Success Response

Error Codes

Possible Error Responses

HTTP Status Codes

Country codes

Language codes