WhoisFreaks Databases - IP WHOIS API

IP WHOIS database snapshots

Documentation GitHub OpenAPI

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v3.3/download/snapshot/ip/whois Download the IP WHOIS snapshot · IP WHOIS Snapshot #

Ask an LLM

“Can I download WHOIS data for all IP ranges as a file?”

“How do I get the IP WHOIS snapshot from a specific date?”

Tell an agent

Download the IP WHOIS snapshot dated {date}.

Fetch the bulk IP WHOIS database for {date}.

GET /v3.3/status/snapshot/ip/whois Check IP WHOIS snapshot status · IP WHOIS Snapshot Status #

Ask an LLM

“Is a new IP WHOIS snapshot ready to download?”

“What is the publication status of the IP WHOIS database?”

Tell an agent

Show the status of the IP WHOIS snapshot.

Check when the IP WHOIS database was last updated.

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/whoisfreaks:whoisfreaks-databases-ip-whois-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: WhoisFreaks Databases - IP WHOIS API
  description: 'Complete WhoisFreaks API — WHOIS, DNS, SSL, Geolocation, Typosquatting,

    IP Intelligence, Domain Reputation, and bulk database downloads.


    ## Authentication

    All requests require an `apiKey` query parameter.


    ## Resources

    - Docs: https://whoisfreaks.com/documentation

    - Billing: https://billing.whoisfreaks.com

    - Support: support@whoisfreaks.com'
  version: 1.0.0
  contact:
    name: WhoisFreaks Support
    email: support@whoisfreaks.com
    url: https://whoisfreaks.com
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
- url: https://api.whoisfreaks.com
  description: API Solutions (live lookups)
- url: https://files.whoisfreaks.com
  description: Database file downloads
security:
- ApiKeyAuth: []
tags:
- name: Databases - IP WHOIS
  description: IP WHOIS database snapshots
paths:
  /v3.3/download/snapshot/ip/whois:
    servers:
    - url: https://files.whoisfreaks.com
    get:
      tags:
      - Databases - IP WHOIS
      summary: IP WHOIS Snapshot
      operationId: dbIpWhois
      parameters:
      - name: date
        in: query
        schema:
          type: string
          format: date
        required: true
      responses:
        '200':
          description: JSON gzipped
          content:
            application/octet-stream:
              schema:
                type: string
                format: binary
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      description: IP WHOIS Snapshot. Returns the file/snapshot described by this operation.
  /v3.3/status/snapshot/ip/whois:
    servers:
    - url: https://files.whoisfreaks.com
    get:
      tags:
      - Databases - IP WHOIS
      summary: IP WHOIS Snapshot Status
      operationId: dbIpWhoisStatus
      parameters: []
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SnapshotStatus'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      description: IP WHOIS Snapshot Status. Returns the file/snapshot described by this operation.
components:
  responses:
    ErrorResponse:
      description: Error response (4XX)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    ErrorResponse:
      type: object
      properties:
        timestamp:
          type: string
        path:
          type: string
        status: {}
        error:
          type: string
        message:
          type: string
        code:
          type: integer
      additionalProperties: true
      description: Error response. `status` may be an integer (e.g. 401), boolean, or string depending on the endpoint, so it is intentionally untyped to avoid deserialization failures.
    SnapshotStatus:
      type: object
      properties:
        status:
          type: string
        snapshot_creation_date:
          type: string
        snapshot_name:
          type: string
        snapshot_deletion_time:
          type: string
        message:
          type: string
      additionalProperties: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: apiKey