---
title: "Create saved search"
method: POST
path: "/v1/saved-search/create"
tags: ["Saved search"]
---

# Create saved search

`POST /v1/saved-search/create`

Create a new saved search. Given search params, it automatically re-runs it periodically and tells you which new people and/or companies fit your parameters over time (and also who drops out or returns). You are charged for each new prospect or company we find, depending on your desired type. You can also manually run the saved search if you don't want to wait for the next auto-run.

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

<span>💰 <strong>Cost:</strong> 2 credits per prospect/company found in search&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Request body

- object
  - `apiKey` string, required — Your Fiber API key
  - `name` string, required — The name of the saved search.
  - `searchParams` union, required
    - object — A combined company and profile search.
      - `type` 'combined', required — The search type: combined companies and profiles.
      - `companySearchParams` object, required — The company search parameters. Uses the same schema as the company search endpoint.
        - `exactCompanyV2` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `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
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `foundedOn` union
          - object
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `nameLike` object, nullable
          - `anyOf` string[], nullable
          - `noneOf` string[], nullable
        - `exactCompany` object, nullable
          - `anyOf` 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
            - `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
        - `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
              - …
            - `years` object, 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
              - …
            - `years` object, nullable
              - …
        - `headquartersLocation` object, nullable
          - `unionAll` union[], nullable
            - union
              - …
          - `subtractAll` union[], nullable
            - union
              - …
        - `linkedinSlugs` string[], nullable
        - `specialFlags` object, nullable
          - `excludeYcCompanies` boolean, nullable
        - `employees` object, nullable
          - `rules` object[], required
            - `employeesToMatch` union, required
              - …
            - `employeeFilters` object, nullable
              - …
            - `jobStatus` union
              - …
          - `joiner` 'AND' | 'OR', required
        - `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
        - `fortuneRankings` object, nullable
          - `anyOf` object[], nullable
            - `list` 'fortune-500-usa', required
            - `range` object, required
              - …
            - `year` number, required
        - `jobPostingsV2` object, nullable
          - `anyOf` object[], nullable
            - `jobPostingStatus` 'active' | 'closed' | 'either' | 'null', nullable
            - `jobTitle` string[], nullable
            - `keywords` string[], nullable
            - `postedAt` union
              - …
            - `numApplicants` object, nullable
              - …
            - `annualPayUSD` object, nullable
              - …
            - `yearsOfExperience` object, nullable
              - …
            - `geoLocation` union
              - …
            - `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
              - …
            - `numApplicants` object, nullable
              - …
            - `annualPayUSD` object, nullable
              - …
            - `yearsOfExperience` object, nullable
              - …
            - `geoLocation` union
              - …
            - `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
              - …
            - `numApplicants` object, nullable
              - …
            - `annualPayUSD` object, nullable
              - …
            - `yearsOfExperience` object, nullable
              - …
            - `geoLocation` union
              - …
            - `countryOrRegionCode` string[], nullable
            - `seniority` string[], nullable
            - `employmentType` string[], nullable
            - `jobFunction` string[], nullable
            - `industry` string[], nullable
            - `jobLocationType` string[], nullable
        - `jobPostingStats` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `allOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `officeLocationsV2` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `allOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `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
            - union
              - …
          - `allOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `crunchbaseCategories` object, nullable
          - `anyOf` object[], nullable
            - `group` string, required
            - `category` string, required
            - `type` 'category', required
          - `allOf` object[], nullable
            - `group` string, required
            - `category` string, required
            - `type` 'category', required
          - `noneOf` object[], nullable
            - `group` string, required
            - `category` string, required
            - `type` 'category', required
        - `crunchbaseCategoryGroups` object, nullable
          - `anyOf` object[], nullable
            - `group` string, required
            - `type` 'group', required
          - `allOf` object[], nullable
            - `group` string, required
            - `type` 'group', required
          - `noneOf` object[], nullable
            - `group` string, required
            - `type` 'group', required
        - `crunchbaseSlugs` string[], nullable
        - `investorsV2` object, nullable
          - `anyOf` object[], nullable
            - `investorIdentifier` union, required
              - …
            - `investedAt` union
              - …
            - `investmentRounds` object, nullable
              - …
          - `allOf` object[], nullable
            - `investorIdentifier` union, required
              - …
            - `investedAt` union
              - …
            - `investmentRounds` object, nullable
              - …
          - `noneOf` object[], nullable
            - `investorIdentifier` union, required
              - …
            - `investedAt` union
              - …
            - `investmentRounds` 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
            - union
              - …
          - `obeysAny` union[], nullable
            - union
              - …
          - `obeysNone` union[], nullable
            - union
              - …
        - `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
      - `maxNewCompaniesPerRun` integer — Maximum number of new companies to charge for per run.
      - `profileSearchParams` object — The profile search parameters. Uses the same schema as the profile search endpoint.
        - `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'
          - `clauses` object[], required
            - `operator` 'AND' | 'OR'
            - `terms` string[], required
            - `negate` boolean
          - `options` object, nullable
            - `fieldsToSearchOver` object, nullable
              - …
        - `keywordSearchOptions` object, nullable
          - `fieldsToSearchOver` object, nullable
            - `summary` boolean
            - `headline` boolean
            - `pastJobTitles` boolean
            - `pastJobSummaries` boolean
            - `pastCompanyNames` boolean
            - `currentJobTitles` boolean
            - `currentJobSummaries` boolean
            - `currentCompanyNames` boolean
            - `interests` boolean
            - `skills` boolean
            - `industry` boolean
            - `education` boolean
            - `publications` boolean
            - `certifications` boolean
            - `articles` boolean
            - `courses` boolean
            - `projects` boolean
            - `patents` boolean
            - `volunteering` boolean
            - `languages` boolean
        - `jobTitleV2` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
          - `allOf` union[], nullable
            - union
              - …
        - `exactProfile` object, nullable
          - `anyOf` object[], nullable
            - `profile_id` string, nullable
            - `primary_slug` string, nullable
          - `noneOf` object[], nullable
            - `profile_id` string, nullable
            - `primary_slug` string, nullable
        - `exactProfileV2` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `startedInRole` union
          - object
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `startedAtCompany` union
          - object
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `location` object, nullable
          - `unionAll` union[], nullable
            - union
              - …
          - `subtractAll` union[], nullable
            - union
              - …
        - `languages` object, nullable
          - `anyOf` string[], nullable
          - `allOf` string[], nullable
          - `noneOf` string[], nullable
        - `leftStealthAt` union
          - object
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `isInStealth` boolean, nullable
        - `stealthV2` union
          - object
            - `status` 'currently-in-stealth', required
            - `enteredStealthAt` union
              - …
          - object
            - `status` 'left-stealth', required
            - `leftStealthAt` union
              - …
            - `enteredStealthAt` union
              - …
            - `stealthDuration` object, nullable
              - …
        - `educationV2` object, nullable
          - `anyOf` object[], nullable
            - `keywords` object, nullable
              - …
            - `degree` union
              - …
            - `fieldOfStudy` object, nullable
              - …
            - `school` object, nullable
              - …
            - `years` object, nullable
              - …
          - `allOf` object[], nullable
            - `keywords` object, nullable
              - …
            - `degree` union
              - …
            - `fieldOfStudy` object, nullable
              - …
            - `school` object, nullable
              - …
            - `years` object, nullable
              - …
        - `jobStatus` union
          - object
            - `status` 'currently-employed', required
          - object
            - `status` 'previously-employed', required
            - `leftAt` union
              - …
          - object
            - `status` 'ever-employed', required
        - `timeZone` object, nullable
          - `anyOf` object[], required
            - `strategy` object, required
              - …
        - `pastJobText` object, nullable
          - `joiner` 'and' | 'or', required
          - `criteria` object[], required
            - `field` 'title' | 'summary' | 'anywhere', required
            - `rule` 'includes' | 'excludes', required
            - `text` string, nullable
        - `fuzzyName` object, nullable
          - `anyOf` object[], required
            - `name` string, required
        - `companyMatchMode` union
          - object
            - `mode` 'strict', required
          - object
            - `mode` 'loose', required
        - `yearsOfExperience` object, nullable
          - `lowerBound` number, nullable
          - `upperBound` number, nullable
        - `jobTitleV3` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `allOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `openToWork` boolean, nullable
        - `isHiring` boolean, nullable
        - `hasProfilePicture` boolean, nullable
        - `state` object, nullable
          - `anyOf` object[], nullable
            - `countryCode` string, nullable
            - `stateName` string, required
          - `noneOf` object[], nullable
            - `countryCode` string, nullable
            - `stateName` string, required
        - `certifications` object, nullable
          - `anyOf` object[], nullable
            - `keywords` object, nullable
              - …
          - `allOf` object[], nullable
            - `keywords` object, nullable
              - …
        - `publications` object, nullable
          - `anyOf` object[], nullable
            - `keywords` object, nullable
              - …
          - `allOf` object[], nullable
            - `keywords` 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
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `unemployment` object, nullable
          - `isUnemployed` boolean, required
          - `becameUnemployedAt` union
            - object
              - …
            - object
              - …
        - `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.
        - `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.
        - `tags` object, nullable
          - `anyOf` string[], nullable
          - `allOf` string[], nullable
          - `noneOf` string[], nullable
        - `education` object, nullable
          - `anyOf` object[], nullable
            - `school` object, nullable
              - …
            - `schoolV2` object, nullable
              - …
            - `keywords` object, nullable
              - …
            - `degree` object, nullable
              - …
            - `degreeV2` union
              - …
            - `schoolNameKeywords` object, nullable
              - …
            - `finishedSchoolAt` union
              - …
            - `startedSchoolAt` union
              - …
            - `isCurrentlyStudent` boolean, nullable
          - `allOf` object[], nullable
            - `school` object, nullable
              - …
            - `schoolV2` object, nullable
              - …
            - `keywords` object, nullable
              - …
            - `degree` object, nullable
              - …
            - `degreeV2` union
              - …
            - `schoolNameKeywords` object, nullable
              - …
            - `finishedSchoolAt` union
              - …
            - `startedSchoolAt` union
              - …
            - `isCurrentlyStudent` boolean, 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.
            - `company` union — Company to match. Identify by LinkedIn org ID, LinkedIn URL, LinkedIn slug, or website domain.
              - …
            - `jobTitle` object, nullable
              - …
            - `status` 'current' | 'past' | 'any', required
          - `allOf` object[], nullable — Require every entry to be satisfied by the same person. Each entry can be at a different company and tenure.
            - `company` union — Company to match. Identify by LinkedIn org ID, LinkedIn URL, LinkedIn slug, or website domain.
              - …
            - `jobTitle` object, nullable
              - …
            - `status` 'current' | 'past' | 'any', required
          - `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.
            - `company` union — Company to match. Identify by LinkedIn org ID, LinkedIn URL, LinkedIn slug, or website domain.
              - …
            - `jobTitle` object, nullable
              - …
            - `status` 'current' | 'past' | 'any', required
        - `pastJobs` object, nullable — Deprecated. Use jobs with status: 'past' instead.
          - `anyOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` object, nullable
              - …
          - `allOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` object, nullable
              - …
          - `noneOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` object, nullable
              - …
        - `currentJobs` object, nullable — Deprecated. Use jobs with status: 'current' instead.
          - `anyOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` object, nullable
              - …
          - `allOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` object, nullable
              - …
          - `noneOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` 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
      - `maxNewProfilesPerRun` integer — Maximum number of new profiles to charge for per run.
    - object — A company-only search.
      - `type` 'companies', required — The search type: companies only.
      - `companySearchParams` object, required — The company search parameters. Uses the same schema as the company search endpoint.
        - `exactCompanyV2` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `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
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `foundedOn` union
          - object
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `nameLike` object, nullable
          - `anyOf` string[], nullable
          - `noneOf` string[], nullable
        - `exactCompany` object, nullable
          - `anyOf` 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
            - `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
        - `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
              - …
            - `years` object, 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
              - …
            - `years` object, nullable
              - …
        - `headquartersLocation` object, nullable
          - `unionAll` union[], nullable
            - union
              - …
          - `subtractAll` union[], nullable
            - union
              - …
        - `linkedinSlugs` string[], nullable
        - `specialFlags` object, nullable
          - `excludeYcCompanies` boolean, nullable
        - `employees` object, nullable
          - `rules` object[], required
            - `employeesToMatch` union, required
              - …
            - `employeeFilters` object, nullable
              - …
            - `jobStatus` union
              - …
          - `joiner` 'AND' | 'OR', required
        - `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
        - `fortuneRankings` object, nullable
          - `anyOf` object[], nullable
            - `list` 'fortune-500-usa', required
            - `range` object, required
              - …
            - `year` number, required
        - `jobPostingsV2` object, nullable
          - `anyOf` object[], nullable
            - `jobPostingStatus` 'active' | 'closed' | 'either' | 'null', nullable
            - `jobTitle` string[], nullable
            - `keywords` string[], nullable
            - `postedAt` union
              - …
            - `numApplicants` object, nullable
              - …
            - `annualPayUSD` object, nullable
              - …
            - `yearsOfExperience` object, nullable
              - …
            - `geoLocation` union
              - …
            - `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
              - …
            - `numApplicants` object, nullable
              - …
            - `annualPayUSD` object, nullable
              - …
            - `yearsOfExperience` object, nullable
              - …
            - `geoLocation` union
              - …
            - `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
              - …
            - `numApplicants` object, nullable
              - …
            - `annualPayUSD` object, nullable
              - …
            - `yearsOfExperience` object, nullable
              - …
            - `geoLocation` union
              - …
            - `countryOrRegionCode` string[], nullable
            - `seniority` string[], nullable
            - `employmentType` string[], nullable
            - `jobFunction` string[], nullable
            - `industry` string[], nullable
            - `jobLocationType` string[], nullable
        - `jobPostingStats` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `allOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `officeLocationsV2` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `allOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `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
            - union
              - …
          - `allOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `crunchbaseCategories` object, nullable
          - `anyOf` object[], nullable
            - `group` string, required
            - `category` string, required
            - `type` 'category', required
          - `allOf` object[], nullable
            - `group` string, required
            - `category` string, required
            - `type` 'category', required
          - `noneOf` object[], nullable
            - `group` string, required
            - `category` string, required
            - `type` 'category', required
        - `crunchbaseCategoryGroups` object, nullable
          - `anyOf` object[], nullable
            - `group` string, required
            - `type` 'group', required
          - `allOf` object[], nullable
            - `group` string, required
            - `type` 'group', required
          - `noneOf` object[], nullable
            - `group` string, required
            - `type` 'group', required
        - `crunchbaseSlugs` string[], nullable
        - `investorsV2` object, nullable
          - `anyOf` object[], nullable
            - `investorIdentifier` union, required
              - …
            - `investedAt` union
              - …
            - `investmentRounds` object, nullable
              - …
          - `allOf` object[], nullable
            - `investorIdentifier` union, required
              - …
            - `investedAt` union
              - …
            - `investmentRounds` object, nullable
              - …
          - `noneOf` object[], nullable
            - `investorIdentifier` union, required
              - …
            - `investedAt` union
              - …
            - `investmentRounds` 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
            - union
              - …
          - `obeysAny` union[], nullable
            - union
              - …
          - `obeysNone` union[], nullable
            - union
              - …
        - `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
      - `maxNewCompaniesPerRun` integer — Maximum number of new companies to charge for per run.
    - object — A profile-only search.
      - `type` 'profiles', required — The search type: profiles only.
      - `profileSearchParams` object — The profile search parameters. Uses the same schema as the profile search endpoint.
        - `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'
          - `clauses` object[], required
            - `operator` 'AND' | 'OR'
            - `terms` string[], required
            - `negate` boolean
          - `options` object, nullable
            - `fieldsToSearchOver` object, nullable
              - …
        - `keywordSearchOptions` object, nullable
          - `fieldsToSearchOver` object, nullable
            - `summary` boolean
            - `headline` boolean
            - `pastJobTitles` boolean
            - `pastJobSummaries` boolean
            - `pastCompanyNames` boolean
            - `currentJobTitles` boolean
            - `currentJobSummaries` boolean
            - `currentCompanyNames` boolean
            - `interests` boolean
            - `skills` boolean
            - `industry` boolean
            - `education` boolean
            - `publications` boolean
            - `certifications` boolean
            - `articles` boolean
            - `courses` boolean
            - `projects` boolean
            - `patents` boolean
            - `volunteering` boolean
            - `languages` boolean
        - `jobTitleV2` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
          - `allOf` union[], nullable
            - union
              - …
        - `exactProfile` object, nullable
          - `anyOf` object[], nullable
            - `profile_id` string, nullable
            - `primary_slug` string, nullable
          - `noneOf` object[], nullable
            - `profile_id` string, nullable
            - `primary_slug` string, nullable
        - `exactProfileV2` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `startedInRole` union
          - object
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `startedAtCompany` union
          - object
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `location` object, nullable
          - `unionAll` union[], nullable
            - union
              - …
          - `subtractAll` union[], nullable
            - union
              - …
        - `languages` object, nullable
          - `anyOf` string[], nullable
          - `allOf` string[], nullable
          - `noneOf` string[], nullable
        - `leftStealthAt` union
          - object
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `isInStealth` boolean, nullable
        - `stealthV2` union
          - object
            - `status` 'currently-in-stealth', required
            - `enteredStealthAt` union
              - …
          - object
            - `status` 'left-stealth', required
            - `leftStealthAt` union
              - …
            - `enteredStealthAt` union
              - …
            - `stealthDuration` object, nullable
              - …
        - `educationV2` object, nullable
          - `anyOf` object[], nullable
            - `keywords` object, nullable
              - …
            - `degree` union
              - …
            - `fieldOfStudy` object, nullable
              - …
            - `school` object, nullable
              - …
            - `years` object, nullable
              - …
          - `allOf` object[], nullable
            - `keywords` object, nullable
              - …
            - `degree` union
              - …
            - `fieldOfStudy` object, nullable
              - …
            - `school` object, nullable
              - …
            - `years` object, nullable
              - …
        - `jobStatus` union
          - object
            - `status` 'currently-employed', required
          - object
            - `status` 'previously-employed', required
            - `leftAt` union
              - …
          - object
            - `status` 'ever-employed', required
        - `timeZone` object, nullable
          - `anyOf` object[], required
            - `strategy` object, required
              - …
        - `pastJobText` object, nullable
          - `joiner` 'and' | 'or', required
          - `criteria` object[], required
            - `field` 'title' | 'summary' | 'anywhere', required
            - `rule` 'includes' | 'excludes', required
            - `text` string, nullable
        - `fuzzyName` object, nullable
          - `anyOf` object[], required
            - `name` string, required
        - `companyMatchMode` union
          - object
            - `mode` 'strict', required
          - object
            - `mode` 'loose', required
        - `yearsOfExperience` object, nullable
          - `lowerBound` number, nullable
          - `upperBound` number, nullable
        - `jobTitleV3` object, nullable
          - `anyOf` union[], nullable
            - union
              - …
          - `allOf` union[], nullable
            - union
              - …
          - `noneOf` union[], nullable
            - union
              - …
        - `openToWork` boolean, nullable
        - `isHiring` boolean, nullable
        - `hasProfilePicture` boolean, nullable
        - `state` object, nullable
          - `anyOf` object[], nullable
            - `countryCode` string, nullable
            - `stateName` string, required
          - `noneOf` object[], nullable
            - `countryCode` string, nullable
            - `stateName` string, required
        - `certifications` object, nullable
          - `anyOf` object[], nullable
            - `keywords` object, nullable
              - …
          - `allOf` object[], nullable
            - `keywords` object, nullable
              - …
        - `publications` object, nullable
          - `anyOf` object[], nullable
            - `keywords` object, nullable
              - …
          - `allOf` object[], nullable
            - `keywords` 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
            - `strategy` 'absolute', required
            - `range` object, nullable
              - …
          - object
            - `strategy` 'relative', required
            - `window` union
              - …
        - `unemployment` object, nullable
          - `isUnemployed` boolean, required
          - `becameUnemployedAt` union
            - object
              - …
            - object
              - …
        - `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.
        - `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.
        - `tags` object, nullable
          - `anyOf` string[], nullable
          - `allOf` string[], nullable
          - `noneOf` string[], nullable
        - `education` object, nullable
          - `anyOf` object[], nullable
            - `school` object, nullable
              - …
            - `schoolV2` object, nullable
              - …
            - `keywords` object, nullable
              - …
            - `degree` object, nullable
              - …
            - `degreeV2` union
              - …
            - `schoolNameKeywords` object, nullable
              - …
            - `finishedSchoolAt` union
              - …
            - `startedSchoolAt` union
              - …
            - `isCurrentlyStudent` boolean, nullable
          - `allOf` object[], nullable
            - `school` object, nullable
              - …
            - `schoolV2` object, nullable
              - …
            - `keywords` object, nullable
              - …
            - `degree` object, nullable
              - …
            - `degreeV2` union
              - …
            - `schoolNameKeywords` object, nullable
              - …
            - `finishedSchoolAt` union
              - …
            - `startedSchoolAt` union
              - …
            - `isCurrentlyStudent` boolean, 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.
            - `company` union — Company to match. Identify by LinkedIn org ID, LinkedIn URL, LinkedIn slug, or website domain.
              - …
            - `jobTitle` object, nullable
              - …
            - `status` 'current' | 'past' | 'any', required
          - `allOf` object[], nullable — Require every entry to be satisfied by the same person. Each entry can be at a different company and tenure.
            - `company` union — Company to match. Identify by LinkedIn org ID, LinkedIn URL, LinkedIn slug, or website domain.
              - …
            - `jobTitle` object, nullable
              - …
            - `status` 'current' | 'past' | 'any', required
          - `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.
            - `company` union — Company to match. Identify by LinkedIn org ID, LinkedIn URL, LinkedIn slug, or website domain.
              - …
            - `jobTitle` object, nullable
              - …
            - `status` 'current' | 'past' | 'any', required
        - `pastJobs` object, nullable — Deprecated. Use jobs with status: 'past' instead.
          - `anyOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` object, nullable
              - …
          - `allOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` object, nullable
              - …
          - `noneOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` object, nullable
              - …
        - `currentJobs` object, nullable — Deprecated. Use jobs with status: 'current' instead.
          - `anyOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` object, nullable
              - …
          - `allOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` object, nullable
              - …
          - `noneOf` object[], nullable
            - `jobTitle` string[], nullable
            - `company` 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
      - `maxNewProfilesPerRun` integer — Maximum number of new profiles to charge for per run.
  - `spawnFrequencyDays` integer, required — The frequency of the saved search in days.

## Response `200`

Default Response

- object
  - `output` object, required
    - `id` string, required — The ID of the saved search.
  - `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)