Batch: up to 100 000 addresses per call

If you are labelling a whole proxy list, use this instead of one request per proxy. Send up to 100,000 addresses in one call and get one result per address, in the same order you sent them, so you can zip the two lists together without matching on anything.

You are charged per distinct address, not per request and not per line. Duplicates are free, because they are free for us: a list that repeats one host across twenty ports is one lookup on our side, so it is one address on your budget, and there is no need to deduplicate before sending. Lines we reject as invalid or private are free for the same reason, since they never reach the lookup at all. Your budget per IP is 120,000 addresses in a burst, refilling 1,000 per second, and 2,000,000 per day.

Large batches stream. The response starts arriving as soon as the first addresses resolve rather than after the last one, which is what makes a call this size practical. It is still a single JSON document with a single results array in your original order, so res.json() and r.json() keep working exactly as before; the bytes simply arrive in pieces. Budget a couple of minutes for a fully cold 100 000-address batch. Anything we have looked up in the last six hours comes back from cache, so a list you re-check is far faster than the first run.

Addresses that cannot be resolved come back as { "ip": "…", "found": false } rather than being dropped, so the arrays always line up.