Get status
curl --request GET \
--url https://app.lev8.com/v1/entity-search/status \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.lev8.com/v1/entity-search/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.lev8.com/v1/entity-search/status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "entity_search_status",
"leads_search_id": "leads_search_01JABCDEF123456789",
"status": {
"status": "running",
"verified_count": 12,
"ready_count": 10,
"stop_reason": "source_finished",
"error": "internal error"
}
}Entity Search
Get status
Check Entity Search task progress and readable result count.
GET
/
v1
/
entity-search
/
status
Get status
curl --request GET \
--url https://app.lev8.com/v1/entity-search/status \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.lev8.com/v1/entity-search/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.lev8.com/v1/entity-search/status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "entity_search_status",
"leads_search_id": "leads_search_01JABCDEF123456789",
"status": {
"status": "running",
"verified_count": 12,
"ready_count": 10,
"stop_reason": "source_finished",
"error": "internal error"
}
}Returns the latest progress for a task created by the same API key. A terminal status request can also complete billing settlement.
Known
Status is available only to the exact API key that created the task. A missing task and a task owned by another key both return
Example
curl --get "https://app.lev8.com/v1/entity-search/status" \
--header "Authorization: Bearer $LEV8_API_KEY" \
--data-urlencode "leads_search_id=leads_search_01JABCDEF123456789"
Response
{
"object": "entity_search_status",
"leads_search_id": "leads_search_01JABCDEF123456789",
"status": {
"status": "running",
"ready_count": 10,
"verified_count": 12
}
}
| Field | Description |
|---|---|
status.status | created, running, done, or error. |
status.ready_count | Results currently available through Fetch. |
status.verified_count | Candidates checked so far, including accepted and rejected candidates; always at least ready_count. |
status.stop_reason | Terminal reason when available; omitted otherwise. |
status.error | The fixed value internal error for a failed task; omitted otherwise. |
stop_reason values include limit, source_finished, no_data_timeout, and rejected_streak. Treat new values as forward-compatible strings.
A task with
status: error can still have a positive ready_count. Fetch those completed results before closing the task locally. Xiaohongshu and WeChat Official Account tasks commonly stay running for 1 to 2 minutes before results are ready.404 not_found.
See Task results for the complete polling and fetch loop.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Required string length:
1 - 128