Geo

Get the full information of multiple IP Addresses

Changed on

This API enables you to retrieve information for multiple IP addresses in a single request.

Bulk IP lookup (GET /geo/ip/bulk) lets you efficiently gather data such as location, ISP, and risk factors for a batch of IPs, saving time and streamlining your workflow for large-scale analysis.

get/geo/ip/bulk

Request

  • Base URL
    https://v2.greipapi.com
  • URL
    https://v2.greipapi.com/geo/ip/bulk
  • Auth
    HTTP bearer

Query parameters

ipsstring required
Example:1.1.1.1,8.8.8.8

Comma-separated IPv4 or IPv6 addresses (max 159 characters for the raw query value). Duplicate and invalid entries are skipped; at least one valid IP is required.

paramsstring
Example:security,timezone,currency,device

The params command selects optional response modules. Basic ip and geo fields are always included.

Recognized module names: security, currency, timezone, location, and/or device.

Unrecognized tokens are accepted but do not add modules.

Sample value: security,timezone,currency.

langstring
Example:AR

The lang command is used to get a response in a specific language.

callbackstring
Example:my_function_name

The callback command can help you make the response as a JSONP format.

Expected values: any name that can be used as a function name in Javascript, e.g: myFunctionName.

formatstring
Example:JSON

The format command is used to get a response in a specific format.

modestring
Example:test

The mode command is used to in the development stage to simulate the integration process before releasing it to the production environment.

Expected values: live, or test.

sourcestring
amountstring

Optional amount string used by usage and rate-limit gates.

user_idstring
Example:UID-12345

The user_id query parameter identifies requests from specific users for monitoring in the Events page. See the user identifier options page for details.

Response

OK

successboolean required
dataobject required

Endpoint-specific payload.

execution_msinteger required

Example response

{
  "success": true,
  "execution_ms": 42
}

Changes