Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.decodo.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Introduction

The real-time integration puts the entire job request into one URL, which is formed by the API.

​
Post Endpoint:

scraper-api.decodo.com/v2/scrape

​
Example:

# update 'TOKEN VALUE' with your authorization token
curl --request 'POST' \
        --url 'https://scraper-api.decodo.com/v2/scrape' \
        --header 'Accept: application/json' \
        --header 'Authorization: Basic TOKEN VALUE' \ 
        --header 'Content-Type: application/json' \
        --data '
    {
      "url": "https://ip.decodo.com"
    }
'

​
Response 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"
      }
  ]
}

​
Quick Start

  1. Send a query. To specify it, you can add parameters.
    • You need to post query parameters in the same way you post JSON ones.
    • Don’t forget to input your credentials (tokens). How to find it?
  2. The Web Scraping API retrieves the content you need.
  3. The data should come back with the HTTP status code 200, and it should be parsed in JSON format or contain raw HTML.

​
Keep an Open Connection

  • If the connection is closed before the job is completed, the data is lost.
  • The timeout limit for open connections is 150 seconds. In a rare case of a heavy load, we may not be able to get the data to you.
  • You can collect data using the same connection and get an immediate response.

Support

Need help or just want to say hello? Our support is available 24/7.
You can also reach us anytime via email at support@decodo.com.

Feedback

Can’t find what you’re looking for? Request an article!
Have feedback? Share your thoughts on how we can improve.