Skip to main content

Search list-build inputs

Look up operation-specific native filter values or legacy input IDs using a bounded query.

GET/api/list-builds/inputs/search
HTTP referenceScope search:runUpdated September 27, 2026

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

  • 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 · optional

    string

    Lookup text; blank queries are supported only by some dimensions.

  • query · optional

    string

    Alias used when q is absent.

  • operation_id · optional

    string

    Required for native people/company/job dimensions: use the operation ID supplied by the input catalog.

  • limit · optional

    integer

    Maximum results. Default: 20. Max: 50.

Errors

StatusMeaning
400Invalid type or missing query.
401Invalid API key or missing auth.
403Missing search:run scope.
503Input lookup is temporarily unavailable.

Docs