Updated Jul 15, 2026

Network

Attach geolocation and ASN data to IP lists

Official IPinfo CLI for IP geolocation and ASN lookups.

Agent

overview

What ipinfo does

ipinfo is the official CLI for the IPinfo API. Pass one IP or a list and get geolocation, ASN, organization, and related ownership fields without a custom HTTP client.

Use --json or --csv for pipelines, --field to keep only columns such as country or org, and --nocache when a cached answer is not enough. A token file raises rate and field limits.

Run it after DNS or host discovery when you need to group assets by region or ASN. Trickest hosts ipinfo as a managed Network node over an IP file. Use asnmap to go the other way, from org to ranges.

source github.com/ipinfo/cli

use cases

Where ipinfo fits

Enrich a list of IP addresses

Run ipinfo over a file of IPs to attach geolocation, organization, ASN, and hostname to each one in a single pass.

Tell apart cloud, CDN, and owned ranges

Use ownership and ASN data to classify which addresses belong to the target versus a provider, focusing the next stage.

Export structured network data

Choose --json to pipe into a downstream node or --csv to drop the enriched records straight into a spreadsheet.

Pull only the fields you need

Use --field to return the ASN and country alone, keeping the output lean for high-volume enrichment.

reference

ipinfo inputs and flags

6 inputs
NameTypeFlagDescription
csvBOOLEAN--csvoutput CSV format
jsonBOOLEAN--jsonoutput JSON format
fieldSTRING--fieldcomma-sneparated list of fields to look up in the output
no-cacheBOOLEAN--nocachedo not use the cache.
token-fileFILE·API token file
ip-addressesFILE·List of IP addresses

Showing key inputs. ipinfo exposes 6 inputs in total.

example

Run ipinfo

ipinfo · command
# ipinfo: geolocate a list of IPs as JSONipinfo 198.51.100.10 203.0.113.5 --json --field ip,country,org
sample output
{"ip":"198.51.100.10","country":"US","org":"AS64500 Example Net"}{"ip":"203.0.113.5","country":"US","org":"AS64501 Example Lab"}{"ip":"192.0.2.8","country":"US","org":"AS64500 Example Net"}{"ip":"198.51.100.44","country":"DE","org":"AS64502 Example EU"}{"ip":"203.0.113.90","country":"GB","org":"AS64503 Example UK"}

guidance

Choosing ipinfo

Use ipinfo to enrich IP addresses with geolocation, ownership, and ASN data. To map an organization to its ASNs and ranges, use asnmap. Resolve hostnames to IPs with a DNS tool before enrichment.

asnmap

Maps organizations and ASNs to IP ranges. Discovery side; ipinfo enriches individual addresses.

cdncheck

Classifies whether an IP belongs to a CDN or cloud. Narrower than ipinfo full geolocation and ASN record.

dnsx

Resolves hostnames to IPs. Run it before ipinfo to produce the addresses to enrich.

faq

ipinfo questions

Geolocation, owning organization and ASN, hostname, and network classification for each IP, drawn from the IPinfo API.

Run ipinfo yourself

An IP list feeds ipinfo, which enriches each address with geolocation, ownership, and ASN data and writes the records as a queryable output.

Facts on this page come from the live Trickest tool library.