List invalid urls
curl --request GET \
--url https://{your-subdomain}.neetokb.com/api/external/v2/reports/invalid_urls \
--header 'X-Api-Key: <x-api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};
fetch('https://{your-subdomain}.neetokb.com/api/external/v2/reports/invalid_urls', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetokb.com/api/external/v2/reports/invalid_urls"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"invalid_urls": [
{
"url": "/gone",
"urls_count": 2,
"referer_url": "https://example.com/blog"
}
],
"pagination": {
"total_records": 123,
"total_pages": 123,
"current_page_number": 123,
"page_size": 123
}
}{
"error": "<string>"
}Reports
List invalid URLs
This API lists URLs visitors opened that did not exist, with how often each was opened, for the period you pick.
GET
/
reports
/
invalid_urls
List invalid urls
curl --request GET \
--url https://{your-subdomain}.neetokb.com/api/external/v2/reports/invalid_urls \
--header 'X-Api-Key: <x-api-key>'const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};
fetch('https://{your-subdomain}.neetokb.com/api/external/v2/reports/invalid_urls', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetokb.com/api/external/v2/reports/invalid_urls"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"invalid_urls": [
{
"url": "/gone",
"urls_count": 2,
"referer_url": "https://example.com/blog"
}
],
"pagination": {
"total_records": 123,
"total_pages": 123,
"current_page_number": 123,
"page_size": 123
}
}{
"error": "<string>"
}Replace
Learn how to find your subdomain in Workspace subdomain.
{your-subdomain} with your workspace’s subdomain. Learn how to find your subdomain in Workspace subdomain.
Headers
Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.
Query Parameters
Period to report on. Defaults to all_time. For custom, send both start_date and end_date.
Available options:
all_time, last_24_hours, last_7_days, this_week, last_week, last_30_days, this_month, last_month, this_quarter, last_quarter, custom Start of the period as an ISO 8601 date or time. Needed with duration=custom. Must not be after end_date.
Example:
"2026-03-01"
End of the period as an ISO 8601 date or time. Needed with duration=custom.
Example:
"2026-03-31"
Only rows for this URL.
Page of results to retrieve, starting from 1. Defaults to 1 when omitted.
Number of results per page. Defaults to 30 when omitted.
Response
OK - Request succeeded