# Social Fetch API - LinkedIn endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

13 documented LinkedIn operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/linkedin/profiles
Get LinkedIn profiles
Credit cost: 2 credits per profile URL requested. Up to 50 profiles per request (100 credits max).
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/profiles/get.mdx
SDK: client.linkedin.getProfiles({ urls })
Parameters:
- url (required, array) - LinkedIn profile URL.
curl "https://api.socialfetch.dev/v1/linkedin/profiles?url=https://www.linkedin.com/in/marclouvion" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/profiles/posts
List LinkedIn profile posts
Credit cost: 2 credits attempt fee plus 2 credits per returned record. Up to 200 per request (402 credits max). `limit` defaults to 10.
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/profiles/posts/get.mdx
SDK: client.linkedin.listProfilePosts({ url })
Parameters:
- url (required, string) - LinkedIn profile URL or vanity handle whose public posts should be listed.
- startDate (optional, string) - Optional start of the date range for posts to include.
- endDate (optional, string) - Optional end of the date range for posts to include.
- onlyAuthoredPosts (optional) - When true, return only posts created by the profile owner.
- limit (optional) - Maximum posts to return (default 10).
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/linkedin/profiles/posts?url=https://www.linkedin.com/in/marclouvion" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/people/search
Search LinkedIn people
Credit cost: 2 credits attempt fee plus 2 credits per returned record. Up to 50 per request (102 credits max).
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/people/search/get.mdx
SDK: client.linkedin.searchPeople({ firstName: "James", lastName: "Smith" })
Parameters:
- firstName (optional, string) - First name filter. At least one of `firstName` or `lastName` is required.
- lastName (optional, string) - Last name filter. At least one of `firstName` or `lastName` is required.
Outcome field: `data.lookupStatus` in `found`, `not_found`
Disambiguation: This search usually takes around one and a half minutes to complete, so expect a longer wait than most endpoints.
curl "https://api.socialfetch.dev/v1/linkedin/people/search?firstName=James&lastName=Smith" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/organizations
Get LinkedIn organization page
Credit cost: 2 credits per organization URL requested. Up to 50 organizations per request (100 credits max).
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/organizations/get.mdx
SDK: client.linkedin.getOrganizations({ urls })
Parameters:
- url (required, array) - LinkedIn organization page URL.
Disambiguation: This endpoint covers company, school, and other LinkedIn organization pages. If you only need a standard company page lookup, the Company page endpoint may be a better fit.
curl "https://api.socialfetch.dev/v1/linkedin/organizations?url=https://www.linkedin.com/school/uxdesigninstitute" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/companies
Get LinkedIn company page
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/companies/get.mdx
SDK: client.linkedin.getCompany({ url })
Parameters:
- url (required, string) - LinkedIn company page URL for this lookup. School and organization-guest pages are not supported; use `GET /v1/linkedin/organizations`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
Disambiguation: This endpoint is for LinkedIn company pages only. If you have a school URL or another organization page type, use the Organization page endpoint instead.
curl "https://api.socialfetch.dev/v1/linkedin/companies?url=https://www.linkedin.com/company/google/" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/companies/posts
List LinkedIn company posts
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/companies/posts/get.mdx
SDK: client.linkedin.listCompanyPosts({ url })
Parameters:
- url (required, string) - LinkedIn company page URL or slug whose posts should be listed.
- page (optional) - 1-based results page number. Pagination is page-based; at most 7 pages can be requested for a given company.
Outcome field: `data.lookupStatus` in `found`, `not_found`
Disambiguation: This endpoint is for LinkedIn company pages only. If you have a school URL or another organization page type, use the Organization page endpoint instead.
curl "https://api.socialfetch.dev/v1/linkedin/companies/posts?url=https://www.linkedin.com/company/google/" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/posts
Get LinkedIn post or article
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/posts/get.mdx
SDK: client.linkedin.getPost({ url })
Parameters:
- url (required, string) - Public permalink to the post or article.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/linkedin/posts?url=https://www.linkedin.com/posts/sundarpichai_small-businesses-are-the-engine-of-the-american-share-7449849038398697472-iNtG" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/posts/transcript
Get LinkedIn post transcript
Credit cost: 1 credit when a transcript is found; no charge when a transcript is unavailable.
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/posts/transcript/get.mdx
SDK: client.linkedin.getPostTranscript({ url })
Parameters:
- url (required, string) - Link to the LinkedIn post whose video transcript should be returned.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `lookup_failed`
curl "https://api.socialfetch.dev/v1/linkedin/posts/transcript?url=https://www.linkedin.com/posts/artificial-analysis_gemini-35-flash-is-a-step-forward-for-google-activity-7465082408409870337-4Pm-" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/posts/search
Search LinkedIn posts
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/posts/search/get.mdx
SDK: client.linkedin.searchPosts({ query: "ai agents" })
Parameters:
- query (required, string) - Keyword or phrase to search for in public LinkedIn posts.
- datePosted (optional, string, enum: last-hour | last-day | last-week | last-month | last-year) - Optional filter for how recently matching posts were published.
- cursor (optional, string) - Opaque pagination cursor returned by a previous response.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Empty results: An empty posts array means no matching public posts were returned for this query and page. It is not an error.
curl "https://api.socialfetch.dev/v1/linkedin/posts/search?query=ai agents" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/ad-library/ads
Get LinkedIn Ad Library ad
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/ad-library/ads/get.mdx
SDK: client.linkedin.getAdLibraryAd({ adId: "664291126" })
Parameters:
- adId (optional, string) - LinkedIn Ad Library id for the ad.
- url (optional, string) - Public LinkedIn Ad Library URL for the ad.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/linkedin/ad-library/ads?adId=664291126" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/ad-library/ads/search
Search LinkedIn Ad Library ads
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/ad-library/ads/search/get.mdx
SDK: client.linkedin.searchAdLibraryAds({ company: "microsoft" })
Parameters:
- company (optional, string) - Company name to search for in the LinkedIn Ad Library.
- keyword (optional, string) - Keyword or phrase to search for in LinkedIn Ad Library ads.
- companyId (optional, string) - LinkedIn company id to search for in the Ad Library.
- countries (optional, string) - Optional comma-separated list of country codes (for example US,CA,MX).
- startDate (optional, string) - Optional start date filter in YYYY-MM-DD format.
- endDate (optional, string) - Optional end date filter in YYYY-MM-DD format.
- cursor (optional, string) - Opaque pagination cursor from a previous response.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
curl "https://api.socialfetch.dev/v1/linkedin/ad-library/ads/search?company=microsoft" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/jobs
Get LinkedIn jobs
Credit cost: 2 credits per job URL requested. Up to 50 jobs per request (100 credits max).
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/jobs/get.mdx
SDK: client.linkedin.getJobs({ urls })
Parameters:
- url (required, array) - LinkedIn job posting URL to look up.
curl "https://api.socialfetch.dev/v1/linkedin/jobs?url=https://www.linkedin.com/jobs/view/software-engineer-at-epic-3986111804/" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/linkedin/jobs/search
Search LinkedIn jobs
Credit cost: 2 credits attempt fee plus 2 credits per returned record. Up to 1000 per request (2002 credits max). `limit` defaults to 10.
Docs: https://www.socialfetch.dev/docs/api/v1/linkedin/jobs/search/get.mdx
SDK: client.linkedin.searchJobs({ keyword })
Parameters:
- keyword (required, string) - Search keyword for LinkedIn job listings.
- location (required, string) - Location label for the search.
- country (optional, string) - Optional ISO 3166-1 country code.
- timeRange (optional, string, enum: any | past-month | past-week | past-24-hours) - Optional time range filter for when jobs were posted.
- jobType (optional, string, enum: full-time | part-time | contract | temporary | volunteer) - Optional job type filter.
- experienceLevel (optional, string, enum: internship | entry-level | associate | mid-senior-level | director | executive) - Optional experience level filter.
- remote (optional, string, enum: on-site | remote | hybrid) - Optional work arrangement filter.
- company (optional, string) - Optional company name filter.
- locationRadius (optional, string, enum: exact-location | 5-miles | 10-miles | 25-miles | 50-miles) - Optional location radius filter.
- limit (optional) - Maximum job listings to return (default 10).
Outcome field: `data.lookupStatus` in `found`, `not_found`
Disambiguation: This search usually takes around one and a half minutes.
curl "https://api.socialfetch.dev/v1/linkedin/jobs/search?keyword=software engineer&location=San Francisco" \
  -H "x-api-key: YOUR_API_KEY"