Batch Lookups

You need a paid account with sufficient quota to use this functionality.

Perhaps the most useful command provided by the CLI is the ability to process a csv file with a list of IP addresses and write the results to file as either CSV or JSONL/NDJSON! It could be a list of tens of thousands to millions of IP addresses and it will all be processed and the results filtered to your liking!

When you use the JSON output format, the results are written to the output file you provide with one result per line. Each line being a valid and full JSON response object.
If you only need a few fields eg. only the country name you can specify a field argument with the names of the fields you want, if you combine this with the CSV output format you will get very clean results with only the data you need!

To get full JSON responses for further processing

This is the default output format, so you could omit the --format JSON

ipdata batch my_ip_backlog.csv --output geolocation_results.json --format JSON

Batch lookup with output to CSV file

ipdata batch my_ip_backlog.csv --output results.csv --format CSV --fields ip --fields country_code

The --fields option is required to use CSV output.

Example Results

# ip,country_code
107.175.75.83,US
35.155.95.229,US
13.0.0.164,US
209.248.120.14,US
142.0.202.238,US
...