API reference navigation
GET /v1/search/capabilities

Search capabilities

Access
Authenticated
search:read
Cost
Free
Rate limit
120 / minute per account
Quota
None

The 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

  • 200 The engine capability doc
    • entities array of object required
      max 10 items
      • name string required
        UserRepoLinkedInUser
      • hasVector boolean required
      • rows integer | null required
        min 0, max 1000000000
    • levers array of object required
      max 100 items
      • key string required
        max 200 chars
      • tier one of required
      • entity string required
        max 200 chars
      • supported boolean required
      • coverage object
        • population integer required
          min 0, max 1000000000
        • reachable integer required
          min 0, max 1000000000
        • verified boolean required
      • note string
        max 5000 chars
    • rankSignals array of object required
      max 50 items
      • key string required
        max 200 chars
      • pushable boolean required
      • note string
        max 5000 chars
    • notes array of string required
      max 20 items
  • 401 No or invalid credential
    • code string required

      Stable 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_error
    • message string required

      Human-readable explanation of the refusal.

    • status integer required

      The HTTP status code, repeated in the body.

    • remedy object

      A self-serve path forward, when one exists (a 402 points at the credit top-up).

      • kind string required

        What 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_mailbox
      • url string required

        Where to go to clear the condition: an API path, or a web app page when only a person can.

  • 403 Missing search:read
    • code string required

      Stable 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_error
    • message string required

      Human-readable explanation of the refusal.

    • status integer required

      The HTTP status code, repeated in the body.

    • remedy object

      A self-serve path forward, when one exists (a 402 points at the credit top-up).

      • kind string required

        What 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_mailbox
      • url string required

        Where to go to clear the condition: an API path, or a web app page when only a person can.