Lookip

Lookip ASN API

Public ASN directory. No key, no credit.

Documentation GitHub OpenAPI

Operations 2

GET /v1/asn/{asn} ASN Record #

GET /v1/asn ASN Search #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/lookip-asn-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Lookip ASN API
  version: 1.0.0
  summary: IP geolocation, ASN and VPN/proxy/Tor/hosting detection for any IPv4 or IPv6 address — we name the anonymising service, not just flag it. Prepaid credit, metered per query, no subscription.
  description: IP intelligence over plain HTTP GET and POST.
  termsOfService: https://lookip.io/legal/terms
  contact:
    name: Lookip
    url: https://lookip.io/docs
    email: hi@lookip.io
servers:
- url: https://api.lookip.io
  description: Production
security:
- bearerAuth: []
tags:
- name: ASN
  description: Public ASN directory. No key, no credit.
paths:
  /v1/asn/{asn}:
    get:
      tags:
      - ASN
      operationId: getAsn
      summary: ASN Record
      description: One ASN from the public directory. No key, no credit.
      security: []
      parameters:
      - name: asn
        in: path
        required: true
        description: AS number, with or without the AS prefix.
        schema:
          type: string
          pattern: ^(?:[Aa][Ss])?[0-9]+$
        example: AS15169
      responses:
        '200':
          description: The ASN record.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsnRecord'
              examples:
                record:
                  summary: One ASN from the public directory.
                  value:
                    asn: AS15169
                    number: 15169
                    name: Google LLC
                    domain: google.com
                    country: US
                    prefixCount: 6079
                    datasetVersion: '2026-08-13T13:37:50.000Z'
        '400':
          description: '`invalid_request` — Malformed body, invalid context, bad batch array, or an unparseable ASN.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                invalid_request:
                  summary: Malformed body, invalid context, bad batch array, or an unparseable ASN.
                  value:
                    error:
                      code: invalid_request
                      message: Malformed body, invalid context, bad batch array, or an unparseable ASN.
        '404':
          description: '`not_found` — No such ASN on the ASN endpoints. On a MAX lookup it also means the upstream provider holds no record for the address; the charge is reversed.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                not_found:
                  summary: No such ASN on the ASN endpoints. On a MAX lookup it also means the upstream provider holds no record for the address; the charge is reversed.
                  value:
                    error:
                      code: not_found
                      message: No such ASN on the ASN endpoints. On a MAX lookup it also means the upstream provider holds no record for the address; the charge is reversed.
        '500':
          description: '`internal_error` — Unhandled server fault. Any charge already taken is reversed.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                internal_error:
                  summary: Unhandled server fault. Any charge already taken is reversed.
                  value:
                    error:
                      code: internal_error
                      message: Unhandled server fault. Any charge already taken is reversed.
        '503':
          description: '`service_busy` — The database was briefly unable to start a transaction. Nothing was charged. Retry after a second.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                service_busy:
                  summary: The database was briefly unable to start a transaction. Nothing was charged. Retry after a second.
                  value:
                    error:
                      code: service_busy
                      message: The database was briefly unable to start a transaction. Nothing was charged. Retry after a second.
  /v1/asn:
    get:
      tags:
      - ASN
      operationId: searchAsn
      summary: ASN Search
      description: Search the public ASN directory by name, domain or number. No key, no credit.
      security: []
      parameters:
      - name: q
        in: query
        required: false
        description: Matches organisation name, domain, or AS number.
        schema:
          type: string
          maxLength: 120
      - name: country
        in: query
        required: false
        description: ISO 3166-1 alpha-2 country code.
        schema:
          type: string
          maxLength: 2
      - name: limit
        in: query
        required: false
        description: Maximum rows to return, 1 to 100. Anything unparseable falls back to the default.
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 50
      responses:
        '200':
          description: Matching ASN records, ordered by `prefixCount` descending — a sampled IPv4 size proxy, not a count of announced prefixes; see the field description. A row here is the same `AsnRecord` the single-record endpoint returns, `datasetVersion` included, so an ingest never has to come back and ask how current a row was.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsnSearchResult'
              examples:
                results:
                  summary: A search page. Each row is the same `AsnRecord` the single-record endpoint returns.
                  value:
                    items:
                    - asn: AS15169
                      number: 15169
                      name: Google LLC
                      domain: google.com
                      country: US
                      prefixCount: 6079
                      datasetVersion: '2026-08-13T13:37:50.000Z'
        '400':
          description: '`invalid_request` — Malformed body, invalid context, bad batch array, or an unparseable ASN.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                invalid_request:
                  summary: Malformed body, invalid context, bad batch array, or an unparseable ASN.
                  value:
                    error:
                      code: invalid_request
                      message: Malformed body, invalid context, bad batch array, or an unparseable ASN.
        '500':
          description: '`internal_error` — Unhandled server fault. Any charge already taken is reversed.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                internal_error:
                  summary: Unhandled server fault. Any charge already taken is reversed.
                  value:
                    error:
                      code: internal_error
                      message: Unhandled server fault. Any charge already taken is reversed.
        '503':
          description: '`service_busy` — The database was briefly unable to start a transaction. Nothing was charged. Retry after a second.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                service_busy:
                  summary: The database was briefly unable to start a transaction. Nothing was charged. Retry after a second.
                  value:
                    error:
                      code: service_busy
                      message: The database was briefly unable to start a transaction. Nothing was charged. Retry after a second.
components:
  schemas:
    ErrorCode:
      type: string
      title: ErrorCode
      description: Every `error.code` this API can return.
      enum:
      - invalid_request
      - invalid_ip
      - unauthorized
      - insufficient_credit
      - insufficient_credit_for_max
      - not_found
      - rate_limited
      - internal_error
      - auth_failed
      - upstream_error
      - lite_db_unavailable
      - service_busy
    Error:
      type: object
      title: Error
      properties:
        error:
          type: object
          properties:
            code:
              $ref: '#/components/schemas/ErrorCode'
            message:
              type: string
              description: Human-readable detail. Do not branch on it.
          required:
          - code
          - message
      required:
      - error
    AsnSearchResult:
      type: object
      title: AsnSearchResult
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/AsnRecord'
      required:
      - items
    AsnRecord:
      type: object
      title: AsnRecord
      properties:
        asn:
          type: string
          description: AS number with the AS prefix.
          examples:
          - AS15169
        number:
          type: integer
          description: AS number.
        name:
          type: string
          description: Registered organisation name.
        domain:
          type: string
          description: Organisation domain.
        country:
          type: string
          description: ISO 3166-1 alpha-2 country code of the registration.
        prefixCount:
          type: integer
          description: 'IPv4 /24 blocks attributed to this AS by a sampled sweep of routable IPv4 space: one address per /24 is probed, and the blocks that answer are counted. It is a size proxy — sampled and lossy — and it is not a count of announced BGP prefixes. On large networks the two differ by an order of magnitude, so do not read it as a route count.'
        datasetVersion:
          type: string
          description: ISO-8601 build time of the ASN dataset.
          format: date-time
      required:
      - asn
      - number
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Send your key as `Authorization: Bearer <key>`. The `?token=` query parameter is no longer accepted — a credential in a URL lands in access logs, browser history and the Referer header, none of which can be un-sent.'
externalDocs:
  description: API documentation
  url: https://lookip.io/docs