> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Profile
> Fetches a person's public LinkedIn profile and returns identity, about, experience, education, certifications, honors, publications, volunteering, websites, languages, recent posts and articles, recommendations, and similar profiles. Only publicly available data is returned.
**Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free.
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
```text Prompt
I want to make an API call to /v1/linkedin/profile. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/linkedin/profile
Description: Fetches a person's public LinkedIn profile and returns identity, about, experience, education, certifications, honors, publications, volunteering, websites, languages, recent posts and articles, recommendations, and similar profiles. Only publicly available data is returned.
Required Headers:
- x-api-key: Your API key
Parameters:
- url (string) [required]: The URL of the LinkedIn profile to fetch, e.g. `https://www.linkedin.com/in/williamhgates`.
- cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
Example Response:
{
"data": {
"profile": {
"url": "https://www.linkedin.com/in/williamhgates",
"handle": "williamhgates",
"name": "Bill Gates",
"firstName": "Bill",
"lastName": "Gates",
"headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",
"about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
"location": {
"locality": "Seattle, Washington, United States",
"country": "US"
},
"profilePhotoUrl": "https://media.licdn.com/dms/image/v2/D5603AQF-RYZP55jmXA/profile-displayphoto-shrink_200_200/B56ZRi8g.aGsAY-/0/1736826818802?e=2147483647&v=beta&t=bKWfN6UwwtiCq…",
"followerCount": 40705673,
"connections": null,
"languages": [],
"awards": [],
"experience": [
{
"company": "Gates Foundation",
"companyUrl": "https://www.linkedin.com/company/gates-foundation",
"location": null,
"title": "Co-chair",
"description": null
}
],
"education": [
{
"school": "Harvard University",
"schoolUrl": "https://www.linkedin.com/school/harvard-university/",
"description": null,
"startYear": 1973,
"endYear": 1975
}
],
"certifications": [],
"honors": [],
"publications": [],
"volunteering": [],
"websites": [],
"posts": [
{
"url": "https://www.linkedin.com/posts/williamhgates_results-report-2026-activity-7511544945862926336-2Ger",
"text": "The Global Fund has helped save 72 million lives since 2002. What an achievement. It’s exceedingly rare for an organization to work this well, this consistently…",
"publishedAt": "2026-10-01T21:57:52.849Z",
"likeCount": 1269
}
],
"articles": [
{
"url": "https://www.linkedin.com/pulse/ai-equity-choice-we-cant-delay-bill-gates-d1gte",
"headline": "AI, equity, and the choice we can’t delay",
"publishedAt": "2026-09-17T15:18:20.000+00:00",
"imageUrl": "https://media.licdn.com/dms/image/v2/D4E12AQFwjr3EOC2slQ/article-cover_image-shrink_720_1280/B4EaCvyLnRKAAQ-/0/1789655564567?e=2147483647&v=beta&t=LlizryNgZ1ezX…",
"likeCount": 2885
}
],
"recommendations": [],
"similarProfiles": [
{
"name": "Melinda French Gates",
"url": "https://www.linkedin.com/in/melindagates",
"headline": "Pivotal",
"followers": "7M followers",
"location": "United States"
}
]
},
"fetchedAt": "2026-10-05T14:46:33.223Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
```
## OpenAPI
````yaml /api-reference/openapi.json get /v1/linkedin/profile
openapi: 3.0.3
info:
title: Scraperize API
version: 1.0.0
description: >-
Extract public data from social media platforms as clean JSON. Endpoints are
split by platform and by what they return, e.g. `GET /v1/twitter/tweet`.
## Authentication
Send your API key in the `x-api-key` header (or `Authorization: Bearer
`). Create keys in your dashboard.
## Credits
Each successful live scrape costs **1 credit**. Credits are prepaid and
never expire.
## Caching
Every endpoint accepts an optional `cache_max_age`
(`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for
**0 credits**.
## Responses
Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return
`{ "error": { "code", "message", "requestId" } }` with a matching HTTP
status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`,
`cached`, and (on a hit) `cachedAt`.
## Rate limits
Requests are limited per team per minute; over the limit returns `429` with
a `Retry-After` header.
servers:
- url: https://api.scraperize.com
description: Production
security:
- ApiKeyAuth: []
tags:
- name: Twitter
description: Twitter / X scraping endpoints
- name: Facebook
description: Facebook scraping endpoints
- name: Linkme
description: Linkme (link.me) scraping endpoints
- name: Amazon
description: Amazon (creator shop / storefront) scraping endpoints
- name: Linkbio
description: Linkbio (lnk.bio) scraping endpoints
- name: Pillar
description: Pillar (pillar.io) scraping endpoints
- name: Komi
description: Komi (komi.io) scraping endpoints
- name: Linktree
description: Linktree (linktr.ee) scraping endpoints
- name: Kick
description: Kick (kick.com) scraping endpoints
- name: Snapchat
description: Snapchat (snapchat.com) scraping endpoints
- name: Telegram
description: Telegram (t.me) scraping endpoints
- name: LinkedIn
description: LinkedIn scraping endpoints
- name: Twitch
description: Twitch scraping endpoints
- name: TikTok
description: TikTok (tiktok.com) scraping endpoints
paths:
/v1/linkedin/profile:
get:
tags:
- LinkedIn
summary: Profile
description: >-
Fetches a person's public LinkedIn profile and returns identity, about,
experience, education, certifications, honors, publications,
volunteering, websites, languages, recent posts and articles,
recommendations, and similar profiles. Only publicly available data is
returned.
parameters:
- name: url
in: query
required: true
description: >-
The URL of the LinkedIn profile to fetch, e.g.
`https://www.linkedin.com/in/williamhgates`.
schema:
type: string
example: https://www.linkedin.com/in/williamhgates
- name: cache_max_age
in: query
required: false
description: >-
Optional. Return a cached result if one this age or newer exists —
served for **0 credits** with `meta.cached=true` and
`meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and
refreshes the cache. Omit to always scrape fresh.
schema:
type: string
enum:
- 1d
- 3d
- 7d
- 14d
- 30d
example: 7d
responses:
'200':
description: The public profile.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
profile:
type: object
nullable: true
fetchedAt:
type: string
format: date-time
meta:
type: object
description: >-
requestId + credit/caching metadata (creditsCharged,
creditsRemaining, cached, cachedAt).
required:
- data
- meta
example:
data:
profile:
url: https://www.linkedin.com/in/williamhgates
handle: williamhgates
name: Bill Gates
firstName: Bill
lastName: Gates
headline: Chair, Gates Foundation and Founder, Breakthrough Energy
about: >-
Chair of the Gates Foundation. Founder of Breakthrough
Energy. Co-founder of Microsoft. Voracious reader. Avid
traveler. Active blogger.
location:
locality: Seattle, Washington, United States
country: US
profilePhotoUrl: >-
https://media.licdn.com/dms/image/v2/D5603AQF-RYZP55jmXA/profile-displayphoto-shrink_200_200/B56ZRi8g.aGsAY-/0/1736826818802?e=2147483647&v=beta&t=bKWfN6UwwtiCqFWsG7rBELbd48qJOAMLdxhBzzkJV0k
followerCount: 40705673
connections: null
languages: []
awards: []
experience:
- company: Gates Foundation
companyUrl: https://www.linkedin.com/company/gates-foundation
location: null
title: Co-chair
description: null
- company: Breakthrough Energy
companyUrl: https://www.linkedin.com/company/breakthrough-energy
location: null
title: Founder
description: null
- company: Microsoft
companyUrl: https://www.linkedin.com/company/microsoft
location: null
title: Co-founder
description: null
education:
- school: Harvard University
schoolUrl: https://www.linkedin.com/school/harvard-university/
description: null
startYear: 1973
endYear: 1975
certifications: []
honors: []
publications: []
volunteering: []
websites: []
posts:
- url: >-
https://www.linkedin.com/posts/williamhgates_results-report-2026-activity-7511544945862926336-2Ger
text: >-
The Global Fund has helped save 72 million lives since
2002. What an achievement. It’s exceedingly rare for
an organization to work this well, this consistently,
for this long.
But we can’t get complacent. Donor funding cuts last
year forced low-and middle-income countries to make
impossible choices about how they address national
health issues, including HIV, TB and malaria. Their
resilience in spite of that has been remarkable, but
there’s still so much work to do. Supporting the
Global Fund is one of the best investments we can make
in the health and well-being of future generations.
publishedAt: '2026-10-01T21:57:52.849Z'
likeCount: 1269
- url: >-
https://www.linkedin.com/posts/williamhgates_carnegie-mellon-university-announces-historic-activity-7511520890451296256-tv-D
text: >-
Ken’s incredible generosity will make a huge, lasting
impact.
publishedAt: '2026-10-01T20:22:17.591Z'
likeCount: 797
- url: >-
https://www.linkedin.com/posts/williamhgates_opinion-bill-gatess-blunt-warning-on-ai-activity-7510851347110375424-v2ZO
text: >-
I appreciated the opportunity to speak with Ezra at
length about the state of AI. I believe the world
isn't awake to the dangers of this technology and the
choices humanity has to make. AI will either be the
greatest tool for opportunity and equality we've ever
seen—or the cause of immense, unprecedented harm.
Which way things go is up to us.
publishedAt: '2026-09-30T00:01:46.020Z'
likeCount: 1860
articles:
- url: >-
https://www.linkedin.com/pulse/ai-equity-choice-we-cant-delay-bill-gates-d1gte
headline: AI, equity, and the choice we can’t delay
publishedAt: '2026-09-17T15:18:20.000+00:00'
imageUrl: >-
https://media.licdn.com/dms/image/v2/D4E12AQFwjr3EOC2slQ/article-cover_image-shrink_720_1280/B4EaCvyLnRKAAQ-/0/1789655564567?e=2147483647&v=beta&t=LlizryNgZ1ezXY4ev0mnp5KI3svHbPVgHXT5gNgHwdM
likeCount: 2885
- url: >-
https://www.linkedin.com/pulse/turbulent-ai-era-here-choices-we-make-now-critical-bill-gates-kkmze
headline: >-
The turbulent AI era is here. The choices we make now
are critical.
publishedAt: '2026-08-26T07:03:26.000+00:00'
imageUrl: null
likeCount: 10704
- url: >-
https://www.linkedin.com/pulse/small-bugs-big-breakthroughs-bill-gates-rq4qe
headline: Small bugs, big breakthroughs
publishedAt: '2026-08-20T00:46:04.000+00:00'
imageUrl: null
likeCount: 3305
recommendations: []
similarProfiles:
- name: Melinda French Gates
url: https://www.linkedin.com/in/melindagates
headline: Pivotal
followers: 7M followers
location: United States
- name: Tyler Alterman
url: https://www.linkedin.com/in/tyleralterman
headline: Fractal University
followers: 7K followers
location: Brooklyn, NY
- name: Todd J. Duckett
url: https://www.linkedin.com/in/toddjduckett
headline: Duckett Enterprises
followers: 9K followers
location: Lansing, MI
fetchedAt: '2026-10-05T14:46:33.223Z'
meta:
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
creditsCharged: 1
creditsRemaining: 4999
cached: false
'401':
description: Missing, invalid, or revoked API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UNAUTHORIZED
message: API key required — pass it in the `x-api-key` header.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'402':
description: Not enough credits for this request.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: INSUFFICIENT_CREDITS
message: >-
This request costs 1 credit, but your balance is 0. Top up
to continue.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'404':
description: No public profile found (missing/private).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: NOT_FOUND
message: >-
The requested content was not found (it may not exist, be
deleted, or be private).
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'422':
description: Invalid query parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: VALIDATION_ERROR
message: Request validation failed
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
details:
- path: url
message: Required
'429':
description: Over the per-minute rate limit — honour `Retry-After`.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: RATE_LIMITED
message: >-
Rate limit exceeded — max 100 requests per 60s. Retry in
~30s.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'503':
description: >-
Temporarily unavailable — retry after `Retry-After`. `error.code`
tells you why: `UPSTREAM_BLOCKED` (the source blocked this request),
`EXTRACTION_FAILED` (the source returned unexpected data),
`PLATFORM_UNAVAILABLE` (the source is down), or
`SERVICE_UNAVAILABLE` (we are at capacity).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UPSTREAM_BLOCKED
message: >-
The source is temporarily unavailable. Please try again
shortly.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: NOT_FOUND
message:
type: string
example: The requested content was not found.
requestId:
type: string
example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
details:
type: array
items:
type: object
description: Present on validation errors.
required:
- code
- message
- requestId
required:
- error
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
Your API key. Send it in the `x-api-key` header (or `Authorization:
Bearer `). Create and manage keys from your dashboard.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.