Quick start
Web Scraping API Quick Start
Decodo Web Scraping API is a comprehensive data collection solution for eCommerce marketplaces, search engine results pages, social media platforms, and various other websites.
Get API credentials
Obtain your API credentials by creating an account first. Once logged into the Dashboard purchase a free trial or subscription (find more information about pricing here). Then navigate to the API Playground to retrieve your API Token or Username and Password.
First Request
Test your setup with simple request:
curl --request 'POST' \
--url 'https://scraper-api.decodo.com/v2/scrape' \
--header 'Accept: application/json' \
--header 'Authorization: Basic TOKEN VALUE' \ // update with your authorization token
--header 'Content-Type: application/json' \
--data '
{
"url": "https://ip.decodo.com"
}
'Don't forget to update Authorization section with your token.
You should receive HTML response, location will be randomized and might differ from an example:
{
"results": [
{
"content": "{\n \"browser\": {\n \"name\": \"Firefox\",\n \"version\": \"123.0\"\n },\n \"platform\": {\n \"name\": \"Windows\",\n \"os\": \"Windows 10\",\n \"type\": \"desktop\"\n },\n \"engine\": {\n \"name\": \"Gecko\",\n \"version\": \"20100101\"\n },\n \"isp\": {\n \"isp\": \"Cogent Communications\",\n \"asn\": 174,\n \"domain\": \"\",\n \"organization\": \"Cogent Communications\"\n },\n \"city\": {\n \"name\": \"New York\",\n \"code\": \"NY\",\n \"state\": \"New York\",\n \"time_zone\": \"America/New_York\",\n \"zip_code\": \"10118\",\n \"latitude\": 40.7126,\n \"longitude\": -74.0066\n },\n \"proxy\": {\n \"ip\": \"149.115.134.88\"\n },\n \"country\": {\n \"code\": \"US\",\n \"name\": \"United States\",\n \"continent\": \"North America\"\n }\n}\n",
"headers": {
"content-length": "813",
"content-type": "application/json",
"date": "Wed, 28 Jan 2026 14:06:35 GMT",
"server": "nginx"
},
"cookies": [],
"status_code": 200,
"task_id": "7422278918918391809",
"created_at": "2026-01-28 14:06:33",
"updated_at": "2026-01-28 14:06:35"
}
]
}Find out more
Our API offers many features that might interest you, here's a few main topics.
Three integration types are supported:
- Synchronous (real-time) requests, read more here.
- Asynchronous requests, read more here.
- Batch requests, read more here.
We support a lot of parameters like JS rendering, browser actions, device types and more, read here.
Check out our huge Target Template offering for Google, Amazon, ChatGPT and more, read here.
Support
Still can't find an answer? Want to say hi? We take pride in our 24/7 customer support. Alternatively, you can reach us via our support email at [email protected].
Updated 15 days ago