Real-time Requests

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

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"
    }
'

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

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?
The Web Scraping API retrieves the content you need.
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

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.