Available in plans >= medium

Domain Endpoint

Retrieves all domains hosted on a single IP address.


GET/v2/domains

Domain Information

This domain endpoint returns information about hosted domains via a specified IP address.

Required attributes

  • Name
    ip
    Type
    string
    Description

    The IPv4 address you want to query the domains for (IPv6 addresses are not supported)

The JavaScript, Python and PHP SDKs do not cover this endpoint yet, so the examples call it over plain HTTP.

Optional attributes

  • Name
    cursor
    Type
    string
    Description

    The opaque cursor token for iterating through all domains — take it from the next_cursor field (or next_page_url) of the previous response

  • Name
    per_page
    Type
    integer
    Description

    The number of domains you want to see on each page, between 1 and 100 (default: 30)

Response Properties

  • Name
    data
    Type
    array<string>
    Description

    The hosted domains on this IP address as an array of strings

  • Name
    total_count
    Type
    integer
    Description

    ️️The total count of domains hosted on this IP address

  • Name
    next_cursor
    Type
    string
    Description

    ️The cursor to the next page of the domains

  • Name
    next_page_url
    Type
    string
    Description

    ️A link to the next page of the domains

  • Name
    per_page
    Type
    integer
    Description

    ️The number of domains listed in one request

  • Name
    prev_cursor
    Type
    string
    Description

    ️The cursor to the previous page of the domains

  • Name
    prev_page_url
    Type
    string
    Description

    A link to the previous page of the domains

Request

GET
/v2/domains
curl -G https://api.ipbase.com/v2/domains \
    -d ip=1.1.1.1 \
    -H "apikey: YOUR-API-KEY"

Full Response

{
    "data": [
        "eliwise.academy",
        "accountingprose.academy",
        "pistola.academy",
        "1and1-test-ntlds-fr.accountant",
        "omnergy.africa",
        "sulphur.africa",
        "saadeh.agency",
        "mi6-gov.agency",
        "zhonghuidigi.agency",
        "alecta.app",
        "carso.app",
        "desaparecidos.app",
        "hx.app",
        "ibx.app",
        "lawso.app",
        "akey.app",
        "yabo168.app",
        "yabo188.app",
        "bob223.app",
        "yabo104.app",
        "yabo110.app",
        "yabo113.app",
        "yabo118.app",
        "yabo125.app",
        "yabo127.app",
        "yabo130.app",
        "yabo131.app",
        "yabo132.app",
        "yabo134.app",
        "yabo135.app"
    ],
    "total_count": 11046,
    "per_page": 30,
    "next_cursor": "eyJpZCI6MzI1MDQsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
    "next_page_url": "https://api.ipbase.com/v2/domains?apikey=YOUR-API-KEY&ip=1.1.1.1&cursor=eyJpZCI6MzI1MDQsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
    "prev_cursor": "eyJpZCI6MjM4ODksIl9wb2ludHNUb05leHRJdGVtcyI6ZmFsc2V9",
    "prev_page_url": "https://api.ipbase.com/v2/domains?apikey=YOUR-API-KEY&ip=1.1.1.1&cursor=eyJpZCI6MjM4ODksIl9wb2ludHNUb05leHRJdGVtcyI6ZmFsc2V9"
}