Batch Geocode API

Introduction

NextBillion.ai Batch Geocode API allows searching for multiple known places using a single request. It can take up to 100 search queries and responds with matching place results for each of the search queries. The service accepts any free-form texts or known place names in the request body, to retrieve relevant results. The results are ranked based on the search score of a place.

The method enables searching for multiple known places in a single request. Provide up to 100 search queries to get a response with matching places for all provided queries. It accepts any free-form texts or known place names in the request body, to retrieve relevant results. The results are ranked based on the search score of a place.

Request Parameters

Request Body

Response Schema

Sample Request

1

2
curl --location 'https://api.nextbillion.io/h/geocode/batch?key=<your_api_key>' 
3
--header 'Content-Type: application/json' 
4
--data '[...]'

Sample API Response

1
[
2
    {
3
        "items": "[...]"
4
    },
5
    {
6
        "items": "[...]"
7
    },
8
    
9
]

API Query Limits

1. A maximum of 100 Search queries can be added to a single input.
2. NextBillion.ai allows a maximum rate limit of 60 queries per minute or 1 query per second for continuous requests.
   Note: We can increase the quota if needed on request. Contact [email protected] for more details.

API Error Codes