Ai Search Status Endpoint
Changed onPoll one search: the reasoning steps so far, and the scored table once it is complete.
steps grows while the search runs — it is the "Show reasoning" panel, and the first step names what the brief was understood as, which is the only way to tell a misread brief from an empty roster (both render as an empty table).
candidate_count is exact up to 10,000 and capped beyond it, because an uncapped COUNT over a six-figure match set is a full scan on every search. account_health has THREE states — "unknown" means we never measured the account, not that it is dead. Pass page or size to paginate candidates; omitting both preserves the original full-list response.
Request
- Base URLhttps://api.brandbooster.ai (the document declares no server; this is the origin it was published from)
- URLhttps://api.brandbooster.ai/api/v1/remy/ai-search/status/{job_id}
- AuthHTTP bearer
Path parameters
Query parameters
One-based result page; omit for the legacy full candidate list.
Candidates per page; defaults to 20 when page is provided.
Return the next pre-vetted batch past requested_count, from this offset.
Pre-vetted load-more batch size; defaults to 10 when more_offset is provided.
Response
Successful Response
Changes
- info
added the new optional
queryrequest parametermore_offset - info
added the new optional
queryrequest parametermore_size - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status
- info
- info
added the optional property
to the response with the status
- info