List failed searches
curl --request GET \
--url https://{your-subdomain}.neetokb.com/api/external/v2/reports/failed_searches \
--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/failed_searches', 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/failed_searches"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"failed_searches": [
{
"keyword": "refund",
"search_count": 2
}
],
"pagination": {
"total_records": 123,
"total_pages": 123,
"current_page_number": 123,
"page_size": 123
}
}{
"error": "<string>"
}Reports
List failed searches
This API lists the searches that found no article, with how often each was made, for the period you pick.
GET
/
reports
/
failed_searches
List failed searches
curl --request GET \
--url https://{your-subdomain}.neetokb.com/api/external/v2/reports/failed_searches \
--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/failed_searches', 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/failed_searches"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"failed_searches": [
{
"keyword": "refund",
"search_count": 2
}
],
"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"
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