Authentication

All API requests require authentication using a Bearer token. This guide explains how to obtain and use your API key.

Bearer token

Authenticate your requests by including your API key as a Bearer token in the Authorization header:

Example request with Bearer token

curl https://websitedata.app/json/api/v1/domain/example.com \
  -H "Authorization: Bearer {your-api-key}"

Obtaining an API key

Open the Account page in the Dashboard WebsiteData dashboard
Click "Create API Key"
Copy and securely store your key

You can create up to 5 API keys per account. Keys can be enabled or disabled individually from the dashboard.

Keep your API key secure. Do not share it in public repositories, client-side code, or any other publicly accessible location. If you suspect a key has been compromised, disable it immediately and create a new one.

API credits

Each API request consumes credits from your account's monthly allocation. The number of credits consumed depends on your plan:

Name
Basic plan
Description
Limited query results and API rate. Suitable for testing and small projects.
Name
Pro plan
Description
Higher query limits and rate limits. Suitable for production applications.

If you exceed your monthly credit allocation, API requests will return a 402 Payment Required response.

Rate limiting

API requests are rate-limited per account. If you exceed the rate limit, you'll receive a 429 Too Many Requests response. The rate limit depends on your plan tier.