This page documents the canonical HTTP contract for this endpoint.
Select the operation and dimension from operations in the input catalog. Native people/company lookups require lists.build_people or lists.build_companies. Jobs use lists.build_jobs. Suggestions are sampled, dated vocabulary—not an exhaustive allowlist or proof that a filter matches correctly. Other plausible values can be tried and verified against returned evidence.
Query parameters
typerequiredstring
Dimension from the input catalog: native country_code, industry, specialty, employee_range, revenue_range, funding_type, technology, job_level, job_function, persona, or a separate jobs dimension.
q· optionalstring
Lookup text; blank queries are supported only by some dimensions.
query· optionalstring
Alias used when q is absent.
operation_id· optionalstring
Required for native people/company/job dimensions: use the operation ID supplied by the input catalog.
limit· optionalinteger
Maximum results. Default: 20. Max: 50.
| Name | Type | Description |
|---|---|---|
| typerequired | string | Dimension from the input catalog: native country_code, industry, specialty, employee_range, revenue_range, funding_type, technology, job_level, job_function, persona, or a separate jobs dimension. |
| q | string | Lookup text; blank queries are supported only by some dimensions. |
| query | string | Alias used when q is absent. |
| operation_id | string | Required for native people/company/job dimensions: use the operation ID supplied by the input catalog. |
| limit | integer | Maximum results. Default: 20. Max: 50. |
Errors
| Status | Meaning |
|---|---|
| 400 | Invalid type or missing query. |
| 401 | Invalid API key or missing auth. |
| 403 | Missing search:run scope. |
| 503 | Input lookup is temporarily unavailable. |
