# Socify API — LinkedIn endpoints
# Base URL: https://trysocify.com
# API host: https://api.trysocify.com
# Auth: Authorization: Bearer <SOCIFY_KEY>
# Full catalog: https://trysocify.com/llms-endpoints.txt | JSON: https://trysocify.com/llms.json
# Agents map: https://trysocify.com/agents.txt | Index: https://trysocify.com/llms.txt
# Docs hub: https://trysocify.com/docs/api/linkedin | OpenAPI: https://trysocify.com/openapi.json

4 documented LinkedIn operations. Public LinkedIn companies, jobs, posts, and profiles by URL.
Do not invent paths — only the routes below (and their linked markdown pages) are supported.

## GET /api/v1/linkedin/company
LinkedIn Company
Fetch a public LinkedIn company page by URL: about, size, industry, and followers.
Credit cost: 3 credits per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/linkedin/company.md
HTML: https://trysocify.com/docs/api/linkedin/company
SEO: https://trysocify.com/linkedin/company
Parameters:
- url (required, string) - LinkedIn company URL. Example: `https://il.linkedin.com/company/ibm`.
curl:
curl -sS "https://trysocify.com/api/v1/linkedin/company?url=https%3A%2F%2Fil.linkedin.com%2Fcompany%2Fibm" \
  -H "Authorization: Bearer $SOCIFY_KEY"

## GET /api/v1/linkedin/job
LinkedIn Job
Fetch a public LinkedIn job posting by URL: title, company, location, and summary.
Credit cost: 2 credits per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/linkedin/job.md
HTML: https://trysocify.com/docs/api/linkedin/job
SEO: https://trysocify.com/linkedin/job
Parameters:
- url (required, string) - LinkedIn job URL. Example: `https://www.linkedin.com/jobs/view/software-engineer-at-epic-3986111804?_l=en`.
curl:
curl -sS "https://trysocify.com/api/v1/linkedin/job?url=https%3A%2F%2Fwww.linkedin.com%2Fjobs%2Fview%2Fsoftware-engineer-at-epic-3986111804%3F_l%3Den" \
  -H "Authorization: Bearer $SOCIFY_KEY"

## GET /api/v1/linkedin/post
LinkedIn Post
Fetch a public LinkedIn post by URL: text, likes, comments, and author metadata.
Credit cost: 2 credits per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/linkedin/post.md
HTML: https://trysocify.com/docs/api/linkedin/post
SEO: https://trysocify.com/linkedin/post
Parameters:
- url (required, string) - LinkedIn post or Pulse URL. Example: `https://www.linkedin.com/feed/update/urn:li:activity:7516137498180415488/`.
curl:
curl -sS "https://trysocify.com/api/v1/linkedin/post?url=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fupdate%2Furn%3Ali%3Aactivity%3A7516137498180415488%2F" \
  -H "Authorization: Bearer $SOCIFY_KEY"

## GET /api/v1/linkedin/profile
LinkedIn Profile
Fetch a public LinkedIn person profile by URL: name, about, current company, and followers.
Credit cost: 3 credits per request. Failed requests are free.
Auth: Authorization: Bearer <SOCIFY_KEY>
Docs: https://trysocify.com/docs/api/linkedin/profile.md
HTML: https://trysocify.com/docs/api/linkedin/profile
SEO: https://trysocify.com/linkedin/profile
Parameters:
- url (required, string) - LinkedIn profile URL. Example: `https://www.linkedin.com/in/satyanadella`.
curl:
curl -sS "https://trysocify.com/api/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fsatyanadella" \
  -H "Authorization: Bearer $SOCIFY_KEY"