Profile APIs
Get Profile Data By URL
GET
/get-profile-data-by-url$0.009/calljson responserest · mcp
01// about this endpoint
Look up a full professional profile using a LinkedIn profile URL. Accepts the standard linkedin.com/in/ URL format and returns the same comprehensive profile data as the username-based endpoint. Ideal for agents processing LinkedIn URLs from resumes, email signatures, CRM fields, or web scraping results.
02// code samples
Call it over REST
Authenticate with a bearer token against https://api.superagnt.com. Swap the placeholders for your key and parameter values.
curlbash
curl -s "https://api.superagnt.com/get-profile-data-by-url?url=<url>" \
-H "Authorization: Bearer <YOUR_AGNTDATA_API_KEY>"03// give it to your agent
Copy-paste prompt
Paste this into a coding agent. It connects the superagnt MCP server, finds the tool data_linkedin_get_profile_data_by_url, and runs a first call — with the REST fallback if MCP is unavailable.
agent prompttext
You are wiring up the superagnt "LinkedIn" API to use this endpoint: Get Profile Data By URL.
1. CONNECT over MCP (preferred). No token to paste either way.
On Claude (claude.ai, the desktop app, or Claude Code signed in with a Claude
account), the server is a connector: give the user this link, they click Add
and approve:
https://claude.ai/customize/connectors/yours?modal=add-custom-connector&connectorName=superagnt&connectorUrl=https%3A%2F%2Fmcp.superagnt.com%2Fmcp&open_in_browser=1
Any other MCP client (or Claude Code signed in with an API key): add the server
and let the client run the browser sign-in:
claude mcp add --scope user --transport http superagnt https://mcp.superagnt.com/mcp
claude mcp login superagnt
MCP endpoint: https://mcp.superagnt.com/mcp
After connecting, the tool you want is named exactly:
data_linkedin_get_profile_data_by_url
Call agnt_tools_search or agnt_tools_list_enabled to confirm it is available.
2. REST fallback (if you are not using MCP):
GET https://api.superagnt.com/get-profile-data-by-url
Header: Authorization: Bearer <YOUR_AGNTDATA_API_KEY>
Required parameters:
- url (string, required)
Optional parameters:
- (none)
3. COST & KEY. Each successful call costs $0.009 in credits. Only successful calls are charged.
Get a superagnt API key at https://app.superagnt.com.
4. TEST. Connect the server (or set the key), discover the tool
(data_linkedin_get_profile_data_by_url), run one minimal call with just the required parameters,
and report back the shape of the JSON response (top-level fields).
Reference (machine-readable variant): https://www.superagnt.com/docs/apis/social/linkedin/endpoints/Get_Profile_Data_By_URL.mdmcp tool definitionjson
{
"name": "get_profile_data_by_url",
"description": "Get all profile data, including experience, skills, language, education, course, and companies, **open to work** status, hiring status, location. Check **Example Responses** for more details",
"parameters": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "query parameter",
"default": "https://www.linkedin.com/in/adamselipsky/"
}
},
"required": [
"url"
]
}
}04// parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
url | query | string | required |
05// responses
OK
200json
{
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"urn": {
"type": "string"
},
"username": {
"type": "string"
},
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"isTopVoice": {
"type": "boolean"
},
"isCreator": {
"type": "boolean"
},
"isPremium": {
"type": "boolean"
},
"profilePicture": {
"type": "string"
},
"backgroundImage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"url": {
"type": "string"
}
}
}
},
"summary": {
"type": "string"
},
"headline": {
"type": "string"
},
"geo": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"city": {
"type": "string"
},
"full": {
"type": "string"
},
"countryCode": {
"type": "string"
}
}
},
"educations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"start": {
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"day": {
"type": "integer"
}
}
},
"end": {
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"day": {
"type": "integer"
}
}
},
"fieldOfStudy": {
"type": "string"
},
"degree": {
"type": "string"
},
"grade": {
"type": "string"
},
"schoolName": {
"type": "string"
},
"description": {
"type": "string"
},
"activities": {
"type": "string"
},
"url": {
"type": "string"
},
"schoolId": {
"type": "string"
},
"logo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
}
}
}
}
}
},
"position": {
"type": "array",
"items": {
"type": "object",
"properties": {
"companyId": {
"type": "integer"
},
"companyName": {
"type": "string"
},
"companyUsername": {
"type": "string"
},
"companyURL": {
"type": "string"
},
"companyLogo": {
"type": "string"
},
"companyIndustry": {
"type": "string"
},
"companyStaffCountRange": {
"type": "string"
},
"title": {
"type": "string"
},
"multiLocaleTitle": {
"type": "object",
"properties": {
"en_US": {
"type": "string"
}
}
},
"multiLocaleCompanyName": {
"type": "object",
"properties": {
"en_US": {
"type": "string"
}
}
},
"location": {
"type": "string"
},
"description": {
"type": "string"
},
"employmentType": {
"type": "string"
},
"start": {
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"day": {
"type": "integer"
}
}
},
"end": {
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"day": {
"type": "integer"
}
}
}
}
}
},
"fullPositions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"companyId": {
"type": "integer"
},
"companyName": {
"type": "string"
},
"companyUsername": {
"type": "string"
},
"companyURL": {
"type": "string"
},
"companyLogo": {
"type": "string"
},
"companyIndustry": {
"type": "string"
},
"companyStaffCountRange": {
"type": "string"
},
"title": {
"type": "string"
},
"multiLocaleTitle": {
"type": "object",
"properties": {
"en_US": {
"type": "string"
}
}
},
"multiLocaleCompanyName": {
"type": "object",
"properties": {
"en_US": {
"type": "string"
}
}
},
"location": {
"type": "string"
},
"description": {
"type": "string"
},
"employmentType": {
"type": "string"
},
"start": {
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"day": {
"type": "integer"
}
}
},
"end": {
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"month": {
"type": "integer"
},
"day": {
"type": "integer"
}
}
}
}
}
},
"skills": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"passedSkillAssessment": {
"type": "boolean"
},
"endorsementsCount": {
"type": "integer"
}
}
}
},
"projects": {
"type": "object"
},
"supportedLocales": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"language": {
"type": "string"
}
}
}
},
"multiLocaleFirstName": {
"type": "object",
"properties": {
"en": {
"type": "string"
}
}
},
"multiLocaleLastName": {
"type": "object",
"properties": {
"en": {
"type": "string"
}
}
},
"multiLocaleHeadline": {
"type": "object",
"properties": {
"en": {
"type": "string"
}
}
}
}
}06// pricing
$0.009per successful request
Credits are deducted from your superagnt balance on each successful call. Failed requests (4xx/5xx) are not charged.
Get started at app.superagnt.com.
08// more from LinkedIn
GETGet Company By Domain/get-company-by-domainGETGet Company Details by ID/get-company-details-by-idGETGet Company Details/get-company-detailsPOSTGet Profile School Interests/profiles/interests/schoolsPOSTGet Profile Newsletter Interests/profiles/interests/newslettersGETGet Similar Profiles/similar-profiles
start calling
Point your client at https://mcp.superagnt.com/mcp and your agent has this endpoint, plus every other source on one balance.
LinkedIn URL profile lookupprofile by URL APILinkedIn URL enrichmentparse LinkedIn profile URLLinkedIn APILinkedIn data APILinkedIn scraper API