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

# Real-time Requests

> Web Scraping API 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:

<CodeGroup>
  ```shellscript cURL theme={null}
  # 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"
      }
  '
  ```
</CodeGroup>

#### Response Example:

<CodeGroup>
  ```json JSON expandable theme={null}
  {
    "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"
        }
    ]
  }
  ```
</CodeGroup>

***

## Quick Start

1. Send a query. To specify it, you can add [**parameters**](https://help.decodo.com/docs/web-scraping-api-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?**](https://help.decodo.com/docs/web-scraping-api-quick-start)
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`.

<Note>
  ### 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.
</Note>

***

<Columns cols={2}>
  <Card title="Support" href="https://direct.lc.chat/12092754" cta="Let's chat!">
    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](mailto:support@decodo.com).
  </Card>

  <Card title="Feedback" href="mailto:feedback@decodo.com" cta="Share feedback">
    Can't find what you're looking for? Request an article! \
    Have feedback? Share your thoughts on how we can improve.
  </Card>
</Columns>