v4

latestOpenAPI 3.1.02026-08-012281296.0 MB
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.