# 2s IP Info Bulk Lookup

> 2s IP Info Bulk Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Looks up geolocation and metadata for up to 100 IP addresses in a single batch request

## Facts

- Endpoint: POST https://2s.io/api/ipinfo/bulk
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-ip-info-bulk-lookup-20b8ac4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0iHLtQY4o2mQ_YGmkHb-5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-ip-info-bulk-lookup-20b8ac4a -d '<json body>'
```

Example prompt: Look up the geolocation and metadata for these IP addresses all at once: 8.8.8.8, 1.1.1.1, 203.0.113.5, and 198.51.100.42.

## When to prefer this

Use this endpoint when you need to geolocate or enrich multiple IP addresses in a single API call (up to 100) rather than making individual lookups. Ideal for log analysis, fraud detection, analytics enrichment, and any scenario where you have a batch of IPs to process. The pay-per-call model with no signup makes it ideal for sporadic or agent-driven usage.

## Known failure modes

- Individual IPs in the batch may fail (reflected in meta.failedCount) while others succeed
- Malformed IP strings may be rejected or return empty results
- Exceeding 100 IPs in the array returns a validation error
- Empty array input returns a validation error
- Payment failure via x402 blocks the entire request
- Rate limiting if too many calls are made rapidly

## How this service works

The (most) everything API: 575+ pay-per-call endpoints for AI agents — ground-truth data, a full AI gateway, and agent infrastructure (storage, queues, watchers). USDC via x402, no signup, no API keys, and upto billing: pay actual usage, not the quote.

## Output

Returns a JSON object with an array of items, each containing geolocation and metadata for the corresponding IP address, along with a meta object reporting how many lookups succeeded vs failed, the total count, and source attribution (provider name, URL, and license).

## Example request

```json
{
 "ips": [
  "8.8.8.8",
  "1.1.1.1",
  "203.0.113.5",
  "198.51.100.42"
 ]
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ips": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 64,
    "minLength": 1
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-ip-info-bulk-lookup-20b8ac4a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)