Endpoint · Search

List suggestions

Resolve a name or phrase to the value a search filter needs: organisations, job titles and event vocabulary.

GET/v1/search/suggestions

Authentication

Bearer token in the Authorization header. The token reaches what your plan covers. Getting a token.

Parameters

query parameters

querystring·query
The name or phrase to resolve. Matches a substring.
pageinteger·query
1-based page number.Default 1
limitinteger·query
Rows per page, up to 100. A larger value is capped at 100, not rejected.Default 20

Response

success holds an array of the objects below, and meta holds the paging details.

  • fieldTypestringOrganisation, Occupation, MoveType, EventType, DealStatus or DealType.
  • labelstringWhat to show a user.
  • valuestringA reference for Organisation and Occupation, the exact value otherwise.
  • operatorstringAlways Equal.

People are not included. Use GET /v1/profiles to find a person.

Examples

Set CHIKARA_API_TOKEN and each sample runs as written. List samples page until a short page, with a hard cap. Example records are invented.

curl -sS -G "https://api.chikaraintel.com/v1/search/suggestions" \
  -H "Authorization: Bearer $CHIKARA_API_TOKEN" \
  -H "Accept: application/json" \
  --data-urlencode "query=Chief Financial" \
  --data-urlencode "limit=20" \
  --data-urlencode "page=1"

See pagination and errors.

Used by

MCP tools built on this endpoint.

Related