Skip to main content
GET
/
1
/
domains
List registered domains
curl --request GET \
  --url https://crawler.algolia.com/api/1/domains \
  --header 'Authorization: Basic <encoded-value>'
{
  "items": [
    {
      "appId": "<string>",
      "domain": "wwww.algolia.com",
      "validated": true
    }
  ],
  "itemsPerPage": 20,
  "page": 1,
  "total": 100
}
Crawlers will only run if the URLs match any of the registered domains. Required ACL: settings

Authorizations

ā€‹
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

ā€‹
appID
string

Algolia application ID for filtering the API response. Algolia application ID where the crawler creates and updates indices.

ā€‹
itemsPerPage
integer
default:20

Number of items per page to retrieve. Number of items per page of the paginated API response.

Required range: 1 <= x <= 100
ā€‹
page
integer
default:1

Page to retrieve. Current page of the paginated API response.

Required range: 1 <= x <= 100

Response

Domains

Pagination information.

ā€‹
items
domainResponse Ā· object[]
ā€‹
itemsPerPage
integer
default:20

Number of items per page of the paginated API response.

Required range: 1 <= x <= 100
ā€‹
page
integer
default:1

Current page of the paginated API response.

Required range: 1 <= x <= 100
ā€‹
total
integer

Total number of retrievable items.

Example:

100

Last modified on March 23, 2026