# 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: 1 (standard)
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: 1 (standard)
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: 1 (standard)
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/company/posts
List LinkedIn company posts
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the LinkedIn company page
- page (optional, integer) — The page number to get
curl "https://www.socialcrawl.dev/v1/linkedin/company/posts?url=https://www.linkedin.com/company/microsoft/" \
  -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/12345" \
  -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"