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].

Feedback

Something's missing? Request an article!
Got feedback? Let us know how we're doing and what can be improved.