Sign in
Agentic search

Natural language search

Takes free-form text (e.g., 'Senior Product Managers at Series A FinTech startups in New York') and returns matching companies or people. The API determines the result type based on query interpretation — company-specific queries return companies, everything else returns people. Supports cursor-based pagination via a single pageToken.

<span>⚡ <strong>Rate limit:</strong> 120 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> Fixed costs per request (first page only):<br />• 2 credits for AI search interpretation<br /><br />Variable costs per result:<br />• 1 credits per company returned<br />• 1 credits per profile returned <span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

<span>⏱ <strong>Recommended timeout:</strong> 1 minute <span title="Recommended timeout: set your HTTP client timeout to at least 1 minute for this endpoint.">ⓘ</span></span>

post/v1/nlp-search/run

Request body

apiKeystring required

Your Fiber API key

querystring nullable

Natural language search query. Required on the first request. Ignored when pageToken is provided.

pageSizeinteger

Number of results per page (1-1000). Applied to whichever result type is returned.

companyExclusionListIDsstring[] nullable

IDs of exclusion lists to filter out companies. Applied when returning companies, or to narrow company-based profile filtering.

peopleExclusionListIDsstring[] nullable

IDs of exclusion lists to filter out people.

pageTokenstring nullable

Pagination token from a previous response. Pass the value of nextPageToken from the prior response.

getDetailedEducationboolean nullable

Whether to include deep details about each educational item, like the school's LinkedIn URL, website, location, etc. That'll be put in the detailedEducation array. This slows down the API call, so only enable this if you need it. Only applies when the result type is people; ignored for company results.

getDetailedWorkExperienceboolean nullable

Whether to include deep details about each work experience item, like the company's LinkedIn URL, website, location, etc. That'll be put in the detailedWorkExperience array. This slows down the API call, so only enable this if you need it. Only applies when the result type is people; ignored for company results.

Response

Default Response

advicestring[] nullable

Tips, recommendations, and suggestions for using this API effectively.

Changes

Changed in 4 of the 10 revisions of this API.47

  • 87ad9a3ecc4c11See the full diff
    • ▲

      added subschema #1 subschema #2 to the output/parsedParams response property oneOf list for the response status 200

      response-property-one-of-added

    • ○

      removed subschema #1 subschema #2 from the output/parsedParams response property oneOf list for the response status 200

      response-property-one-of-removed

  • 0c537984b99f1See the full diff
    • ○

      added the optional property output/parsedParams/oneOf[subschema #1]/profileSearchParams/everWorkedAt to the response with the 200 status

      response-optional-property-added

  • 4002aa81d4fb21See the full diff
    • ▲

      the response property advice became nullable for the status 200

      response-property-became-nullable

    • ▲

      the response property advice became optional for the status 200

      response-property-became-optional

    • ○

      the advice response's property default value was removed for the status 200

      response-property-default-value-removed

  • fda5277ff34f14See the full diff
    • ▲

      added subschema #1 subschema #2 to the output/parsedParams response property oneOf list for the response status 200

      response-property-one-of-added

    • ○

      added the optional property output/results/oneOf[subschema #2]/people/items/emails to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property output/results/oneOf[subschema #2]/people/items/last_updated_at to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property output/results/oneOf[subschema #2]/people/items/phoneNumbers to the response with the 200 status

      response-optional-property-added

    • ○

      removed subschema #1 subschema #2 from the output/parsedParams response property oneOf list for the response status 200

      response-property-one-of-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog