steampipe plugin install ipinfo

Table: ipinfo_ip - Query IPinfo IP Addresses using SQL

IPinfo is a comprehensive IP data provider, offering data on IP addresses including geolocation, ASN, ISP, and more. This service allows you to gain insights into where your users are coming from and how your app's performance varies by region, ISP, and other factors. It's an invaluable resource for businesses that need to understand their online traffic and optimize their user experience.

Table Usage Guide

The ipinfo_ip table provides insights into IP addresses data within IPinfo. As a network administrator or cybersecurity analyst, explore IP-specific details through this table, including geolocation, ISP, and associated metadata. Utilize it to uncover information about IP addresses, such as their geographical location, the ISP providing the service, and other pertinent details.

Examples

Info for your IP address

Discover the geographical details associated with your IP address, such as city, region, postal code, and country. This can be useful for understanding the location data linked to your online activities.

select
ip,
city,
region,
postal,
country_name
from
ipinfo_ip;
select
ip,
city,
region,
postal,
country_name
from
ipinfo_ip;

Info for a specific IP address

Explore which city, region, and country a specific IP address is associated with. This can be useful for understanding the geographic distribution of your users or for detecting potentially suspicious activity.

select
ip,
city,
region,
postal,
country_name
from
ipinfo_ip
where
ip = '1.1.1.1';
select
ip,
city,
region,
postal,
country_name
from
ipinfo_ip
where
ip = '1.1.1.1';

Info for a collection of IP addresses

Explore the geographical locations associated with a set of IP addresses. This query is useful for understanding the distribution of users or network requests across different regions.

select
ip,
city,
region,
postal,
country_name
from
ipinfo_ip
where
ip in ('1.1.1.1', '8.8.8.8');
select
ip,
city,
region,
postal,
country_name
from
ipinfo_ip
where
ip in ('1.1.1.1', '8.8.8.8');

Info for IP addresses in a CSV file

This query is useful for identifying geographical information related to a set of IP addresses. It can be used to gain insights into where certain IP addresses are based, including details about their city, region, and country, which can be beneficial for understanding user demographics or tracking potential security threats. Assume a CSV file called my_ips.csv made available by the CSV plugin:

address,provider
1.1.1.1,Cloudflare
8.8.8.8,Google

Then it can be joined with the ipinfo_ip table to gather information:

-- Query IPs from the CSV first, to force the planner
with ips as (
select
address :: inet as ip
from
my_ips
order by
ip
)
select
ip,
city,
region,
postal,
country_name
from
ipinfo_ip
where
ipinfo_ip.ip in (
select
ip
from
ips
);
Error: SQLite does not support CIDR operations.

Unfortunately, this simpler query does not work because the Postgres planner tries to scan the ipinfo_ip table:

select
ip,
city,
region,
postal,
country_name
from
ipinfo_ip
where
ipinfo_ip.ip in (
select
address :: inet
from
my_ips
);
Error: SQLite does not support CIDR operations.

Unfortunately, this simpler query does not work because the Postgres planner tries to scan the ipinfo_ip table:

select
ip,
city,
region,
postal,
country_name
from
csv.my_ips as i,
ipinfo_ip
where
ipinfo_ip.ip = i.address;
select
ip,
city,
region,
postal,
country_name
from
csv_my_ips as i,
ipinfo_ip
where
ipinfo_ip.ip = i.address;

Schema for ipinfo_ip

NameTypeOperatorsDescription
_ctxjsonbSteampipe context in JSON form, e.g. connection_name.
abusejsonbAbuse contact information. Paid plans only.
anycastbooleanTrue if this is an anycast IP.
asnjsonbAutonomous System Number (ASN) of the administrator for the IP, e.g. AS13335
bogonbooleanTrue if the IP is from a special use, non-public range. See https://ipinfo.io/bogon
carrierjsonbCarrier contact information. Paid plans only.
citytextCity of the location, e.g. Los Angeles
companyjsonbCompany information. Paid plans only.
countrytextCountry code of the location, e.g. US
country_nametextCountry name of the location, e.g. United States
domainsjsonbDomains associated with the IP. Pain plans only.
hostnametext
ipinet=IP address to query.
is_eubooleanTrue if the IP address is located in the European Union (EU).
locationtextGeocode location, e.g. 34.0522,-118.2437
orgtextName of the organization that manages the IP, e.g. AS13335 Cloudflare, Inc.
postaltextPostal code of the location, e.g. 90076
privacyjsonbPrivacy data (e.g. VPC). Paid plans only.
regiontextRegion of the location, e.g. California
timezonetextTimezone of the location, e.g. America/Los_Angeles

Export

This table is available as a standalone Exporter CLI. Steampipe exporters are stand-alone binaries that allow you to extract data using Steampipe plugins without a database.

You can download the tarball for your platform from the Releases page, but it is simplest to install them with the steampipe_export_installer.sh script:

/bin/sh -c "$(curl -fsSL https://steampipe.io/install/export.sh)" -- ipinfo

You can pass the configuration to the command with the --config argument:

steampipe_export_ipinfo --config '<your_config>' ipinfo_ip