--- title: "Converts text to companies and prospects search params" method: POST path: "/v1/natural-language-search/combined-search-param" tags: ["Agentic search"] --- # Converts text to companies and prospects search params `POST /v1/natural-language-search/combined-search-param` Takes free-form text (e.g., 'Senior Product Managers from Series A to C FinTech startups in New York') and produces standardized filters (industries, funding stages, headcount ranges, locations, titles, seniorities, etc.). When limits are provided, executes the search and returns matching companies and people in a single synchronous call. When referencing specific companies, provide the identifier in one of these forms: plain name (e.g. 'Apple'), domain (e.g. 'apple.com'), or LinkedIn slug (e.g. 'company/banco-santander').Note: This is not optimized for job descriptions. If you have a JD, use the Search profiles from a job description endpoint instead. ⚑ Rate limit: 120 requests per 1 minute πŸ’° Cost: Fixed costs per request:
β€’ 2 credits for company search params generation based on prompt, if required
β€’ 2 credits for profile search params generation based on prompt, if required β“˜ ## Request body - object - `apiKey` string, required β€” Your Fiber API key - `query` string, required β€” Describe what you’re looking for β€” for example: I want Senior Product Managers from Series A to C FinTech startups located in New York. ## Response `200` Default Response - object - `output` object, required - `companySearchParams` object, nullable, required - `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 - `strategy` 'absolute', required - `range` object, nullable - `lowerBound` string, nullable - `upperBound` string, nullable - object - `strategy` 'relative', required - `window` union - object - … - object - … - object - … - `foundedOn` union - object - `strategy` 'absolute', required - `range` object, nullable - `lowerBound` string, nullable - `upperBound` string, nullable - object - `strategy` 'relative', required - `window` union - object - … - object - … - object - … - `nameLike` object, nullable - `anyOf` string[], nullable - `noneOf` string[], nullable - `acceleratorsV2` object, nullable - `anyOf` object[], nullable - `acceleratorName` 'a16z_speedrun' | 'accel_atoms' | 'ai2_incubator' | 'alchemist_accelerator' | 'alliance' | 'antler' | 'berkeley_skydeck' | 'founders_inc' | 'google_startups' | 'launch_accelerator' | 'neo' | 'pear_x' | 'plug_and_play' | 'sosv' | 'south_park_commons' | 'startx' | 'techstars' | 'the_mint' | 'ycombinator', required - `batchSelection` union - object - … - object - … - `years` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `noneOf` object[], nullable - `acceleratorName` 'a16z_speedrun' | 'accel_atoms' | 'ai2_incubator' | 'alchemist_accelerator' | 'alliance' | 'antler' | 'berkeley_skydeck' | 'founders_inc' | 'google_startups' | 'launch_accelerator' | 'neo' | 'pear_x' | 'plug_and_play' | 'sosv' | 'south_park_commons' | 'startx' | 'techstars' | 'the_mint' | 'ycombinator', required - `batchSelection` union - object - … - object - … - `years` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `headquartersLocation` object, nullable - `unionAll` union[], nullable - union - object - … - object - … - object - … - object - … - `subtractAll` union[], nullable - union - object - … - object - … - object - … - object - … - `jobPostingsV2` object, nullable - `anyOf` object[], nullable - `jobPostingStatus` 'active' | 'closed' | 'either' | 'null', nullable - `jobTitle` string[], nullable - `keywords` string[], nullable - `postedAt` union - object - … - object - … - `numApplicants` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `annualPayUSD` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `yearsOfExperience` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `geoLocation` union - object - … - object - … - object - … - object - … - `countryOrRegionCode` string[], nullable - `seniority` string[], nullable - `employmentType` string[], nullable - `jobFunction` string[], nullable - `industry` string[], nullable - `jobLocationType` string[], nullable - `allOf` object[], nullable - `jobPostingStatus` 'active' | 'closed' | 'either' | 'null', nullable - `jobTitle` string[], nullable - `keywords` string[], nullable - `postedAt` union - object - … - object - … - `numApplicants` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `annualPayUSD` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `yearsOfExperience` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `geoLocation` union - object - … - object - … - object - … - object - … - `countryOrRegionCode` string[], nullable - `seniority` string[], nullable - `employmentType` string[], nullable - `jobFunction` string[], nullable - `industry` string[], nullable - `jobLocationType` string[], nullable - `noneOf` object[], nullable - `jobPostingStatus` 'active' | 'closed' | 'either' | 'null', nullable - `jobTitle` string[], nullable - `keywords` string[], nullable - `postedAt` union - object - … - object - … - `numApplicants` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `annualPayUSD` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `yearsOfExperience` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `geoLocation` union - object - … - object - … - object - … - object - … - `countryOrRegionCode` string[], nullable - `seniority` string[], nullable - `employmentType` string[], nullable - `jobFunction` string[], nullable - `industry` string[], nullable - `jobLocationType` string[], nullable - `tags` object, nullable - `anyOf` object[], nullable - `slug` 'raised-from-top-vc' | 'is-government' | 'is-school' | 'venture-backed-startup', required - `name` string, required - `description` string, nullable - `emoji` string, required - `allOf` object[], nullable - `slug` 'raised-from-top-vc' | 'is-government' | 'is-school' | 'venture-backed-startup', required - `name` string, required - `description` string, nullable - `emoji` string, required - `noneOf` object[], nullable - `slug` 'raised-from-top-vc' | 'is-government' | 'is-school' | 'venture-backed-startup', required - `name` string, required - `description` string, nullable - `emoji` string, required - `officeLocationsV2` object, nullable - `anyOf` union[], nullable - union - object - … - object - … - object - … - `allOf` union[], nullable - union - object - … - object - … - object - … - `noneOf` union[], nullable - union - object - … - object - … - object - … - `naicsCodes` object, nullable - `anyOf` object[], nullable - `code` string, required - `title` string, required - `allOf` object[], nullable - `code` string, required - `title` string, required - `noneOf` object[], nullable - `code` string, required - `title` string, required - `technologies` object, nullable - `anyOf` union[], nullable - union - object - … - object - … - `allOf` union[], nullable - union - object - … - object - … - `noneOf` union[], nullable - union - object - … - object - … - `exactCompanyV2` object, nullable - `anyOf` union[], nullable - union - object - … - object - … - object - … - object - … - `noneOf` union[], nullable - union - object - … - object - … - object - … - object - … - `liIndustries` object, nullable - `anyOf` string[], nullable - `noneOf` string[], nullable - `investorsV2` object, nullable - `anyOf` object[], nullable - `investorIdentifier` union, required - object - … - object - … - object - … - object - … - `investedAt` union - object - … - object - … - `investmentRounds` object, nullable - `anyOf` string[], required - `allOf` object[], nullable - `investorIdentifier` union, required - object - … - object - … - object - … - object - … - `investedAt` union - object - … - object - … - `investmentRounds` object, nullable - `anyOf` string[], required - `noneOf` object[], nullable - `investorIdentifier` union, required - object - … - object - … - object - … - object - … - `investedAt` union - object - … - object - … - `investmentRounds` object, nullable - `anyOf` string[], required - `fortuneRankings` object, nullable - `anyOf` object[], nullable - `list` 'fortune-500-usa', required - `range` object, required - `low` number, required - `high` number, required - `name` string, nullable - `year` number, required - `revenueRangeUSD` object, nullable - `lowerBound` integer, nullable - `upperBound` integer, nullable - `profileSearchParams` object, nullable, required - `jobTitleV3` object, nullable - `anyOf` union[], nullable - union - object - … - object - … - object - … - `allOf` union[], nullable - union - object - … - object - … - object - … - `noneOf` union[], nullable - union - object - … - object - … - object - … - `jobStatus` union - object - `status` 'currently-employed', required - object - `status` 'previously-employed', required - `leftAt` union - object - … - object - … - object - `status` 'ever-employed', required - `approxAge` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `startedInRole` union - object - `strategy` 'absolute', required - `range` object, nullable - `lowerBound` string, nullable - `upperBound` string, nullable - object - `strategy` 'relative', required - `window` union - object - … - object - … - object - … - `startedAtCompany` union - object - `strategy` 'absolute', required - `range` object, nullable - `lowerBound` string, nullable - `upperBound` string, nullable - object - `strategy` 'relative', required - `window` union - object - … - object - … - object - … - `yearsOfExperience` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `keywords` object, nullable - `containsAll` string[], nullable - `containsAny` string[], nullable - `containsNone` string[], nullable - `keywordSearchOptions` object, nullable - `fieldsToSearchOver` object, nullable - `summary` boolean, required - `headline` boolean, required - `pastJobTitles` boolean, required - `pastJobSummaries` boolean, required - `pastCompanyNames` boolean, required - `currentJobTitles` boolean, required - `currentJobSummaries` boolean, required - `currentCompanyNames` boolean, required - `interests` boolean, required - `skills` boolean, required - `industry` boolean, required - `education` boolean, required - `publications` boolean, required - `certifications` boolean, required - `articles` boolean, required - `courses` boolean, required - `projects` boolean, required - `patents` boolean, required - `volunteering` boolean, required - `languages` boolean, required - `fuzzyName` object, nullable - `anyOf` object[], required - `name` string, required - `tags` object, nullable - `anyOf` object[], nullable - `slug` 'student' | 'attended-top-us-university' | 'attended-top-global-university' | 'second-time-founder' | 'deep-technical-background' | 'major-tech-company-experience' | 'fortune-500-executive' | 'recently-changed-companies' | 'recently-promoted' | 'decision-maker' | 'c-suite' | 'experienced-executive' | 'phd' | 'influencer' | 'board-member', required - `name` string, required - `description` string, nullable - `emoji` string, required - `allOf` object[], nullable - `slug` 'student' | 'attended-top-us-university' | 'attended-top-global-university' | 'second-time-founder' | 'deep-technical-background' | 'major-tech-company-experience' | 'fortune-500-executive' | 'recently-changed-companies' | 'recently-promoted' | 'decision-maker' | 'c-suite' | 'experienced-executive' | 'phd' | 'influencer' | 'board-member', required - `name` string, required - `description` string, nullable - `emoji` string, required - `noneOf` object[], nullable - `slug` 'student' | 'attended-top-us-university' | 'attended-top-global-university' | 'second-time-founder' | 'deep-technical-background' | 'major-tech-company-experience' | 'fortune-500-executive' | 'recently-changed-companies' | 'recently-promoted' | 'decision-maker' | 'c-suite' | 'experienced-executive' | 'phd' | 'influencer' | 'board-member', required - `name` string, required - `description` string, nullable - `emoji` string, required - `stealthV2` union - object - `status` 'currently-in-stealth', required - `enteredStealthAt` union - object - … - object - … - object - `status` 'left-stealth', required - `leftStealthAt` union - object - … - object - … - `enteredStealthAt` union - object - … - object - … - `stealthDuration` object, nullable - `range` object, required - … - `period` 'day' | 'week' | 'month' | 'quarter' | 'year', required - `country3LetterCode` object, nullable - `anyOf` string[], nullable - `noneOf` string[], nullable - `location` object, nullable - `unionAll` union[], nullable - union - object - … - object - … - object - … - object - … - `subtractAll` union[], nullable - union - object - … - object - … - object - … - object - … - `timeZone` object, nullable - `anyOf` object[], required - `strategy` object, required - `mode` 'midpoint-with-buffer', required - `midpointTimeZoneName` string, required - `maxMinutesWestward` integer, required - `maxMinutesEastward` number, required - `includePartialYearMatches` boolean, required - `education` object, nullable - `anyOf` object[], nullable - `keywords` object, nullable - `anyOf` string[], nullable - `noneOf` string[], nullable - `degree` string[], nullable - `degreeV2` object, nullable - `anyOf` string[], nullable - `noneOf` string[], nullable - `schoolName` string[], nullable - `schoolNameV2` object, nullable - `anyOf` string[], nullable - `noneOf` string[], nullable - `schoolV3` object, nullable - `anyOf` object[], nullable - … - `noneOf` object[], nullable - … - `schoolV4` object, nullable - `anyOf` union[], nullable - … - `noneOf` union[], nullable - … - `schoolNameKeywords` object, nullable - `anyOf` string[], nullable - `noneOf` string[], nullable - `degreeV3` union - object - … - object - … - `finishedSchoolAt` union - object - … - object - … - `startedSchoolAt` union - object - … - object - … - `isCurrentlyStudent` boolean, nullable - `allOf` object[], nullable - `keywords` object, nullable - `anyOf` string[], nullable - `noneOf` string[], nullable - `degree` string[], nullable - `degreeV2` object, nullable - `anyOf` string[], nullable - `noneOf` string[], nullable - `schoolName` string[], nullable - `schoolNameV2` object, nullable - `anyOf` string[], nullable - `noneOf` string[], nullable - `schoolV3` object, nullable - `anyOf` object[], nullable - … - `noneOf` object[], nullable - … - `schoolV4` object, nullable - `anyOf` union[], nullable - … - `noneOf` union[], nullable - … - `schoolNameKeywords` object, nullable - `anyOf` string[], nullable - `noneOf` string[], nullable - `degreeV3` union - object - … - object - … - `finishedSchoolAt` union - object - … - object - … - `startedSchoolAt` union - object - … - object - … - `isCurrentlyStudent` boolean, nullable - `languages` object, nullable - `anyOf` string[], nullable - `allOf` string[], nullable - `noneOf` string[], nullable - `pastJobs` object, nullable - `anyOf` object[], nullable - `jobTitle` string[], nullable - `company` object, nullable - `linkedin_id` string, nullable - `li_org_id` string, required - `preferred_name` string, nullable - `names` string[], nullable - `linkedin_primary_slug` string, nullable - `domains` string[], nullable - `logo_url` string, nullable - `source` 'csv' | 'null', nullable - `allOf` object[], nullable - `jobTitle` string[], nullable - `company` object, nullable - `linkedin_id` string, nullable - `li_org_id` string, required - `preferred_name` string, nullable - `names` string[], nullable - `linkedin_primary_slug` string, nullable - `domains` string[], nullable - `logo_url` string, nullable - `source` 'csv' | 'null', nullable - `noneOf` object[], nullable - `jobTitle` string[], nullable - `company` object, nullable - `linkedin_id` string, nullable - `li_org_id` string, required - `preferred_name` string, nullable - `names` string[], nullable - `linkedin_primary_slug` string, nullable - `domains` string[], nullable - `logo_url` string, nullable - `source` 'csv' | 'null', nullable - `numConnections` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `numFollowers` object, nullable - `lowerBound` number, nullable - `upperBound` number, nullable - `maxPeoplePerCompany` number, nullable - `state` object, nullable - `anyOf` object[], nullable - `countryCode` string, nullable - `stateName` string, required - `noneOf` object[], nullable - `countryCode` string, nullable - `stateName` string, required - `keywordsV2` object, nullable - `operator` 'AND' | 'OR', required - `clauses` object[], required - `operator` 'AND' | 'OR', required - `terms` string[], required - `negate` boolean, required - `options` object, nullable - `fieldsToSearchOver` object, nullable - `summary` boolean, required - `headline` boolean, required - `pastJobTitles` boolean, required - `pastJobSummaries` boolean, required - `pastCompanyNames` boolean, required - `currentJobTitles` boolean, required - `currentJobSummaries` boolean, required - `currentCompanyNames` boolean, required - `interests` boolean, required - `skills` boolean, required - `industry` boolean, required - `education` boolean, required - `publications` boolean, required - `certifications` boolean, required - `articles` boolean, required - `courses` boolean, required - `projects` boolean, required - `patents` boolean, required - `volunteering` boolean, required - `languages` boolean, required - `openToWork` boolean, nullable - `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/versions/693a454797a3/schema)