---
title: "Search profiles from a job description"
method: POST
path: "/v1/natural-language-search/job-description-search"
tags: ["Agentic search"]
---

# Search profiles from a job description

`POST /v1/natural-language-search/job-description-search`

Accepts a raw job description and returns a list of matching LinkedIn profiles. Optionally returns detailed work experience and education history. Results are paginated via cursor. Credits are charged per request and per profile returned.

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

<span>💰 <strong>Cost:</strong> 2 credits per request + 1 credit per profile found&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Request body

- object
  - `apiKey` string, required — Your Fiber API key
  - `search` union, required
    - object
      - `request` 'initial', required — Use "initial" for the first page of a new search.
      - `query` string, required
      - `pageSize` integer — The number of profiles to return per page.
      - `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.
    - object
      - `request` 'subsequent', required — Use "subsequent" for page 2 and beyond. Only the cursor from the previous response is required; all other parameters are stored server-side.
      - `cursor` string, required — The `nextCursor` value returned by the previous response. Valid for 3 days.

## Response `200`

Default Response

- object
  - `output` object, required
    - `data` object[], required
      - `articles` object[], nullable
        - `id` string, nullable
        - `title` string, nullable
        - `date_published` string, nullable
      - `certifications` object[], nullable
        - `title` string, nullable
        - `credential_id` string, nullable
        - `verify_url` string, nullable
        - `summary` string, nullable
        - `linkedin_company_id` string, nullable
        - `company_name` string, nullable
        - `date` string, nullable
      - `connection_count` number, nullable
      - `courses` object[], nullable
        - `title` string, nullable
        - `course_number` string, nullable
        - `association` unknown
      - `dob` string, nullable
      - `education` object[], nullable
        - `school_id` string, nullable
        - `school_name` string, nullable
        - `field_of_study_id` string, nullable
        - `field_of_study_name` string, nullable
        - `degree` string, nullable
        - `grade` string, nullable
        - `start_date` string, nullable
        - `end_date` string, nullable
        - `activities` string, nullable
        - `notes` string, nullable
      - `experiences` object[], nullable
        - `linkedin_company_id` string, nullable
        - `is_current` boolean, nullable
        - `company_name` string, nullable
        - `locality` string, nullable
        - `start_date` string, nullable
        - `end_date` string, nullable
        - `summary` string, nullable
        - `title` string, nullable
        - `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
        - `job_function` string[], nullable
        - `employment_type` string[], nullable
        - `academic_qualification` string[], nullable
        - `company_start_date` string, nullable
        - `company_end_date` string, nullable
      - `first_name` string, nullable
      - `follower_count` number, nullable
      - `headline` string, nullable
      - `industry_name` string, nullable
      - `inferred_location` object, nullable
        - `street_address` string, nullable
        - `neighborhood` string, nullable
        - `city` string, nullable
        - `state_name` string, nullable
        - `state_code` string, nullable
        - `county` string, nullable
        - `postal_code` string, nullable
        - `country_code` string, nullable
        - `country_name` string, nullable
        - `coordinates` object, nullable
          - `lat` number, required
          - `lon` number, required
        - `timezone` string, nullable
        - `full_address` string, nullable
        - `formatted_address` string, nullable
      - `interests` string[], nullable
      - `last_name` string, nullable
      - `locality` string, nullable
      - `name` string, nullable
      - `patents` object[], nullable
        - `id` string, nullable
        - `title` string, nullable
        - `country` string, nullable
        - `number` string, nullable
        - `description` string, nullable
        - `url` string, nullable
        - `date` string, nullable
      - `profile_pic` string, nullable
      - `projects` object[], nullable
        - `project_id` string, nullable
        - `project_title` string, nullable
        - `project_url` string, nullable
        - `project_summary` string, nullable
        - `is_current` boolean, nullable
        - `start_date` string, nullable
        - `end_date` string, nullable
      - `publications` object[], nullable
        - `collaborators` object[], nullable
          - `name` string, nullable
          - `url` string, nullable
        - `date` string, nullable
        - `id` string, nullable
        - `publisher` string, nullable
        - `summary` string, nullable
        - `title` string, nullable
        - `url` string, nullable
      - `skills` string[], nullable
      - `primary_slug` string, required
      - `slugs` string[], nullable
      - `summary` string, nullable
      - `url` string, nullable
      - `user_id` string, nullable
      - `volunteering` object[], nullable
        - `role` string, nullable
        - `is_current` boolean, nullable
        - `cause` string, nullable
        - `summary` string, nullable
        - `linkedin_company_id` string, nullable
        - `company_name` string, nullable
        - `start_date` string, nullable
        - `end_date` string, nullable
      - `tenures` object[], nullable
        - `linkedin_company_id` string, nullable
        - `company_name` string, nullable
        - `date_range` object, required
          - `gte` string, nullable
          - `lte` string, nullable
        - `range_length_days` number, nullable
        - `titles` string[], required
        - `localities` string[], required
      - `career_began_at` string, nullable
      - `tags` string[], nullable
      - `entity_urn` string, nullable
      - `open_to_work` boolean, nullable
      - `premium` boolean, nullable
      - `influencer` boolean, nullable
      - `organizations` object[], nullable
        - `name` string, nullable
        - `end_date` string, nullable
        - `title` string, nullable
        - `start_date` string, nullable
      - `entity_urns` string[], nullable
      - `is_hiring` boolean, nullable
      - `websites` string[], nullable
      - `is_verified` boolean, nullable
      - `verifications` object, nullable
        - `is_verified` boolean, nullable
        - `joined_date` string, nullable
        - `verification_types` object[], nullable
          - `title` string, nullable
          - `subtitle` string, nullable
          - `description` string, nullable
      - `is_top_voice` boolean, nullable
      - `current_job` object, nullable
        - `linkedin_company_id` string, nullable
        - `is_current` boolean, nullable
        - `company_name` string, nullable
        - `locality` string, nullable
        - `start_date` string, nullable
        - `end_date` string, nullable
        - `summary` string, nullable
        - `title` string, nullable
        - `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
        - `job_function` string[], nullable
        - `employment_type` string[], nullable
        - `academic_qualification` string[], nullable
        - `company_start_date` string, nullable
        - `company_end_date` string, nullable
      - `custom_data` object, nullable
      - `relevance_score` number, nullable
      - `last_sort_key` string, nullable
      - `last_updated_at` string, nullable
      - `languages` object[], nullable
        - `name` string, nullable
        - `proficiency_id` string, nullable
        - `proficiency_name` string, nullable
      - `detailed_education` object[], nullable
        - `school_details` object, nullable
          - `linkedin_ids` string[], nullable
          - `li_org_id` string, nullable
          - `linkedin_primary_slug` string, nullable
          - `domains` string[], nullable
          - `preferred_name` string, nullable
        - `school_id` string, nullable
        - `school_name` string, nullable
        - `field_of_study_id` string, nullable
        - `field_of_study_name` string, nullable
        - `degree` string, nullable
        - `grade` string, nullable
        - `start_date` string, nullable
        - `end_date` string, nullable
        - `activities` string, nullable
        - `notes` string, nullable
      - `detailed_work_experiences` object[], nullable
        - `company_details` object, nullable
          - `linkedin_ids` string[], nullable
          - `li_org_id` string, nullable
          - `linkedin_primary_slug` string, nullable
          - `domains` string[], nullable
          - `preferred_name` string, nullable
        - `crunchbase_slug` string, nullable
        - `linkedin_company_id` string, nullable
        - `is_current` boolean, nullable
        - `company_name` string, nullable
        - `locality` string, nullable
        - `start_date` string, nullable
        - `end_date` string, nullable
        - `summary` string, nullable
        - `title` string, nullable
        - `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
        - `job_function` string[], nullable
        - `employment_type` string[], nullable
        - `academic_qualification` string[], nullable
        - `company_start_date` string, nullable
        - `company_end_date` string, nullable
    - `nextCursor` string, nullable — The pagination cursor for the next page. Provide this in the next request to continue paginating.
    - `searchParams` object, required
      - `jobTitleV3` object, nullable
        - `anyOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `allOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
        - `noneOf` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
      - `jobStatus` union
        - object
          - `status` 'currently-employed', required
        - object
          - `status` 'previously-employed', required
          - `leftAt` union
            - object
              - …
            - object
              - …
        - object
          - `status` 'ever-employed', required
      - `approxAge` object, nullable
        - `lowerBound` number, nullable
        - `upperBound` number, nullable
      - `startedInRole` union
        - object
          - `strategy` 'absolute', required
          - `range` object, nullable
            - `lowerBound` string, nullable
            - `upperBound` string, nullable
        - object
          - `strategy` 'relative', required
          - `window` union
            - object
              - …
            - object
              - …
            - object
              - …
      - `startedAtCompany` union
        - object
          - `strategy` 'absolute', required
          - `range` object, nullable
            - `lowerBound` string, nullable
            - `upperBound` string, nullable
        - object
          - `strategy` 'relative', required
          - `window` union
            - object
              - …
            - object
              - …
            - object
              - …
      - `yearsOfExperience` object, nullable
        - `lowerBound` number, nullable
        - `upperBound` number, nullable
      - `keywords` object, nullable
        - `containsAll` string[], nullable
        - `containsAny` string[], nullable
        - `containsNone` string[], nullable
      - `keywordSearchOptions` object, nullable
        - `fieldsToSearchOver` object, nullable
          - `summary` boolean, required
          - `headline` boolean, required
          - `pastJobTitles` boolean, required
          - `pastJobSummaries` boolean, required
          - `pastCompanyNames` boolean, required
          - `currentJobTitles` boolean, required
          - `currentJobSummaries` boolean, required
          - `currentCompanyNames` boolean, required
          - `interests` boolean, required
          - `skills` boolean, required
          - `industry` boolean, required
          - `education` boolean, required
          - `publications` boolean, required
          - `certifications` boolean, required
          - `articles` boolean, required
          - `courses` boolean, required
          - `projects` boolean, required
          - `patents` boolean, required
          - `volunteering` boolean, required
          - `languages` boolean, required
      - `fuzzyName` object, nullable
        - `anyOf` object[], required
          - `name` string, required
      - `tags` object, nullable
        - `anyOf` object[], nullable
          - `slug` 'student' | 'attended-top-us-university' | 'attended-top-global-university' | 'second-time-founder' | 'deep-technical-background' | 'major-tech-company-experience' | 'fortune-500-executive' | 'recently-changed-companies' | 'recently-promoted' | 'decision-maker' | 'c-suite' | 'experienced-executive' | 'phd' | 'influencer' | 'board-member', required
          - `name` string, required
          - `description` string, nullable
          - `emoji` string, required
        - `allOf` object[], nullable
          - `slug` 'student' | 'attended-top-us-university' | 'attended-top-global-university' | 'second-time-founder' | 'deep-technical-background' | 'major-tech-company-experience' | 'fortune-500-executive' | 'recently-changed-companies' | 'recently-promoted' | 'decision-maker' | 'c-suite' | 'experienced-executive' | 'phd' | 'influencer' | 'board-member', required
          - `name` string, required
          - `description` string, nullable
          - `emoji` string, required
        - `noneOf` object[], nullable
          - `slug` 'student' | 'attended-top-us-university' | 'attended-top-global-university' | 'second-time-founder' | 'deep-technical-background' | 'major-tech-company-experience' | 'fortune-500-executive' | 'recently-changed-companies' | 'recently-promoted' | 'decision-maker' | 'c-suite' | 'experienced-executive' | 'phd' | 'influencer' | 'board-member', required
          - `name` string, required
          - `description` string, nullable
          - `emoji` string, required
      - `stealthV2` union
        - object
          - `status` 'currently-in-stealth', required
          - `enteredStealthAt` union
            - object
              - …
            - object
              - …
        - object
          - `status` 'left-stealth', required
          - `leftStealthAt` union
            - object
              - …
            - object
              - …
          - `enteredStealthAt` union
            - object
              - …
            - object
              - …
          - `stealthDuration` object, nullable
            - `range` object, required
              - …
            - `period` 'day' | 'week' | 'month' | 'quarter' | 'year', required
      - `country3LetterCode` object, nullable
        - `anyOf` string[], nullable
        - `noneOf` string[], nullable
      - `location` object, nullable
        - `unionAll` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - `subtractAll` union[], nullable
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
      - `timeZone` object, nullable
        - `anyOf` object[], required
          - `strategy` object, required
            - `mode` 'midpoint-with-buffer', required
            - `midpointTimeZoneName` string, required
            - `maxMinutesWestward` integer, required
            - `maxMinutesEastward` number, required
            - `includePartialYearMatches` boolean, required
      - `education` object, nullable
        - `anyOf` object[], nullable
          - `keywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `degree` string[], nullable
          - `degreeV2` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `schoolName` string[], nullable
          - `schoolNameV2` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `schoolV3` object, nullable
            - `anyOf` object[], nullable
              - …
            - `noneOf` object[], nullable
              - …
          - `schoolV4` object, nullable
            - `anyOf` union[], nullable
              - …
            - `noneOf` union[], nullable
              - …
          - `schoolNameKeywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `degreeV3` union
            - object
              - …
            - object
              - …
          - `finishedSchoolAt` union
            - object
              - …
            - object
              - …
          - `startedSchoolAt` union
            - object
              - …
            - object
              - …
          - `isCurrentlyStudent` boolean, nullable
        - `allOf` object[], nullable
          - `keywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `degree` string[], nullable
          - `degreeV2` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `schoolName` string[], nullable
          - `schoolNameV2` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `schoolV3` object, nullable
            - `anyOf` object[], nullable
              - …
            - `noneOf` object[], nullable
              - …
          - `schoolV4` object, nullable
            - `anyOf` union[], nullable
              - …
            - `noneOf` union[], nullable
              - …
          - `schoolNameKeywords` object, nullable
            - `anyOf` string[], nullable
            - `noneOf` string[], nullable
          - `degreeV3` union
            - object
              - …
            - object
              - …
          - `finishedSchoolAt` union
            - object
              - …
            - object
              - …
          - `startedSchoolAt` union
            - object
              - …
            - object
              - …
          - `isCurrentlyStudent` boolean, nullable
      - `languages` object, nullable
        - `anyOf` string[], nullable
        - `allOf` string[], nullable
        - `noneOf` string[], nullable
      - `pastJobs` object, nullable
        - `anyOf` object[], nullable
          - `jobTitle` string[], nullable
          - `company` object, nullable
            - `linkedin_id` string, nullable
            - `li_org_id` string, required
            - `preferred_name` string, nullable
            - `names` string[], nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `logo_url` string, nullable
            - `source` 'csv' | 'null', nullable
        - `allOf` object[], nullable
          - `jobTitle` string[], nullable
          - `company` object, nullable
            - `linkedin_id` string, nullable
            - `li_org_id` string, required
            - `preferred_name` string, nullable
            - `names` string[], nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `logo_url` string, nullable
            - `source` 'csv' | 'null', nullable
        - `noneOf` object[], nullable
          - `jobTitle` string[], nullable
          - `company` object, nullable
            - `linkedin_id` string, nullable
            - `li_org_id` string, required
            - `preferred_name` string, nullable
            - `names` string[], nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `logo_url` string, nullable
            - `source` 'csv' | 'null', nullable
      - `numConnections` object, nullable
        - `lowerBound` number, nullable
        - `upperBound` number, nullable
      - `numFollowers` object, nullable
        - `lowerBound` number, nullable
        - `upperBound` number, nullable
      - `maxPeoplePerCompany` number, nullable
      - `state` object, nullable
        - `anyOf` object[], nullable
          - `countryCode` string, nullable
          - `stateName` string, required
        - `noneOf` object[], nullable
          - `countryCode` string, nullable
          - `stateName` string, required
      - `keywordsV2` object, nullable
        - `operator` 'AND' | 'OR', required
        - `clauses` object[], required
          - `operator` 'AND' | 'OR', required
          - `terms` string[], required
          - `negate` boolean, required
        - `options` object, nullable
          - `fieldsToSearchOver` object, nullable
            - `summary` boolean, required
            - `headline` boolean, required
            - `pastJobTitles` boolean, required
            - `pastJobSummaries` boolean, required
            - `pastCompanyNames` boolean, required
            - `currentJobTitles` boolean, required
            - `currentJobSummaries` boolean, required
            - `currentCompanyNames` boolean, required
            - `interests` boolean, required
            - `skills` boolean, required
            - `industry` boolean, required
            - `education` boolean, required
            - `publications` boolean, required
            - `certifications` boolean, required
            - `articles` boolean, required
            - `courses` boolean, required
            - `projects` boolean, required
            - `patents` boolean, required
            - `volunteering` boolean, required
            - `languages` boolean, required
      - `openToWork` boolean, nullable
  - `chargeInfo` union, required
    - object — Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
  - `warnings` object[], nullable — Warnings about extraneous fields in request
    - `field` string, required — Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required — Warning message
  - `advice` string[], nullable — Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `402` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `429` — Default Response
- `500` — Default Response
- `503` — Default Response

---

[API](https://skmtc.net/fiber/apis/fiber-ai-api.md) · [All operations](https://skmtc.net/fiber/apis/fiber-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/revisions/c4f2d79876be/schema)