---
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
              - …
        - `pastJobs` object, nullable
          - `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
          - `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
              - …
        - `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
        - `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
              - …
        - `pastJobs` object, nullable
          - `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
          - `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
              - …
        - `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
        - `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/versions/693a454797a3/schema)