API Basics
★  Fundamentals
★  Error Codes
★  Examples
★  Batch Processing
★  Specification
★  SDKs
★  Stats
Data Tools
WWW
★  Browser Bot
★  HTML Clean
★  Code Highlight
★  URL Info
Telephony
Geolocation
Security and Networking
E-commerce
Imaging

Batch Processing

You can send multiple requests in a single API call using the batch processing feature. This feature can be useful if you need to bulk process lots of existing data or you want to execute multiple API calls with a single HTTP request. In these cases batch processing can give you a good boost in overall performance.

To create a batch process you must send your request as JSON via HTTP POST with content-type "application/json"

For a batch request to be accepted it must contain a "data" element of type JSON array. Each element in this array represents a single API request and must contain at least an "endpoint" field which indicates which API endpoint the request is sent to. You can also add your own custom data to the requests and we will pass them back with the response. We will pass back all fields you send which are not part of the actual API request. This is most commonly used to attach system IDs to each request so they be easily identified on return.

End Point

https://neutrinoapi.com/multi


Limits


Maximum requests allowed in a single batch:
API PlanMaximum Batch Size
FreeN/A
Tier 1N/A
Tier 2250
Tier 32500

Endpoints enabled for batch processing:

Example Request


This example demonstrates sending 4 API requests across 2 different endpoints:

https://neutrinoapi.com/multi
POST /multi HTTP/1.1
Host: neutrinoapi.com
Content-Type: application/json

{
    "user_id": "YOUR_USER_ID",
    "api_key": "YOUR_API_KEY",
    "output_case": "snake",
    "data": [
        {
            "endpoint": "ip-info",
            "ip": "23.253.146.71",
            "id": "USER1"
        },
        {
            "endpoint": "ip-blocklist",
            "ip": "23.253.146.71",
            "id": "USER1"
        },
        {
            "endpoint": "ip-info",
            "ip": "162.13.77.125",
            "id": "USER2"
        },
        {
            "endpoint": "ip-blocklist",
            "ip": "162.13.77.125",
            "id": "USER2"
        }
    ]
}
 

Example Response


[
    {
        "valid": true,
        "country": "United States",
        "country_code": "US",
        "hostname": "",
        "endpoint": "ip-info",
        "city": "Dulles",
        "ip": "23.253.146.71",
        "latitude": 38.951667785645,
        "id": "USER1",
        "region": "Virginia",
        "longitude": -77.448059082031
    },
    {
        "is_spam_bot": false,
        "is_malware": false,
        "is_listed": false,
        "last_seen": 0,
        "list_count": 0,
        "ip": "23.253.146.71",
        "is_tor": false,
        "is_vpn": false,
        "endpoint": "ip-blocklist",
        "is_hijacked": false,
        "is_exploit_bot": false,
        "id": "USER1",
        "is_spider": false,
        "is_dshield": false,
        "is_spyware": false,
        "is_bot": false,
        "is_proxy": false
    },
    {
        "valid": true,
        "country": "United Kingdom",
        "country_code": "GB",
        "hostname": "",
        "endpoint": "ip-info",
        "city": "London",
        "ip": "162.13.77.125",
        "latitude": 51.508529663086,
        "id": "USER2",
        "region": "England",
        "longitude": -0.12574000656605
    },
    {
        "is_spam_bot": false,
        "is_malware": false,
        "is_listed": false,
        "last_seen": 0,
        "list_count": 0,
        "ip": "162.13.77.125",
        "is_tor": false,
        "is_vpn": false,
        "endpoint": "ip-blocklist",
        "is_hijacked": false,
        "is_exploit_bot": false,
        "id": "USER2",
        "is_spider": false,
        "is_dshield": false,
        "is_spyware": false,
        "is_bot": false,
        "is_proxy": false
    }
]