/v1/search/capabilitiesSearch capabilities
search:readThe machine-readable engine capability doc: serving entities, levers with coverage tier and reachable universe, and rank signals with pushability. This is what an MCP server or code-mode agent builds its tool table from. Free.
Responses
200The engine capability docentitiesarray of object requiredmax 10 itemsnamestring requiredUserRepoLinkedInUserhasVectorboolean requiredrowsinteger | null requiredmin 0, max 1000000000
leversarray of object requiredmax 100 itemskeystring requiredmax 200 charstierone of requiredentitystring requiredmax 200 charssupportedboolean requiredcoverageobjectpopulationinteger requiredmin 0, max 1000000000reachableinteger requiredmin 0, max 1000000000verifiedboolean required
notestringmax 5000 chars
rankSignalsarray of object requiredmax 50 itemskeystring requiredmax 200 charspushableboolean requirednotestringmax 5000 chars
notesarray of string requiredmax 20 items
401No or invalid credentialcodestring requiredStable machine-readable error code. Branch on this, never on the numeric status.
bad_requestunauthorizedsignature_requiredpayment_requiredforbiddennot_foundconflictgonepayload_too_largeunprocessable_entitytoo_many_requestsinternal_errornot_implementedbilling_unavailablenot_contactablemailbox_link_unavailablemailbox_requiredmail_engine_unavailablewebhook_publisher_unavailabledatabase_unavailableclient_errormessagestring requiredHuman-readable explanation of the refusal.
statusinteger requiredThe HTTP status code, repeated in the body.
remedyobjectA self-serve path forward, when one exists (a 402 points at the credit top-up).
kindstring requiredWhat kind of remedy this is, so a client can route it: whether the caller can clear the condition through the API, or a person must act in the web app.
topupconnect_mailboxurlstring requiredWhere to go to clear the condition: an API path, or a web app page when only a person can.
403Missing search:readcodestring requiredStable machine-readable error code. Branch on this, never on the numeric status.
bad_requestunauthorizedsignature_requiredpayment_requiredforbiddennot_foundconflictgonepayload_too_largeunprocessable_entitytoo_many_requestsinternal_errornot_implementedbilling_unavailablenot_contactablemailbox_link_unavailablemailbox_requiredmail_engine_unavailablewebhook_publisher_unavailabledatabase_unavailableclient_errormessagestring requiredHuman-readable explanation of the refusal.
statusinteger requiredThe HTTP status code, repeated in the body.
remedyobjectA self-serve path forward, when one exists (a 402 points at the credit top-up).
kindstring requiredWhat kind of remedy this is, so a client can route it: whether the caller can clear the condition through the API, or a person must act in the web app.
topupconnect_mailboxurlstring requiredWhere to go to clear the condition: an API path, or a web app page when only a person can.