Real-time URL request

Basic Request Syntax

Basic real-time requests to the Web API are made using the endpoint. A simple request uses the following syntax:

Nimble APIs requires that a base64 encoded credential string be sent with every request to authenticate your account. For detailed examples, see Nimble APIs Authentication.

curl -X POST '' \
--header 'Authorization: Basic <credential string>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": ""

“URL” is the only required parameter that must be sent with each request besides the credential string, and defines the address from which to collect data. Additional parameters, such as geolocation targeting, parsing control, and custom headers can also be added. For a complete list of parameters, as well as more examples, see the Nimble Web API Documentation.


If successful, the WebAPI will return a 200 OK status with the following data structure:

        "status": "success",
        "html_content": string,
        "parsing": {
             "status": "success",
             "entities": { },
             "total_entities_count": 0,
             "entities_count": { }

The html_content node contains the full HTML of the requested page, and if parsing was enabled, the parsingnode will contain a structured JSON object of the data.