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
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 |
- Create an API key at socq.ai/dashboard/api-key.
- 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"- 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.
Base URL https://api.socq.ai. Every request sends the API key as a bearer token:
Authorization: Bearer <SOCQ_API_KEY>
Content-Type: application/jsonAll endpoints are asynchronous:
POST /v1/<publicId> -> data.task_id -> GET /v1/tasks/{task_id} -> queued | running | succeeded | failed
- Submit the JSON body to
POST https://api.socq.ai/v1/<publicId>. The response returnsdata.task_idimmediately; it means the task was created, not that data is ready. - Poll
GET https://api.socq.ai/v1/tasks/{task_id}untildata.statusissucceededorfailed(a failed task carriesdata.error_message). - Read results. A succeeded task returns normalized records in
data.results.items. Uselimit(default 50, max 500) and passdata.results.next_cursorascursorwhiledata.results.has_moreis true.fieldsselects up to 50 comma-separated fields or dot paths. - Raw files (optional).
GET https://api.socq.ai/v1/tasks/{task_id}/fileslists 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
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
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
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
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
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
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
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
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
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
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
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
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
| 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 |
- 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.