Quick Start Guide

This guide will walk you through the essential steps to get asnmap running and performing basic lookups.

Step 1: Install asnmap

If you haven't already, install asnmap on your system. We recommend using the pre-compiled binary for the quickest setup.

For detailed instructions, refer to the Installation Guide.

# Example using go install
go install -v github.com/projectdiscovery/asnmap/cmd/asnmap@latest

Step 2: Configure Authentication

asnmap requires a free API key from the ProjectDiscovery Cloud Platform (PDCP). The simplest way to configure it is to run the interactive setup:

asnmap -auth

Follow the prompt to enter your API key. For more configuration options, see the Authentication Guide.

Step 3: Perform Basic Lookups

Now you're ready to query for ASN information. asnmap supports multiple input types. Here are a few examples.

Look up an Organization

Find all IP address ranges associated with an organization.

asnmap -org GOOGLE

8.8.4.0/24
8.8.8.0/24
8.35.200.0/21
34.3.3.0/24
34.4.4.0/24
...

Look up an ASN

Provide an Autonomous System Number (ASN) to get its associated IP blocks.

asnmap -a AS15169

Look up a Domain

asnmap will resolve the domain to its IP addresses and then find the corresponding ASN and IP ranges.

asnmap -d hackerone.com

Look up an IP Address

Find the parent CIDR and ASN information for a specific IP address.

asnmap -i 104.16.99.52

What's Next?

You've now seen the basic functionality of asnmap. To explore more advanced features like different output formats and piping with other tools, check out the Usage Guide.