Skip to content

About

SocQ LinkedIn API examples in cURL, Node.js and Python: 12 endpoints for profiles, companies, posts, jobs, company jobs, company posts, post comments, profile posts, search jobs, search people, search posts and video transcript. Pay per call or per result.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

LinkedIn API

SocQ LinkedIn API API documentation License: MIT Check examples

12 endpoints for public LinkedIn data through one SocQ API key, with runnable cURL, Node.js and Python examples and a valid request body for every endpoint.

Browse LinkedIn APIs · Get an API key · Documentation · All SocQ examples

Endpoints

Prices are in SocQ credits; 1 credit = $0.005.

Endpoint publicId What it returns Price Launched
LinkedIn Profiles API linkedin/profiles Turn public LinkedIn profile URLs into normalized identity, role, location, experience, education, skill, and visible audience fields. 2.5 credits ($0.0125) per result 2026-07-18
LinkedIn Companies API linkedin/companies Normalize public LinkedIn company pages into descriptions, websites, logos, visible audience and employee counts, industries, size, locations, and specialties. 2 credits ($0.01) per result 2026-07-18
LinkedIn Posts API linkedin/posts Collect normalized public LinkedIn post text, author identity, visible engagement counts, media references, publication time, type, and hashtags from supported URLs. 1 credit ($0.005) per result 2026-07-18
LinkedIn Jobs API linkedin/jobs Normalize public LinkedIn job pages into title, company, description, location, seniority, employment type, industry, application, and available salary fields. 0.8 credits ($0.004) per result 2026-07-18
LinkedIn Company Jobs API linkedin/company-jobs Discover public LinkedIn job listings from prepared /jobs/ URLs, returning normalized role, company, location, employment, experience, remote, salary, and timing fields. 0.5 credits ($0.0025) per result 2026-08-11
LinkedIn Company Posts API linkedin/company-posts Discover public LinkedIn posts from company-page URLs, returning normalized text, author context, media, hashtags, timestamps, and visible engagement. 1 credit ($0.005) per result 2026-08-11
LinkedIn Post Comments API linkedin/post-comments Collect public comments exposed with a known LinkedIn post, returning normalized text, author context, timestamps, relationship IDs, and visible like and reply counts. 0.5 credits ($0.0025) per result 2026-08-11
LinkedIn Profile Posts API linkedin/profile-posts Discover public posts associated with LinkedIn profile URLs, returning normalized text, author context, media, hashtags, timestamps, and visible engagement. 1 credit ($0.005) per result 2026-08-11
LinkedIn Search Jobs API linkedin/search-jobs Search public LinkedIn job listings from a required location and optional provider filters, returning normalized role, employer, place, employment, experience, remote, salary, and timing fields. 0.5 credits ($0.0025) per result 2026-08-11
LinkedIn Search People API linkedin/search-people Discover candidate public LinkedIn profiles from people-search URLs, returning normalized identity, description, images, location, website, account signals, and available audience metrics. 1 credit ($0.005) per result 2026-08-11
LinkedIn Search Posts API linkedin/search-posts Discover Google-indexed public LinkedIn posts by keyword and optional relative-date string, returning normalized content, authors, media, hashtags, mentions, timestamps, and visible engagement. 0.5 credits ($0.0025) per result 2026-08-11
LinkedIn Video Transcript API linkedin/post-transcript Turn the captions of LinkedIn videos into plain text from the post URL, ready to quote, summarize or search. 0.7 credits ($0.0035) per result 2026-11-17

Quick start

  1. Create an API key at socq.ai/dashboard/api-key.
  2. Export it. The examples read only SOCQ_API_KEY.
git clone https://github.com/SocQAPI/linkedin-api.git
cd linkedin-api
export SOCQ_API_KEY="your-api-key"
  1. Run any endpoint by its publicId. Without a second argument the script sends payloads/<slug>.json; pass a JSON file or an inline JSON object to change the input.
# Node.js 20+
node examples/node/socq.mjs linkedin/profiles

# Python 3.8+ (standard library only)
python3 examples/python/socq.py linkedin/profiles payloads/profiles.json

# cURL + jq
bash examples/curl/socq.sh linkedin/profiles '{"urls":["https://www.linkedin.com/in/example"]}'

Each script submits the task, polls it until it succeeds or fails, follows every result page, and writes the records to output/<slug>-<task_id>.json. Run npm run check to validate the payloads and scripts offline.

Never expose SOCQ_API_KEY in browser code, mobile apps, public repositories, screenshots, fixtures or logs.

How the API works

Base URL https://api.socq.ai. Every request sends the API key as a bearer token:

Authorization: Bearer <SOCQ_API_KEY>
Content-Type: application/json

All endpoints are asynchronous:

POST /v1/<publicId>  ->  data.task_id  ->  GET /v1/tasks/{task_id}  ->  queued | running | succeeded | failed
  1. Submit the JSON body to POST https://api.socq.ai/v1/<publicId>. The response returns data.task_id immediately; it means the task was created, not that data is ready.
  2. Poll GET https://api.socq.ai/v1/tasks/{task_id} until data.status is succeeded or failed (a failed task carries data.error_message).
  3. Read results. A succeeded task returns normalized records in data.results.items. Use limit (default 50, max 500) and pass data.results.next_cursor as cursor while data.results.has_more is true. fields selects up to 50 comma-separated fields or dot paths.
  4. Raw files (optional). GET https://api.socq.ai/v1/tasks/{task_id}/files lists raw JSONL exports.
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100&cursor=$NEXT_CURSOR" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

callback_url (where an endpoint accepts it) makes SocQ POST to your URL when the task reaches a terminal state; keep polling as a fallback.

Billing. A submit may reserve credits from results_limit or the number of submitted inputs; when the task finishes SocQ settles the charge from the actual result count and returns unused reserved credits. 402 means insufficient credits.

Errors. 400 invalid body or unsupported field, 401 missing or invalid key, 402 insufficient credits, 403 IP allowlist or task owned by another account, 404 endpoint or task not found, 422 input validation failed, 429 rate or credit-window limit (respect Retry-After), 500 submission failed. A client-side timeout does not cancel a task: resume polling the same task_id instead of submitting again.

Reference: Authentication · Task status and results · Task files · Callbacks · Errors

Endpoint reference

LinkedIn Profiles API

Turn public LinkedIn profile URLs into normalized identity, role, location, experience, education, skill, and visible audience fields.

  • Request: POST https://api.socq.ai/v1/linkedin/profiles
  • publicId: linkedin/profiles
  • Price: 2.5 credits ($0.0125) per result
  • Launched: 2026-07-18
  • Example body: payloads/profiles.json
Field Type Required Description
urls array of string Yes Public profile or content URLs. (items at least 1)
curl -X POST "https://api.socq.ai/v1/linkedin/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "https://www.linkedin.com/in/example"
  ]
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/profiles · Landing page: socq.ai/apis/linkedin/profiles

LinkedIn Companies API

Normalize public LinkedIn company pages into descriptions, websites, logos, visible audience and employee counts, industries, size, locations, and specialties.

  • Request: POST https://api.socq.ai/v1/linkedin/companies
  • publicId: linkedin/companies
  • Price: 2 credits ($0.01) per result
  • Launched: 2026-07-18
  • Example body: payloads/companies.json
Field Type Required Description
urls array of string Yes Public profile or content URLs. (items at least 1)
curl -X POST "https://api.socq.ai/v1/linkedin/companies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "https://www.linkedin.com/company/example"
  ]
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/companies · Landing page: socq.ai/apis/linkedin/companies

LinkedIn Posts API

Collect normalized public LinkedIn post text, author identity, visible engagement counts, media references, publication time, type, and hashtags from supported URLs.

  • Request: POST https://api.socq.ai/v1/linkedin/posts
  • publicId: linkedin/posts
  • Price: 1 credit ($0.005) per result
  • Launched: 2026-07-18
  • Example body: payloads/posts.json
Field Type Required Description
urls array of string Yes Public profile or content URLs. (items at least 1)
curl -X POST "https://api.socq.ai/v1/linkedin/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "https://www.linkedin.com/posts/microsoft_ai-is-entering-a-new-era-defined-by-real-world-activity-7403848387738955776-hCMS"
  ]
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/posts · Landing page: socq.ai/apis/linkedin/posts

LinkedIn Jobs API

Normalize public LinkedIn job pages into title, company, description, location, seniority, employment type, industry, application, and available salary fields.

  • Request: POST https://api.socq.ai/v1/linkedin/jobs
  • publicId: linkedin/jobs
  • Price: 0.8 credits ($0.004) per result
  • Launched: 2026-07-18
  • Example body: payloads/jobs.json
Field Type Required Description
urls array of string Yes Public profile or content URLs. (items at least 1)
curl -X POST "https://api.socq.ai/v1/linkedin/jobs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "https://www.linkedin.com/jobs/view/4435421919/"
  ]
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/jobs · Landing page: socq.ai/apis/linkedin/jobs

LinkedIn Company Jobs API

Discover public LinkedIn job listings from prepared /jobs/ URLs, returning normalized role, company, location, employment, experience, remote, salary, and timing fields.

  • Request: POST https://api.socq.ai/v1/linkedin/company-jobs
  • publicId: linkedin/company-jobs
  • Price: 0.5 credits ($0.0025) per result
  • Launched: 2026-08-11
  • Example body: payloads/company-jobs.json
Field Type Required Description
results_limit integer No (value 1 to 2000; default 100)
urls array of string Yes Public profile or content URLs. (items at least 1)
curl -X POST "https://api.socq.ai/v1/linkedin/company-jobs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "https://www.linkedin.com/jobs/microsoft-jobs/"
  ],
  "results_limit": 20
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/company-jobs · Landing page: socq.ai/apis/linkedin/company-jobs

LinkedIn Company Posts API

Discover public LinkedIn posts from company-page URLs, returning normalized text, author context, media, hashtags, timestamps, and visible engagement.

  • Request: POST https://api.socq.ai/v1/linkedin/company-posts
  • publicId: linkedin/company-posts
  • Price: 1 credit ($0.005) per result
  • Launched: 2026-08-11
  • Example body: payloads/company-posts.json
Field Type Required Description
end_date string No -
results_limit integer No (value 1 to 2000; default 100)
start_date string No -
urls array of string Yes Public profile or content URLs. (items at least 1)
curl -X POST "https://api.socq.ai/v1/linkedin/company-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "https://www.linkedin.com/company/microsoft/"
  ],
  "results_limit": 20
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/company-posts · Landing page: socq.ai/apis/linkedin/company-posts

LinkedIn Post Comments API

Collect public comments exposed with a known LinkedIn post, returning normalized text, author context, timestamps, relationship IDs, and visible like and reply counts.

  • Request: POST https://api.socq.ai/v1/linkedin/post-comments
  • publicId: linkedin/post-comments
  • Price: 0.5 credits ($0.0025) per result
  • Launched: 2026-08-11
  • Example body: payloads/post-comments.json
Field Type Required Description
url string Yes A public content or product URL.
curl -X POST "https://api.socq.ai/v1/linkedin/post-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.linkedin.com/posts/aagupta_what-you-need-to-know-ai-agents-activity-7354600338621906944-RvXR"
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/post-comments · Landing page: socq.ai/apis/linkedin/post-comments

LinkedIn Profile Posts API

Discover public posts associated with LinkedIn profile URLs, returning normalized text, author context, media, hashtags, timestamps, and visible engagement.

  • Request: POST https://api.socq.ai/v1/linkedin/profile-posts
  • publicId: linkedin/profile-posts
  • Price: 1 credit ($0.005) per result
  • Launched: 2026-08-11
  • Example body: payloads/profile-posts.json
Field Type Required Description
end_date string No -
only_authored_posts boolean No -
results_limit integer No (value 1 to 2000; default 100)
start_date string No -
urls array of string Yes Public profile or content URLs. (items at least 1)
curl -X POST "https://api.socq.ai/v1/linkedin/profile-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "https://www.linkedin.com/in/satyanadella/"
  ],
  "only_authored_posts": true,
  "results_limit": 20
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/profile-posts · Landing page: socq.ai/apis/linkedin/profile-posts

LinkedIn Search Jobs API

Search public LinkedIn job listings from a required location and optional provider filters, returning normalized role, employer, place, employment, experience, remote, salary, and timing fields.

  • Request: POST https://api.socq.ai/v1/linkedin/search-jobs
  • publicId: linkedin/search-jobs
  • Price: 0.5 credits ($0.0025) per result
  • Launched: 2026-08-11
  • Example body: payloads/search-jobs.json
Field Type Required Description
company string No -
country string No -
experience_level string No -
job_type string No -
jobs_to_not_include array of string No -
keyword string No -
location string Yes -
location_radius string No -
remote string No -
results_limit integer No (value 1 to 2000; default 100)
selective_search boolean No -
time_range string No -
curl -X POST "https://api.socq.ai/v1/linkedin/search-jobs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "location": "Seattle",
  "keyword": "Python",
  "country": "US",
  "results_limit": 20
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/search-jobs · Landing page: socq.ai/apis/linkedin/search-jobs

LinkedIn Search People API

Discover candidate public LinkedIn profiles from people-search URLs, returning normalized identity, description, images, location, website, account signals, and available audience metrics.

  • Request: POST https://api.socq.ai/v1/linkedin/search-people
  • publicId: linkedin/search-people
  • Price: 1 credit ($0.005) per result
  • Launched: 2026-08-11
  • Example body: payloads/search-people.json
Field Type Required Description
urls array of string Yes Public profile or content URLs. (items at least 1)
curl -X POST "https://api.socq.ai/v1/linkedin/search-people" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "https://www.linkedin.com/search/results/people/?keywords=Aakash%20Gupta"
  ]
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/search-people · Landing page: socq.ai/apis/linkedin/search-people

LinkedIn Search Posts API

Discover Google-indexed public LinkedIn posts by keyword and optional relative-date string, returning normalized content, authors, media, hashtags, mentions, timestamps, and visible engagement.

  • Request: POST https://api.socq.ai/v1/linkedin/search-posts
  • publicId: linkedin/search-posts
  • Price: 0.5 credits ($0.0025) per result
  • Launched: 2026-08-11
  • Example body: payloads/search-posts.json

An explicit no-posts response completes successfully with an empty results.items list. Other access or service errors remain failures. Empty collections follow the normal empty-result billing policy.

Field Type Required Description
date_posted string No -
query string Yes Search query.
results_limit integer No (value 10 to 2000; default 10)
curl -X POST "https://api.socq.ai/v1/linkedin/search-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "AI agents",
  "date_posted": "last-week",
  "results_limit": 10
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/search-posts · Landing page: socq.ai/apis/linkedin/search-posts

LinkedIn Video Transcript API

Turn the captions of LinkedIn videos into plain text from the post URL, ready to quote, summarize or search.

  • Request: POST https://api.socq.ai/v1/linkedin/post-transcript
  • publicId: linkedin/post-transcript
  • Price: 0.7 credits ($0.0035) per result
  • Launched: 2026-11-17
  • Example body: payloads/post-transcript.json

Get the words spoken in a LinkedIn video as plain text. Pass the post link and the transcript comes back from the captions attached to the video, ready to quote, summarize or search. Founders and executives increasingly speak on video instead of writing long posts, so this is how you put their talks, product demos and earnings recaps into the same pipeline as written LinkedIn content.

Provide LinkedIn post URLs that contain a video in urls, using /posts/... or /feed/update/urn:li:activity:.... Each captioned video returns one row with its caption text and costs 0.7 credits, so billing follows the transcripts returned.

Field Type Required Description
callback_url string (uri) No -
urls array of string Yes Public profile or content URLs. (items at least 1)
curl -X POST "https://api.socq.ai/v1/linkedin/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urls": [
    "https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go"
  ]
}'

Full docs: https://docs.socq.ai/api-manual/linkedin/post-transcript · Landing page: socq.ai/apis/linkedin/post-transcript

Repository contents

Path Purpose
examples/curl/socq.sh Submit, poll and paginate with cURL and jq
examples/node/socq.mjs Same workflow in Node.js 20+ (no dependencies)
examples/python/socq.py Same workflow in Python 3.8+ (standard library)
payloads/ One documented request body per endpoint
endpoints.json Endpoint list, prices and request schemas used by the scripts and checks
fixtures/ Synthetic submit and task response shapes
docs/production-notes.md Retries, timeouts, pagination and data handling
scripts/check.mjs Offline check: payloads, syntax and secrets

Responsible use and platform scope

  • Use only publicly accessible LinkedIn data and the fields supported by each endpoint.
  • Do not use the examples to access restricted content, login-only surfaces, authentication controls or non-public personal information.
  • SocQ is not an official API of the represented platform and is not affiliated with or endorsed by it. Platform names and trademarks belong to their respective owners.
  • Before production use, assess the laws, platform terms, privacy obligations and retention requirements that apply to your organization and use case.
  • Collect only the fields needed for a defined purpose, restrict access, set retention periods, and support correction or deletion workflows where required.

This section describes the public-data boundary; it is not legal advice.

License

MIT

About

SocQ LinkedIn API examples in cURL, Node.js and Python: 12 endpoints for profiles, companies, posts, jobs, company jobs, company posts, post comments, profile posts, search jobs, search people, search posts and video transcript. Pay per call or per result.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages