---
title: "Live fetch LinkedIn profile"
method: POST
path: "/v1/linkedin-live-fetch/profile/single"
tags: ["Live fetch"]
---

# Live fetch LinkedIn profile

`POST /v1/linkedin-live-fetch/profile/single`

Returns an enriched profile with details (work experience, education, skills, location, etc.) for a given LinkedIn profile identifier. **Note:** This endpoint does NOT return emails or phone numbers. To retrieve a person's contact details (emails and phone numbers), use the `POST /contact-details/single` endpoint (synchronous, recommended) or the `POST /individual-reveal/start` + `POST /individual-reveal/poll` pair (asynchronous). These can be found under the **Contact details** section.

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

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

<span>⏱ <strong>Recommended timeout:</strong> 30 seconds&nbsp;<span title="Recommended timeout: set your HTTP client timeout to at least 30 seconds for this endpoint.">ⓘ</span></span>

## Request body

- object
  - `apiKey` string, required — Your Fiber API key
  - `identifier` string, required — The profile's LinkedIn slug (e.g. 'williamhgates'), full LinkedIn URL (e.g. 'https://www.linkedin.com/in/williamhgates/'), Sales Navigator URN, or LinkedIn user ID (e.g. '443105112').
  - `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.

## Response `200`

Default Response

- object
  - `output` union, required
    - object — The profile was found and enriched
      - `found` true, required
      - `profile` 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
      - `isCached404` boolean, nullable — True when the profile is not found on LinkedIn but we have cached data in our database.
    - object — The profile was not found on LinkedIn. Check that the URL or identifier is still active.
      - `found` false, required
      - `message` string, required
  - `chargeInfo` union, required
    - object — Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
  - `warnings` object[], nullable — Warnings about extraneous fields in request
    - `field` string, required — Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required — Warning message
  - `advice` string[], nullable — Tips, recommendations, and suggestions for using this API effectively.

## Other responses

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

---

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