Profile
5 credits/v1/linkedin/profileGet LinkedIn user profile.
url
Fetch public LinkedIn data as structured JSON with one SocialCrawl API key. Same Post, Comment, and Author schema as every other platform. Reads are priced in credits.
44 active endpoints
44 live read endpoints for public LinkedIn data. People and company profiles, posts, comments, jobs, and search. Data API only. No private InMail.
/v1/linkedin/profileGet LinkedIn user profile.
url
/v1/linkedin/profile/fullLinkedIn company profile, recent posts, and computed analytics in one call.
url, posts, cursor, include
/v1/linkedin/profile/postsList a LinkedIn member's posts.
url, cursor, page
/v1/linkedin/companyGet LinkedIn company page.
url
/v1/linkedin/company/postsList LinkedIn company posts.
company_id, page, sort_by
/v1/linkedin/postGet LinkedIn post details.
url
/v1/linkedin/post/commentsGet LinkedIn post comments.
url, page, post_type, sort_order
/v1/linkedin/search/peopleSearch LinkedIn people.
query, page, first_name, last_name, title
/v1/linkedin/search/postsSearch public LinkedIn posts by keyword.
query, page, sort_by, date_posted, content_type
/v1/linkedin/search/jobsSearch LinkedIn jobs.
query, page, date_posted, experience_level, job_type
Returns a LinkedIn member's public profile: full name, headline, location, follower and connection counts, profile picture, and profile URL.
Use it as the starting point for any person lookup, then call the profile sub-endpoints for their experiences, skills, or posts.
5 credits
url · Full URL of the LinkedIn profile page
$ curl https://www.socialcrawl.dev/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates%2F \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responseLinkedIn is a normal SocialCrawl social surface. You call GET /v1/linkedin/… with an API key, spend credits on live misses, and get a single JSON envelope back. No second SDK.
Send your key in the x-api-key header. The same key works across the SocialCrawl catalog.
Routes are GET. Pass handles, urls, queries, and cursors as query strings. We validate formats before charging.
Live misses debit the route tier. Cache hits cost 0. Empty or hard failures refund.
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached.
Most products resolve an account, page content, then deepen only the posts that matter.
GET /v1/linkedin/profileAuthor-shaped profile
Resolve the handle or id once.
GET /v1/linkedin/profile/fullPostList of recent public items
Page with cursor or after when the route supports it.
GET /v1/linkedin/profile/postsFull Post for one URL or id
List rows are not enough when you need the full record.
GET /v1/linkedin/companyCommentList when the platform exposes it
Expand only when a thread matters.
GET /v1/linkedin/profile
?url=https://www.linkedin.com/in/williamhgates/
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here{
"success": true,
"data": { "/* Author | Post | PostList | CommentList | … */": true },
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}Field names match the rest of SocialCrawl where archetypes align.
id, username, display_name, avatar_url, bio, followers, url, ext
items[].post with id, url, content, engagement, author, published_at, ext
items[] with author, content.text, engagement, published_at when comments ship
search hits, media metadata, or transcripts depending on route
Same request lifecycle as every other /v1 platform endpoint.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit and concurrency.
Registry lookup finds the route. Required params run first. Invalid input returns 400 with no charge. Valid calls debit before upstream work.
A deterministic cache key is built from platform + resource + params. Hit: credits_used = 0. Miss: upstream fetch with retries and circuit breaker.
Upstream JSON is mapped to Author / Post / PostList / CommentList (or route archetype), validated, wrapped in the success envelope, and logged for billing audit.
Billing rules that matter in production
LinkedIn is public-read data on SocialCrawl. We normalize it into the shared schema so your code does not learn a second OAuth flow.
Public LinkedIn surfaces exposed by the registry. Read-only for research, monitoring, and product jobs.
Social-read upstreams behind one gateway. Prism composites combine legs when a fat route is registered.
Unified JSON envelope: success, data, credits_used, request_id, cached. Shared Author / Post / Comment leaves where archetypes align.
No write endpoints and no private inbox. Disabled routes stay out of the active count. Prefer registry docs for the live inventory.
The jobs this API is most often used for.
B2B prospecting and company content monitoring
Callers concentrate on profile, content lists, search, and deepen paths on LinkedIn. People, company, jobs, and posts on the shared schema with credit pricing instead of a LinkedIn partnership app for these public reads.
Detail reads are typically a few seconds on live miss. Search and fat composites are slower paths.
The jobs LinkedIn data is most often used for. Each one is a full recipe with the endpoint chain and pricing.
Common ways teams put this data to work, and the stack each one tends to run.
Poll profiles and feeds on LinkedIn. Alert when engagement velocity jumps.
Search and expand posts for brand, product, and competitor language on LinkedIn.
Wire resolve to list to detail into pipelines. Cache hits keep recurring runs cheap.
Live misses spend credits by tier. Cache hits are free. Empty or hard failures refund.
curl "https://www.socialcrawl.dev/v1/linkedin/profile?url=https://www.linkedin.com/in/williamhgates/" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/linkedin/profile/full?url=https://example.com/…" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Same LinkedIn data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | LinkedIn Marketing API |
|---|---|---|
| Authentication | One x-api-key header | OAuth 2.0 with member consent screens |
| Setup / approval | Sign up and call immediately | Developer app review plus Marketing Developer Platform approval |
| Rate limits | Credit-based, pay per request | Daily call quotas per app and per member token |
| Response schema | Unified JSON shared across 51 platforms | LinkedIn-specific response shapes you map yourself |
| Pricing | 1 credit standard, 5 advanced, 10 premium; 100 free credits | Free, but access gated to approved partner use cases |
| Data coverage | Public profiles, companies, posts, ad and post search, transcripts, Ad Library | Member-authorized data, ad campaign management, and official posting |
| Maintenance | Schema stays stable when LinkedIn changes internals | You track API versions and partner program requirements |
Authentication
Setup / approval
Rate limits
Response schema
Pricing
Data coverage
Maintenance
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl