---
title: "Natural language search"
method: POST
path: "/v1/nlp-search/run"
tags: ["Agentic search"]
---
# Natural language search
`POST /v1/nlp-search/run`
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.
⚡ Rate limit: 120 requests per 1 minute
💰 Cost: Fixed costs per request (first page only):
• 2 credits for AI search interpretation
Variable costs per result:
• 1 credits per company returned
• 1 credits per profile returned ⓘ
⏱ Recommended timeout: 1 minute ⓘ
## Request body
- object
- `apiKey` string, required — Your Fiber API key
- `query` string, nullable — Natural language search query. Required on the first request. Ignored when pageToken is provided.
- `pageSize` integer — Number of results per page (1-1000). Applied to whichever result type is returned.
- `companyExclusionListIDs` string[], nullable — IDs of exclusion lists to filter out companies. Applied when returning companies, or to narrow company-based profile filtering.
- `peopleExclusionListIDs` string[], nullable — IDs of exclusion lists to filter out people.
- `pageToken` string, nullable — Pagination token from a previous response. Pass the value of nextPageToken from the prior response.
- `getDetailedEducation` boolean, 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.
- `getDetailedWorkExperience` boolean, 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 `200`
Default Response
- object
- `output` object, required
- `searchId` string, required — Unique identifier for this search session. Stable across paginated requests — all pages share the same searchId.
- `parsedParams` union — Structured search parameters generated from the query. Shows how the natural language was interpreted.
- object
- `queryType` 'structuredSearch', required
- `companySearchParams` object, nullable — Parsed company search filters. Null if query only targets people.
- `exactCompanyV2` object, nullable
- `anyOf` union[], nullable
- …
- `noneOf` union[], nullable
- …
- `domains` string[], nullable
- `headquartersCountryCode` object, nullable
- `anyOf` string[], nullable
- `noneOf` string[], nullable
- `headquartersStateName` object, nullable
- `anyOf` string[], nullable
- `noneOf` string[], nullable
- `employeeCountV2` object, nullable
- `lowerBoundExclusive` integer, nullable
- `upperBoundInclusive` integer, nullable
- `keywords` object, nullable
- `containsAll` string[], nullable
- `containsAny` string[], nullable
- `containsNone` string[], nullable
- `industriesV2` object, nullable
- `anyOf` string[], nullable
- `noneOf` string[], nullable
- `allOf` string[], nullable
- `stage` object, nullable
- `anyOf` string[], nullable
- `noneOf` string[], nullable
- `totalFundingUSD` object, nullable
- `lowerBound` number, nullable
- `upperBound` number, nullable
- `lastFundingUSD` object, nullable
- `lowerBound` number, nullable
- `upperBound` number, nullable
- `lastFundedOn` union
- object
- …
- object
- …
- `foundedOn` union
- object
- …
- object
- …
- `nameLike` object, nullable
- `anyOf` string[], nullable
- `noneOf` string[], nullable
- `exactCompany` object, nullable
- `anyOf` object[], nullable
- …
- `noneOf` object[], nullable
- …
- `acceleratorsV2` object, nullable
- `anyOf` object[], nullable
- …
- `noneOf` object[], nullable
- …
- `headquartersLocation` object, nullable
- `unionAll` union[], nullable
- …
- `subtractAll` union[], nullable
- …
- `linkedinSlugs` string[], nullable
- `specialFlags` object, nullable
- `excludeYcCompanies` boolean, nullable
- `employees` object, nullable
- `rules` object[], required
- …
- `joiner` 'AND' | 'OR', required
- `naicsCodes` object, nullable
- `anyOf` object[], nullable
- …
- `allOf` object[], nullable
- …
- `noneOf` object[], nullable
- …
- `fortuneRankings` object, nullable
- `anyOf` object[], nullable
- …
- `jobPostingsV2` object, nullable
- `anyOf` object[], nullable
- …
- `allOf` object[], nullable
- …
- `noneOf` object[], nullable
- …
- `jobPostingStats` object, nullable
- `anyOf` union[], nullable
- …
- `allOf` union[], nullable
- …
- `noneOf` union[], nullable
- …
- `officeLocationsV2` object, nullable
- `anyOf` union[], nullable
- …
- `allOf` union[], nullable
- …
- `noneOf` union[], nullable
- …
- `tlds` object, nullable
- `anyOf` string[], nullable
- `noneOf` string[], nullable
- `numWordsInName` object, nullable
- `lowerBound` integer, nullable
- `upperBound` integer, nullable
- `status` object, nullable
- `anyOf` string[], nullable
- `noneOf` string[], nullable
- `technologies` object, nullable
- `anyOf` union[], nullable
- …
- `allOf` union[], nullable
- …
- `noneOf` union[], nullable
- …
- `crunchbaseCategories` object, nullable
- `anyOf` object[], nullable
- …
- `allOf` object[], nullable
- …
- `noneOf` object[], nullable
- …
- `crunchbaseCategoryGroups` object, nullable
- `anyOf` object[], nullable
- …
- `allOf` object[], nullable
- …
- `noneOf` object[], nullable
- …
- `crunchbaseSlugs` string[], nullable
- `investorsV2` object, nullable
- `anyOf` object[], nullable
- …
- `allOf` object[], nullable
- …
- `noneOf` object[], nullable
- …
- `technologiesV2` object, nullable
- `anyOf` string[], nullable
- `allOf` string[], nullable
- `noneOf` string[], nullable
- `revenueRangeUSD` object, nullable
- `lowerBound` integer, nullable
- `upperBound` integer, nullable
- `employeeTrendsV2` object, nullable
- `obeysAll` union[], nullable
- …
- `obeysAny` union[], nullable
- …
- `obeysNone` union[], nullable
- …
- `tags` object, nullable
- `anyOf` string[], nullable
- `allOf` string[], nullable
- `noneOf` string[], nullable
- `linkedinIndustries` object, nullable
- `anyOf` string[], nullable
- `noneOf` string[], nullable
- `sort` object[], nullable — Sort order for company results. Clauses are applied in order. Omit to use the default ranking. Note: changing the sort invalidates any existing cursor — start a new pagination run when the sort changes.
- `field` 'totalFunding' | 'lastRoundFunding' | 'lastFundedAt' | 'foundedAt' | 'followerCount' | 'jobPostingCount' | 'employeeCount' | 'revenueEstimate', required
- `direction` 'asc' | 'desc', required
- `profileSearchParams` object, nullable — Parsed people search filters. Null if query only targets companies.
- `country3LetterCode` object, nullable
- `anyOf` string[], nullable
- `noneOf` string[], nullable
- `numConnections` object, nullable
- `lowerBound` number, nullable
- `upperBound` number, nullable
- `numFollowers` object, nullable
- `lowerBound` number, nullable
- `upperBound` number, nullable
- `approxAge` object, nullable
- `lowerBound` number, nullable
- `upperBound` number, nullable
- `keywords` object, nullable
- `containsAll` string[], nullable
- `containsAny` string[], nullable
- `containsNone` string[], nullable
- `keywordsV2` object, nullable
- `operator` 'AND' | 'OR', required
- `clauses` object[], required
- …
- `options` object, nullable
- …
- `keywordSearchOptions` object, nullable
- `fieldsToSearchOver` object, nullable
- …
- `jobTitleV2` object, nullable
- `anyOf` union[], nullable
- …
- `noneOf` union[], nullable
- …
- `allOf` union[], nullable
- …
- `exactProfile` object, nullable
- `anyOf` object[], nullable
- …
- `noneOf` object[], nullable
- …
- `exactProfileV2` object, nullable
- `anyOf` union[], nullable
- …
- `noneOf` union[], nullable
- …
- `startedInRole` union
- object
- …
- object
- …
- `startedAtCompany` union
- object
- …
- object
- …
- `location` object, nullable
- `unionAll` union[], nullable
- …
- `subtractAll` union[], nullable
- …
- `languages` object, nullable
- `anyOf` string[], nullable
- `allOf` string[], nullable
- `noneOf` string[], nullable
- `leftStealthAt` union
- object
- …
- object
- …
- `isInStealth` boolean, nullable
- `stealthV2` union
- object
- …
- object
- …
- `educationV2` object, nullable
- `anyOf` object[], nullable
- …
- `allOf` object[], nullable
- …
- `jobStatus` union
- object
- …
- object
- …
- object
- …
- `timeZone` object, nullable
- `anyOf` object[], required
- …
- `pastJobText` object, nullable
- `joiner` 'and' | 'or', required
- `criteria` object[], required
- …
- `fuzzyName` object, nullable
- `anyOf` object[], required
- …
- `companyMatchMode` union
- object
- …
- object
- …
- `yearsOfExperience` object, nullable
- `lowerBound` number, nullable
- `upperBound` number, nullable
- `jobTitleV3` object, nullable
- `anyOf` union[], nullable
- …
- `allOf` union[], nullable
- …
- `noneOf` union[], nullable
- …
- `openToWork` boolean, nullable
- `isHiring` boolean, nullable
- `hasProfilePicture` boolean, nullable
- `state` object, nullable
- `anyOf` object[], nullable
- …
- `noneOf` object[], nullable
- …
- `certifications` object, nullable
- `anyOf` object[], nullable
- …
- `allOf` object[], nullable
- …
- `publications` object, nullable
- `anyOf` object[], nullable
- …
- `allOf` object[], nullable
- …
- `hasNoEducation` boolean, nullable
- `employmentType` object, nullable
- `anyOf` string[], nullable
- `noneOf` string[], nullable
- `isTopVoice` boolean, nullable
- `hasPremium` boolean, nullable
- `isInfluencer` boolean, nullable
- `industry` object, nullable
- `anyOf` string[], nullable
- `noneOf` string[], nullable
- `isVerified` boolean, nullable
- `joinedLinkedInAt` union
- object
- …
- object
- …
- `unemployment` object, nullable
- `isUnemployed` boolean, required
- `becameUnemployedAt` union
- …
- `getDetailedEducation` boolean, nullable, required — 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.
- `getDetailedWorkExperience` boolean, nullable, required — 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.
- `tags` object, nullable
- `anyOf` string[], nullable
- `allOf` string[], nullable
- `noneOf` string[], nullable
- `education` object, nullable
- `anyOf` object[], nullable
- …
- `allOf` object[], nullable
- …
- `jobs` object, nullable — Filter by work experience: named companies (LinkedIn org ID, URL, slug, or domain), job titles, or both on the same entry, with per-entry tenure. Replaces the deprecated pastJobs and currentJobs fields. Prefer jobs alone during migration — sending jobs together with pastJobs or currentJobs ANDs them as separate query clauses.
- `anyOf` object[], nullable — Match a person who satisfies any of these entries.
- …
- `allOf` object[], nullable — Require every entry to be satisfied by the same person. Each entry can be at a different company and tenure.
- …
- `noneOf` object[], nullable — Exclude any person who satisfies these entries. Naming the same company in both anyOf and noneOf excludes anyone who held the excluded-tenure role there.
- …
- `pastJobs` object, nullable — Deprecated. Use jobs with status: 'past' instead.
- `anyOf` object[], nullable
- …
- `allOf` object[], nullable
- …
- `noneOf` object[], nullable
- …
- `currentJobs` object, nullable — Deprecated. Use jobs with status: 'current' instead.
- `anyOf` object[], nullable
- …
- `allOf` object[], nullable
- …
- `noneOf` object[], nullable
- …
- `sort` object[], nullable — Sort order for people results. Clauses are applied in order. Omit to use the default ranking. Note: changing the sort invalidates any existing cursor — start a new pagination run when the sort changes.
- `field` 'followerCount' | 'connectionCount' | 'careerStartedAt' | 'dataUpdatedAt' | 'currentRoleStartedAt' | 'currentCompanyStartedAt' | 'jobCount', required
- `direction` 'asc' | 'desc', required
- object
- `queryType` 'personLookup', required
- `persons` object[], required — One or more people to look up. Each entry identifies a specific person by name, email, phone number, LinkedIn URL, company, and/or job title.
- `name` string, nullable — Person's full name.
- `email` string, nullable — Email address.
- `phoneNumber` string, nullable — Phone number used to identify the person (reverse lookup), e.g. '+14155551234'. Present when the phone is the locator — not when the user only wants a phone revealed after finding someone by name.
- `linkedinUrl` string, nullable — LinkedIn profile URL.
- `companyName` string, nullable — Company the person works at.
- `jobTitle` string, nullable — Job title.
- `contactDetails` object, nullable — Contact information the user requested for this person (work email, personal email, phone).
- `workEmail` boolean, nullable — Set true when the user wants this person's work email (e.g. 'work email', or generic 'email' for a professional contact).
- `personalEmail` boolean, nullable — Set true when the user explicitly wants a personal email address.
- `phone` boolean, nullable — Set true when the user wants a phone number for this person.
- object
- `queryType` 'companyLookup', required
- `companies` object[], required — One or more companies to look up.
- `name` string, nullable — Company name.
- `domain` string, nullable — Company domain (e.g. 'acme.com').
- `linkedinUrl` string, nullable — Company LinkedIn URL.
- object
- `queryType` 'unprocessable', required
- `nextPageToken` string, nullable — Pass as pageToken in the next request for the next page. Null when there are no more results.
- `unsupportedFilters` string[], nullable — Parts of the query that could not be expressed as structured search filters.
- `autoLoosenings` string[], nullable — Filters that were automatically relaxed to find results when the original query returned 0. Only present on the first page.
- `notices` string[], nullable — Informational notices about search results, e.g. when filters are too strict and produce zero matches.
- `results` union, required — Search results. Discriminated on resultType — either companies or people are returned, never both.
- object
- `resultType` 'companies', required — Indicates company results are returned.
- `companies` object[], required — Company results matching the search criteria.
- `linkedin_id` string, nullable
- `accelerator_statuses` string[], nullable
- `accelerators` object[], nullable
- `id` string, nullable
- `slug` string, nullable
- `tags` string[], nullable
- `year` number, nullable
- `batch` string, nullable
- `founders` object[], nullable
- …
- `description` string, nullable
- `one_liner` string, nullable
- `company_name` string, nullable
- `company_domain` string, nullable
- `accelerator_name` string, nullable
- `accelerator_domain` string, nullable
- `blog_urls` string[], nullable
- `custom_data` object, nullable
- `domains` string[], nullable
- `emails` string[], nullable
- `phone_numbers` string[], nullable
- `employee_count_consensus` object, nullable
- `gte` number, nullable
- `lte` number, nullable
- `facebook_urls` string[], nullable
- `fortune_rankings` object[], nullable
- `list` 'fortune-500-usa', required
- `year` number, required
- `rank` number, required
- `founded_on_consensus` string, nullable
- `github_usernames` string[], nullable
- `instagram_handles` string[], nullable
- `latest_funding_consensus` number, nullable
- `linkedin_slugs` string[], nullable
- `linkedin_primary_slug` string, nullable
- `li_org_id` string, nullable
- `li_category` 'W' | 'S' | 'C' | 'null', nullable
- `li_job_posts_stats` object, nullable
- `total_count` number, required
- `seniority_stats` object, nullable
- …
- `employment_type_stats` object, nullable
- …
- `country_location_stats` object, nullable
- …
- `puree_job_functions_stats` object, nullable
- …
- `standard_industries_stats` object, nullable
- …
- `job_location_type_stats` object, nullable
- …
- `li_description` string, nullable
- `li_follower_count` number, nullable
- `li_headline` string, nullable
- `li_industries` object[], nullable
- `id` string, required
- `name` string, required
- `primary` boolean, nullable
- `li_locations` object[], nullable
- `address` string, nullable
- `is_primary` boolean, nullable
- `location` object, nullable
- …
- `li_specialties` string[], nullable
- `location_consensus` object, nullable
- `street_address` string, nullable
- `neighborhood` string, nullable
- `city` string, nullable
- `state_name` string, nullable
- `state_code` string, nullable
- `county` string, nullable
- `postal_code` string, nullable
- `country_code` string, nullable
- `country_name` string, nullable
- `coordinates` object, nullable
- …
- `timezone` string, nullable
- `full_address` string, nullable
- `formatted_address` string, nullable
- `locations_stats` object, nullable
- `USA` number
- `GBR` number
- `FRA` number
- `IND` number
- `BRA` number
- `DEU` number
- `ESP` number
- `CAN` number
- `AUS` number
- `NLD` number
- `ITA` number
- `ZAF` number
- `BEL` number
- `CHN` number
- `TUR` number
- `MEX` number
- `CHE` number
- `NOR` number
- `ARE` number
- `SWE` number
- `POL` number
- `IDN` number
- `ARG` number
- `PRT` number
- `COL` number
- `CHL` number
- `PAK` number
- `DNK` number
- `JPN` number
- `NGA` number
- `SGP` number
- `PER` number
- `NZL` number
- `AUT` number
- `IRL` number
- `MYS` number
- `BGD` number
- `EGY` number
- `ISR` number
- `SAU` number
- `PHL` number
- `FIN` number
- `IRN` number
- `ROU` number
- `CZE` number
- `GRC` number
- `HKG` number
- `HUN` number
- `KEN` number
- `MAR` number
- `VNM` number
- `RUS` number
- `UKR` number
- `ECU` number
- `THA` number
- `LKA` number
- `KOR` number
- `BGR` number
- `GHA` number
- `SRB` number
- `TWN` number
- `HRV` number
- `LTU` number
- `PRI` number
- `SVK` number
- `TUN` number
- `EST` number
- `VEN` number
- `CRI` number
- `PAN` number
- `URY` number
- `LBN` number
- `LUX` number
- `CYP` number
- `NPL` number
- `JOR` number
- `SVN` number
- `MTQ` number
- `QAT` number
- `GLP` number
- `UGA` number
- `DZA` number
- `GTM` number
- `CMR` number
- `LVA` number
- `DOM` number
- `AZE` number
- `GEO` number
- `SEN` number
- `TZA` number
- `ZWE` number
- `KWT` number
- `MLT` number
- `OMN` number
- `BOL` number
- `SLV` number
- `ARM` number
- `PRY` number
- `IRQ` number
- `KHM` number
- `BIH` number
- `AGO` number
- `BHR` number
- `ALB` number
- `KAZ` number
- `CIV` number
- `ETH` number
- `MUS` number
- `ZMB` number
- `MKD` number
- `COD` number
- `BLR` number
- `MOZ` number
- `REU` number
- `TTO` number
- `GUF` number
- `ISL` number
- `MMR` number
- `HND` number
- `RWA` number
- `MDG` number
- `BEN` number
- `UZB` number
- `NAM` number
- `BWA` number
- `MDA` number
- `JEY` number
- `NIC` number
- `SDN` number
- `JAM` number
- `IMN` number
- `BFA` number
- `MNG` number
- `MNE` number
- `MCO` number
- `TGO` number
- `AFG` number
- `LBY` number
- `XKX` number
- `CYM` number
- `MWI` number
- `SOM` number
- `PNG` number
- `MDV` number
- `MLI` number
- `GIN` number
- `PSE` number
- `GAB` number
- `LIE` number
- `HTI` number
- `SYR` number
- `BRB` number
- `YEM` number
- `GGY` number
- `NCL` number
- `AND` number
- `SUR` number
- `MYT` number
- `KGZ` number
- `BHS` number
- `GIB` number
- `COG` number
- `FJI` number
- `BLM` number
- `CUW` number
- `CUB` number
- `SLE` number
- `BLZ` number
- `NER` number
- `LBR` number
- `VIR` number
- `PYF` number
- `GUM` number
- `MRT` number
- `ABW` number
- `SYC` number
- `GUY` number
- `LSO` number
- `SWZ` number
- `SSD` number
- `LCA` number
- `MAC` number
- `SMR` number
- `LAO` number
- `BRN` number
- `TCD` number
- `BMU` number
- `VGB` number
- `PRK` number
- `BTN` number
- `BDI` number
- `FRO` number
- `TJK` number
- `GMB` number
- `STP` number
- `ANT` number
- `VCT` number
- `DJI` number
- `CPV` number
- `TKM` number
- `ATG` number
- `TCA` number
- `KNA` number
- `GRD` number
- `ASM` number
- `VUT` number
- `GNQ` number
- `GRL` number
- `SXM` number
- `MNP` number
- `COM` number
- `TLS` number
- `SJM` number
- `CAF` number
- `DMA` number
- `MAF` number
- `WSM` number
- `BES` number
- `MHL` number
- `AIA` number
- `TON` number
- `COK` number
- `SLB` number
- `SPM` number
- `GNB` number
- `ATA` number
- `TUV` number
- `ALA` number
- `IOT` number
- `ERI` number
- `PLW` number
- `FSM` number
- `NRU` number
- `PCN` number
- `FLK` number
- `MSR` number
- `VAT` number
- `KIR` number
- `SHN` number
- `NIU` number
- `WLF` number
- `HMD` number
- `CXR` number
- `NFK` number
- `ATF` number
- `CCK` number
- `SGS` number
- `BVT` number
- `UMI` number
- `ESH` number
- `TKL` number
- `X-SOUTH_ASIA` number
- `X-SOUTH_EAST_EUROPE` number
- `X-NORTHERN_AFRICA` number
- `X-PACIFIC` number
- `X-SOUTH_WEST_EUROPE` number
- `X-SOUTHERN_AFRICA` number
- `X-WEST_INDIES` number
- `X-SOUTH_AMERICA` number
- `X-SOUTH_WEST_ASIA` number
- `X-CENTRAL_EUROPE` number
- `X-EASTERN_EUROPE` number
- `X-WESTERN_EUROPE` number
- `X-CENTRAL_AMERICA` number
- `X-WESTERN_AFRICA` number
- `X-SOUTH_ATLANTIC_OCEAN` number
- `X-SOUTH_EAST_ASIA` number
- `X-CENTRAL_AFRICA` number
- `X-NORTH_AMERICA` number
- `X-EAST_ASIA` number
- `X-NORTHERN_EUROPE` number
- `X-EASTERN_AFRICA` number
- `X-SOUTHERN_INDIAN_OCEAN` number
- `X-SOUTHERN_EUROPE` number
- `X-CENTRAL_ASIA` number
- `X-NORTHERN_ASIA` number
- `X-ASIA` number
- `X-EUROPE` number
- `X-AFRICA` number
- `X-OCEANIA` number
- `X-AMERICAS` number
- `X-ANTARCTICA` number
- `X-ATLANTIC_OCEAN` number
- `X-INDIAN_OCEAN` number
- `X-MIDDLE_EAST` number
- `X-MENA` number
- `X-EMEA` number
- `X-EUROPEAN_UNION` number
- `X-EFTA` number
- `X-APAC` number
- `X-LATAM` number
- `X-ANGLOSPHERE` number
- `X-DACH` number
- `X-NORDICS` number
- `X-BENELUX` number
- `X-GCC` number
- `X-BRICS` number
- `X-G20` number
- `X-OECD` number
- `X-SANCTIONED` number
- `market_cap_usd` number, nullable
- `naics_codes` string[], nullable
- `names` string[], nullable
- `preferred_name` string, nullable
- `preferred_name_word_count` integer, nullable
- `revenue_estimate` object, nullable
- `sources` string[], nullable
- `fiscal_year` integer, nullable
- `value_usd` object, required
- …
- `standard_industries` string[], nullable
- `status_consensus` string, nullable
- `stock_info_consensus` object, nullable
- `ticker` string, nullable
- `exchange` string, nullable
- `tags` string[], nullable
- `total_funding_consensus` number, nullable
- `twitter_handles` string[], nullable
- `websites` string[], nullable
- `wellfound_slugs` string[], nullable
- `youtube_urls` string[], nullable
- `role_count_matches` object[], nullable
- `numMatchingEmployees` union, required
- …
- `num_matching_locations` object, nullable
- `num_offices_matched` number, required
- `matched_offices` object[], required
- …
- `linkedin_ids` string[], nullable
- `last_sort_key` string, nullable
- `relevance_score` number, nullable
- `technology_spend_usd` number, nullable
- `historical_headcount` object, nullable
- `latest_snapshot_date` string, date, required
- `snapshots` object[], required
- …
- `growth` object, required
- …
- `cik_numbers` string[], nullable
- `cage_codes` string[], nullable
- `duns_numbers` string[], nullable
- `num_li_locations` number, nullable
- `location_name` string, nullable
- `crunchbase_slug` string, nullable
- `primary_role` string, nullable
- `roles` string[], nullable
- `short_description` string, nullable
- `long_description` string, nullable
- `is_subsidiary` boolean, nullable
- `parent` string, nullable
- `num_funding_rounds` number, nullable
- `funding_rounds` object[], nullable
- `round_type` 'angel' | 'convertible_note' | 'corporate_round' | 'debt_financing' | 'equity_crowdfunding' | 'grant' | 'initial_coin_offering' | 'non_equity_assistance' | 'post_ipo_debt' | 'post_ipo_equity' | 'post_ipo_secondary' | 'pre_seed' | 'private_equity' | 'product_crowdfunding' | 'secondary_market' | 'seed' | 'series_a' | 'series_b' | 'series_c' | 'series_d' | 'series_e' | 'series_f' | 'series_g' | 'series_h' | 'series_i' | 'series_j' | 'series_unknown' | 'undisclosed' | 'null', nullable
- `announced_on_date` string, nullable
- `raised_amount_usd` number, nullable
- `post_money_valuation_usd` number, nullable
- `num_exits` number, nullable
- `investors` object[], nullable
- `logo_url` string, nullable
- `entity_type` string, nullable
- `investor_name` string, nullable
- `linkedin_slug` string, nullable
- `investor_types` string[], nullable
- `acquisitions` object[], nullable
- `price_usd` number, nullable
- `acquiree_name` string, nullable
- `acquisition_date` string, nullable
- `best_funding_round` object, nullable
- `round_type` 'angel' | 'convertible_note' | 'corporate_round' | 'debt_financing' | 'equity_crowdfunding' | 'grant' | 'initial_coin_offering' | 'non_equity_assistance' | 'post_ipo_debt' | 'post_ipo_equity' | 'post_ipo_secondary' | 'pre_seed' | 'private_equity' | 'product_crowdfunding' | 'secondary_market' | 'seed' | 'series_a' | 'series_b' | 'series_c' | 'series_d' | 'series_e' | 'series_f' | 'series_g' | 'series_h' | 'series_i' | 'series_j' | 'series_unknown' | 'undisclosed' | 'null', nullable
- `announced_on_date` string, nullable
- `raised_amount_usd` number, nullable
- `post_money_valuation_usd` number, nullable
- `funding_stage` string, nullable
- `alt_industries` string[], nullable
- `alt_keywords` string[], nullable
- `alt_description` string, nullable
- `employee_trends` object[], nullable
- `functions` '_all_employees' | 'information_technology' | 'administrative' | 'marketing' | 'human_resources' | 'product_management' | 'support' | 'education' | 'operations' | 'finance' | 'media_and_commmunication' | 'business_development' | 'data_science' | 'entrepreneurship' | 'arts_and_design' | 'sales' | 'engineering' | 'consulting' | 'accounting' | 'legal' | 'null', nullable
- `current_count` number, nullable
- `changes` object[], nullable
- …
- `logo_url` string, nullable
- `similar_companies` object[], nullable
- `name` string, nullable
- `industries` string[], nullable
- `employee_count` number, nullable
- `revenue` number, nullable
- `logo_url` string, nullable
- `full_funding_rounds` object[], nullable
- `investors` object[], nullable
- …
- `round_city` string, nullable
- `round_date` string, nullable
- `round_type` string, nullable
- `round_state` string, nullable
- `investor_count` number, nullable
- `round_raised_usd` number, nullable
- `round_country_code` string, nullable
- `round_valuation_usd` number, nullable
- `funding_round_stats` object, nullable
- `round_count` number, nullable
- `total_raised_usd` number, nullable
- `peak_valuation_usd` number, nullable
- `unique_investor_count` number, nullable
- `individual_investor_stats` object[], nullable
- …
- `unique_personal_investor_count` number, nullable
- `unique_organizational_investor_count` number, nullable
- `investment_stats` object, nullable
- `investments_by_stage` object[], nullable
- …
- `lead_investment_rate` number, nullable
- `lead_investment_count` number, nullable
- `total_investment_count` number, nullable
- `last_investment_date` string, nullable
- `is_investor` boolean, nullable
- `investor_type` string, nullable
- `investor_categories` string[], nullable
- `technologies_used` object[], nullable
- `name` string, required
- `platforms` object, nullable
- `ecommerce` string[], nullable
- `cms` string[], nullable
- `crm` string[], nullable
- `marketing` string[], nullable
- `payment` string[], nullable
- object
- `resultType` 'people', required — Indicates people results are returned.
- `people` object[], required — People results matching the search criteria.
- `articles` object[], nullable
- `id` string, nullable
- `title` string, nullable
- `date_published` string, nullable
- `certifications` object[], nullable
- `title` string, nullable
- `credential_id` string, nullable
- `verify_url` string, nullable
- `summary` string, nullable
- `linkedin_company_id` string, nullable
- `company_name` string, nullable
- `date` string, nullable
- `connection_count` number, nullable
- `courses` object[], nullable
- `title` string, nullable
- `course_number` string, nullable
- `association` unknown
- `dob` string, nullable
- `education` object[], nullable
- `school_id` string, nullable
- `school_name` string, nullable
- `field_of_study_id` string, nullable
- `field_of_study_name` string, nullable
- `degree` string, nullable
- `grade` string, nullable
- `start_date` string, nullable
- `end_date` string, nullable
- `activities` string, nullable
- `notes` string, nullable
- `experiences` object[], nullable
- `linkedin_company_id` string, nullable
- `is_current` boolean, nullable
- `company_name` string, nullable
- `locality` string, nullable
- `start_date` string, nullable
- `end_date` string, nullable
- `summary` string, nullable
- `title` string, nullable
- `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
- `job_function` string[], nullable
- `employment_type` string[], nullable
- `academic_qualification` string[], nullable
- `company_start_date` string, nullable
- `company_end_date` string, nullable
- `first_name` string, nullable
- `follower_count` number, nullable
- `headline` string, nullable
- `industry_name` string, nullable
- `inferred_location` object, nullable
- `street_address` string, nullable
- `neighborhood` string, nullable
- `city` string, nullable
- `state_name` string, nullable
- `state_code` string, nullable
- `county` string, nullable
- `postal_code` string, nullable
- `country_code` string, nullable
- `country_name` string, nullable
- `coordinates` object, nullable
- …
- `timezone` string, nullable
- `full_address` string, nullable
- `formatted_address` string, nullable
- `interests` string[], nullable
- `last_name` string, nullable
- `locality` string, nullable
- `name` string, nullable
- `patents` object[], nullable
- `id` string, nullable
- `title` string, nullable
- `country` string, nullable
- `number` string, nullable
- `description` string, nullable
- `url` string, nullable
- `date` string, nullable
- `profile_pic` string, nullable
- `projects` object[], nullable
- `project_id` string, nullable
- `project_title` string, nullable
- `project_url` string, nullable
- `project_summary` string, nullable
- `is_current` boolean, nullable
- `start_date` string, nullable
- `end_date` string, nullable
- `publications` object[], nullable
- `collaborators` object[], nullable
- …
- `date` string, nullable
- `id` string, nullable
- `publisher` string, nullable
- `summary` string, nullable
- `title` string, nullable
- `url` string, nullable
- `skills` string[], nullable
- `primary_slug` string, required
- `slugs` string[], nullable
- `summary` string, nullable
- `url` string, nullable
- `user_id` string, nullable
- `volunteering` object[], nullable
- `role` string, nullable
- `is_current` boolean, nullable
- `cause` string, nullable
- `summary` string, nullable
- `linkedin_company_id` string, nullable
- `company_name` string, nullable
- `start_date` string, nullable
- `end_date` string, nullable
- `tenures` object[], nullable
- `linkedin_company_id` string, nullable
- `company_name` string, nullable
- `date_range` object, required
- …
- `range_length_days` number, nullable
- `titles` string[], required
- `localities` string[], required
- `career_began_at` string, nullable
- `tags` string[], nullable
- `entity_urn` string, nullable
- `open_to_work` boolean, nullable
- `premium` boolean, nullable
- `influencer` boolean, nullable
- `organizations` object[], nullable
- `name` string, nullable
- `end_date` string, nullable
- `title` string, nullable
- `start_date` string, nullable
- `entity_urns` string[], nullable
- `is_hiring` boolean, nullable
- `websites` string[], nullable
- `is_verified` boolean, nullable
- `verifications` object, nullable
- `is_verified` boolean, nullable
- `joined_date` string, nullable
- `verification_types` object[], nullable
- …
- `is_top_voice` boolean, nullable
- `current_job` object, nullable
- `linkedin_company_id` string, nullable
- `is_current` boolean, nullable
- `company_name` string, nullable
- `locality` string, nullable
- `start_date` string, nullable
- `end_date` string, nullable
- `summary` string, nullable
- `title` string, nullable
- `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
- `job_function` string[], nullable
- `employment_type` string[], nullable
- `academic_qualification` string[], nullable
- `company_start_date` string, nullable
- `company_end_date` string, nullable
- `custom_data` object, nullable
- `relevance_score` number, nullable
- `last_sort_key` string, nullable
- `last_updated_at` string, nullable
- `languages` object[], nullable
- `name` string, nullable
- `proficiency_id` string, nullable
- `proficiency_name` string, nullable
- `detailed_education` object[], nullable
- `school_details` object, nullable
- …
- `school_id` string, nullable
- `school_name` string, nullable
- `field_of_study_id` string, nullable
- `field_of_study_name` string, nullable
- `degree` string, nullable
- `grade` string, nullable
- `start_date` string, nullable
- `end_date` string, nullable
- `activities` string, nullable
- `notes` string, nullable
- `detailed_work_experiences` object[], nullable
- `company_details` object, nullable
- …
- `crunchbase_slug` string, nullable
- `linkedin_company_id` string, nullable
- `is_current` boolean, nullable
- `company_name` string, nullable
- `locality` string, nullable
- `start_date` string, nullable
- `end_date` string, nullable
- `summary` string, nullable
- `title` string, nullable
- `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
- `job_function` string[], nullable
- `employment_type` string[], nullable
- `academic_qualification` string[], nullable
- `company_start_date` string, nullable
- `company_end_date` string, nullable
- `emails` object[], nullable — Revealed email addresses for this person. Only present when the query requested contact details.
- `email` string, required
- `type` 'work' | 'personal' | 'other' | 'unknown' | 'generic', required
- `status` 'valid' | 'risky' | 'unknown' | 'invalid'
- `phoneNumbers` object[], nullable — Revealed phone numbers for this person. Only present when the query requested contact details.
- `number` string, required
- `type` 'mobile' | 'other' | 'unknown', required
- `chargeInfo` union, required
- object — Credits were charged immediately for this operation
- `method` 'charged-now', required
- `creditsCharged` number, required
- `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
- `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
- `message` string, required — Human-readable credits warning.
- `availableCredits` number, required — Number of credits remaining in the current billing period.
- object — Credits will be charged after the operation completes
- `method` 'charging-later', required
- `message` string, required
- `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
- `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
- `message` string, required — Human-readable credits warning.
- `availableCredits` number, required — Number of credits remaining in the current billing period.
- object — Credits that were charged for an asynchronous operation
- `method` 'charged-for-async-process', required
- `creditsCharged` number, required
- `message` string, required
- `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
- `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
- `message` string, required — Human-readable credits warning.
- `availableCredits` number, required — Number of credits remaining in the current billing period.
- object — No credits were charged for this operation
- `method` 'free', required
- `message` string, required
- `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
- `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
- `message` string, required — Human-readable credits warning.
- `availableCredits` number, required — Number of credits remaining in the current billing period.
- object — Credits were refunded for this operation
- `method` 'credits-refunded', required
- `creditsRefunded` number, required
- `message` string, required
- `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
- `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
- `message` string, required — Human-readable credits warning.
- `availableCredits` number, required — Number of credits remaining in the current billing period.
- `warnings` object[], nullable — Warnings about extraneous fields in request
- `field` string, required — Full path to extraneous field (e.g., 'searchParams.ExtraField')
- `message` string, required — Warning message
- `advice` string[], nullable — Tips, recommendations, and suggestions for using this API effectively.
## Other responses
- `400` — Default Response
- `401` — Default Response
- `402` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `429` — Default Response
- `500` — Default Response
- `503` — Default Response
---
[API](https://skmtc.net/fiber/apis/fiber-ai-api.md) · [All operations](https://skmtc.net/fiber/apis/fiber-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/revisions/720c63a313eb/schema)