# SocialCrawl API — linkedin endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/linkedin

## GET /v1/linkedin/profile
Get LinkedIn user profile
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile page
curl "https://www.socialcrawl.dev/v1/linkedin/profile?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/company
Get LinkedIn company page
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn company page
curl "https://www.socialcrawl.dev/v1/linkedin/company?url=https://www.linkedin.com/company/microsoft/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/post
Get LinkedIn post details
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn post
curl "https://www.socialcrawl.dev/v1/linkedin/post?url=https://www.linkedin.com/posts/williamhgates_example-activity-1234567890" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/search/people
Search LinkedIn people
Credit cost: 10 (premium)
Parameters:
- query (required) — Name or display-name keyword to search for (e.g. 'Bill Gates').
- page (optional, string) — Page number for pagination (default 1).
- first_name (optional, string) — Filter by first name.
- last_name (optional, string) — Filter by last name.
- title (optional, string) — Filter by job title or headline.
- current_company (optional, string) — Filter by current company ID (comma-separated for multiple).
- past_company (optional, string) — Filter by a previously-worked company ID.
- school (optional, string) — Filter by school ID.
- industry (optional, string) — Filter by industry ID.
- geocode_location (optional, string) — Filter by location geocode ID.
- profile_language (optional, string) — Filter by profile language (ISO 2-letter code, e.g. 'en').
- service_category (optional, string) — Filter by service-category ID.
- follower_of (optional, string) — Return people who follow a specific member URN.
curl "https://www.socialcrawl.dev/v1/linkedin/search/people?query=Bill Gates" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/company/people
List people at a LinkedIn company
Credit cost: 10 (premium)
Parameters:
- company_id (required) — LinkedIn numeric company ID (from /v1/linkedin/company).
- page (optional, string) — Page number for pagination (default 1).
curl "https://www.socialcrawl.dev/v1/linkedin/company/people?company_id=1035" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/post/comments
Get LinkedIn post comments
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn post (or its activity id).
- page (optional, string) — Page number for pagination (default 1).
- post_type (optional, string) — Upstream post type: 'activity' (default) or 'ugc'.
- sort_order (optional, string) — Comment ordering: 'relevance' or 'recent'.
curl "https://www.socialcrawl.dev/v1/linkedin/post/comments?url=https://www.linkedin.com/feed/update/urn:li:activity:7244804629786419202" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/posts
List a LinkedIn member's posts
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- cursor (optional, string)
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/posts?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/reactions
List posts a LinkedIn member reacted to
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- cursor (optional, string)
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/reactions?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/post/reposts
List reposts of a LinkedIn post
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- cursor (optional, string)
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/post/reposts?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/group/posts
List posts in a LinkedIn group
Credit cost: 5 (advanced)
Parameters:
- group_id (required) — LinkedIn numeric group ID.
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/group/posts?group_id=62438" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/company/affiliated-pages
List a company's affiliated/showcase pages
Credit cost: 5 (advanced)
Parameters:
- company_id (required) — LinkedIn numeric company ID (from /v1/linkedin/company).
curl "https://www.socialcrawl.dev/v1/linkedin/company/affiliated-pages?company_id=1035" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/post/comments/replies
List replies to a LinkedIn comment
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- comment_id (required) — LinkedIn comment ID (from /post/comments).
- cursor (optional, string)
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/post/comments/replies?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/experiences
List a member's work experiences
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/experiences?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/educations
List a member's education history
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/educations?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/skills
List a member's skills
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/skills?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/honors
List a member's honors and awards
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/honors?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/certifications
List a member's licenses and certifications
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/certifications?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/publications
List a member's publications
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/publications?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/volunteers
List a member's volunteer experiences
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/volunteers?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/recommendations
List recommendations for a member
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- page (optional, string)
- type (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/recommendations?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/interests/companies
List companies a member follows
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/interests/companies?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/interests/groups
List groups a member follows
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/interests/groups?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/images
List a member's image posts
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- cursor (optional, string)
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/images?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/videos
List a member's video posts
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- cursor (optional, string)
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/videos?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/comments
List a member's comments
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- cursor (optional, string)
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/profile/comments?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/post/reactions
List reactors on a LinkedIn post
Credit cost: 10 (premium)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
- page (optional, string)
- type (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/post/reactions?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/company/jobs
List a company's job postings
Credit cost: 10 (premium)
Parameters:
- company_id (required) — LinkedIn numeric company ID (from /v1/linkedin/company).
- page (optional, string)
- date_posted (optional, string)
- experience_level (optional, string)
- job_type (optional, string)
- remote (optional, string)
- easy_apply (optional, string)
- sort_by (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/company/jobs?company_id=1035" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/search/jobs
Search LinkedIn jobs
Credit cost: 10 (premium)
Parameters:
- query (required) — Search keyword.
- page (optional, string)
- date_posted (optional, string)
- experience_level (optional, string)
- job_type (optional, string)
- remote (optional, string)
- easy_apply (optional, string)
- sort_by (optional, string)
- company (optional, string)
- geocode (optional, string)
- industry_ids (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/search/jobs?query=marketing" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/search/location
Resolve a location to a LinkedIn geocode id
Credit cost: 1 (standard)
Parameters:
- query (required) — Search keyword.
curl "https://www.socialcrawl.dev/v1/linkedin/search/location?query=marketing" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/search/schools
Search LinkedIn schools
Credit cost: 1 (standard)
Parameters:
- query (required) — Search keyword.
- page (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/search/schools?query=marketing" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/search/industry
Resolve an industry name to a LinkedIn industry id
Credit cost: 1 (standard)
Parameters:
- query (required) — Search keyword.
curl "https://www.socialcrawl.dev/v1/linkedin/search/industry?query=marketing" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/about
Get a member's profile metadata (joined date, freshness)
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
curl "https://www.socialcrawl.dev/v1/linkedin/profile/about?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/contact
Get a member's public contact info
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
curl "https://www.socialcrawl.dev/v1/linkedin/profile/contact?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/stats
Get a member's follower + connection counts
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn profile, company, or post.
curl "https://www.socialcrawl.dev/v1/linkedin/profile/stats?url=https://www.linkedin.com/in/williamhgates/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/company/job-count
Get a company's open job count
Credit cost: 5 (advanced)
Parameters:
- company_id (required) — LinkedIn numeric company ID (from /v1/linkedin/company).
curl "https://www.socialcrawl.dev/v1/linkedin/company/job-count?company_id=1035" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/company/insights
Get aggregate insights about a company's members
Credit cost: 5 (advanced)
Parameters:
- company_id (required) — LinkedIn numeric company ID (from /v1/linkedin/company).
curl "https://www.socialcrawl.dev/v1/linkedin/company/insights?company_id=1035" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/group
Get LinkedIn group details
Credit cost: 5 (advanced)
Parameters:
- group_id (required) — LinkedIn numeric group ID.
curl "https://www.socialcrawl.dev/v1/linkedin/group?group_id=62438" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/job
Get LinkedIn job details
Credit cost: 5 (advanced)
Parameters:
- id (required) — LinkedIn job ID.
- include_skills (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/job?id=4019392600" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/company/posts
List LinkedIn company posts
Credit cost: 5 (advanced)
Parameters:
- company_id (required) — LinkedIn numeric company ID (from /v1/linkedin/company).
- page (optional, string) — Page number for pagination (default 1).
- sort_by (optional, string) — Post ordering: 'top' or 'recent'.
curl "https://www.socialcrawl.dev/v1/linkedin/company/posts?company_id=1035" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/ad
Get LinkedIn ad details
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the LinkedIn ad
curl "https://www.socialcrawl.dev/v1/linkedin/ad?url=https://www.linkedin.com/ad-library/detail/666281156" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/ads/search
Search LinkedIn ads
Credit cost: 5 (advanced)
Parameters:
- company (optional, string) — The company name to search for. 'Microsoft' for example
- keyword (optional, string) — The keyword to search for
- companyId (optional, string) — The company id to search for
- countries (optional, string) — Comma separated list of countries. Example: US,CA,MX
- startDate (optional, string) — Start date to search for. Format: YYYY-MM-DD
- endDate (optional, string) — End date to search for. Format: YYYY-MM-DD
- paginationToken (optional, string) — Pagination token to paginate through results
curl "https://www.socialcrawl.dev/v1/linkedin/ads/search" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/search/posts
Search public LinkedIn posts by keyword
Credit cost: 5 (advanced)
Parameters:
- query (required) — Keyword or phrase to search for in public LinkedIn posts.
- page (optional, string)
- sort_by (optional, string)
- date_posted (optional, string) — Date filter based on Google-indexed results.
- content_type (optional, string)
- from_company (optional, string)
- from_member (optional, string)
curl "https://www.socialcrawl.dev/v1/linkedin/search/posts?query=ai agents" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/post/transcript
Get a LinkedIn post video transcript
Credit cost: 10 (premium)
Parameters:
- url (required) — Full URL of the LinkedIn post to transcribe.
curl "https://www.socialcrawl.dev/v1/linkedin/post/transcript?url=https://www.linkedin.com/posts/gemini-35-flash-is-a-step-forward-for-google-ugcPost-7465082215316525056-MHBd/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/linkedin/profile/full
LinkedIn company profile, recent posts, and computed analytics in one call.
Credit cost: 5 (override; tier standard)
Parameters:
- url (optional, string)
- posts (optional, integer) — How many recent posts to fetch + average the computed metrics over (1–100, default 25).
- cursor (optional, string) — Pass a prior response's posts_cursor to deepen the post window.
- include (optional, string) — CSV subset of posts,computed (default both). include=computed drops the raw posts[] to save payload.
curl "https://www.socialcrawl.dev/v1/linkedin/profile/full" \
  -H "x-api-key: sc_your_api_key_here"