Websites API

List, create, update and delete the websites on your account.

v1 5 endpoints

Authentication

Every request needs your API key
Get your API key

Send the key as a Bearer token in the Authorization header. Requests without a valid key return 401 Unauthorized. Plans without API access return 403 Forbidden.

Base URL https://www.dashboard.datablik.com/api/v1

GET List websites

Returns a paginated list of your websites.
Endpoint
GET /api/v1/websites
Request example
curl --location --request GET 'https://www.dashboard.datablik.com/api/v1/websites' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {api_key}'
Parameters 0 required · 6 optional
Name Type Description Default
search string Search query. —
search_by string Field to search. domain Domain. Default: domain domain
favorite boolean Only return favorited websites. —
sort_by string Sort by. id Date created, domain Domain. Default: id id
sort string Sort direction. desc Descending, asc Ascending. Default: desc desc
per_page integer Results per page. 10 25 50 100 Default: 10 10

GET Show a website

Returns one website and its settings.
Endpoint
GET /api/v1/websites/{id}
Request example
curl --location --request GET 'https://www.dashboard.datablik.com/api/v1/websites/{id}' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {api_key}'

POST Create a website

Adds a website to your account. Counts towards your plan’s website limit.
Endpoint
POST /api/v1/websites
Request example
curl --location --request POST 'https://www.dashboard.datablik.com/api/v1/websites' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer {api_key}' \ --data-urlencode 'domain={domain}'
Parameters 1 required · 7 optional
Name Type Description Default
domainRequired string Domain name, without protocol or path. —
privacy integer Who can see the stats. 0 Public, 1 Private, 2 Password. Default: 1 1
password string Password for the stats page. Only used when privacy is 2. —
email integer Periodic email reports. 0 Disabled, 1 Enabled. Default: 0 0
exclude_bots integer Exclude common bots from being tracked. 0 Disabled, 1 Enabled. Default: 1 1
exclude_params string URL query parameters to exclude from tracking. One per line. —
exclude_ips string IP addresses to exclude from tracking. One per line. —
favorited_at string Favorited date in Y-m-d\TH:i:s format. —

PUT PATCH Update a website

Changes a website’s settings. Only the fields you send are updated.
Endpoint
PUT PATCH /api/v1/websites/{id}
Request example
curl --location --request PUT 'https://www.dashboard.datablik.com/api/v1/websites/{id}' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer {api_key}'
Parameters 0 required · 7 optional
Name Type Description Default
privacy integer Who can see the stats. 0 Public, 1 Private, 2 Password. —
password string Password for the stats page. Only used when privacy is 2. —
email integer Periodic email reports. 0 Disabled, 1 Enabled. —
exclude_bots integer Exclude common bots from being tracked. 0 Disabled, 1 Enabled. —
exclude_params string URL query parameters to exclude from tracking. One per line. —
exclude_ips string IP addresses to exclude from tracking. One per line. —
favorited_at string Favorited date in Y-m-d\TH:i:s format. —

DELETE Delete a website

Permanently deletes a website and all of its stats.
Endpoint
DELETE /api/v1/websites/{id}
Request example
curl --location --request DELETE 'https://www.dashboard.datablik.com/api/v1/websites/{id}' \ --header 'Authorization: Bearer {api_key}'
This can’t be undone. The website and all its collected stats are deleted immediately.
Missing something?
Tell us which endpoint or field you need.
Contact us