Reverse Contact Reverse Contact
Sign Up

Profile

9 min read

Retrieve a complete professional profile from a Social URL.

POST
Sign up to try

Introduction

The Person Profile endpoint retrieves a complete professional profile from a Social URL. It returns structured data including work experience, education, skills, certifications, and more.

Authorization

apikey string required
Your API key from the developer dashboard. Pass it via Authorization: Bearer YOUR_API_KEY header.

Request body

Provide either url or id. If both are supplied, id takes precedence.

url string conditional
Public Social profile URL (e.g. https://social.com/in/janedoe). Required unless id is given.
id string conditional
ReverseContact person id from a previous response (e.g. prs_01jbd5vewyenebxgaz869ffe5t). Required unless url is given.

Response structure

success boolean
true if the request was processed successfully
error null
Always null on success
dataobject
The enriched person profile (null on error responses)
Show child attributesHide child attributes
id string
ReverseContact person id (prs_...). Pass it back as the id request parameter to re-fetch this profile
publicId string
Social public identifier (the /in/xxx slug)
memberId string
Social internal member ID
linkedinUrl string
Full Social profile URL
firstName string | null
First name
lastName string | null
Last name
headline string | null
Profile headline
summary string | null
About / summary section
pronoun string | null
Preferred pronoun (e.g. "she/her", "he/him")
isOpenToWork boolean
Whether the person is open to work
hasPremium boolean
Whether the person has Social Premium
hasVerificationBadge boolean
Whether the profile is verified
isInRemembrance boolean
Whether the profile is memorialised
photoUrl string | null
Profile photo URL
backgroundUrl string | null
Background / banner image URL
creationDate string | null
Account creation date (ISO 8601)
followersCount number | null
Number of followers
connectionsCount number | null
Number of connections
skills string[]
List of skill names
locationobject
Geographic location
Show child attributesHide child attributes
city string | null
City name
state string | null
State or region
country string | null
Country name
countryCode string | null
ISO country code (e.g. "US")
rawLocation string | null
Raw, unparsed location label

Note

When a profile lists several jobs, the current position is selected — and the experience and education lists are ordered — by fixed, predictable rules. See Current position and work history ordering.

currentPositionobject
Current job position (null if no current position)
Show child attributesHide child attributes
title string | null
Job title
description string | null
Role description
contractType string | null
Contract type (e.g. "Permanent", "Internship")
companyName string | null
Company name
companyLinkedinId string | null
Company Social internal identifier
companyUrl string | null
Company Social profile URL
companyLocation string | null
Company location
companyLogoUrl string | null
Company logo URL
startEndDate DateRange | null
Position duration
startEndDateobject
Period boundaries
Show child attributesHide child attributes
start string | null
Start date (ISO 8601)
end string | null
End date (ISO 8601, null if ongoing)
experienceobject[]
Professional experiences
Show child attributesHide child attributes
title string | null
Job title
description string | null
Role description
contractType string | null
Contract type (e.g. "Permanent", "Internship")
companyName string | null
Company name
companyLinkedinId string | null
Company Social internal identifier
companyUrl string | null
Company Social profile URL
companyLocation string | null
Company location
companyLogoUrl string | null
Company logo URL
startEndDate DateRange | null
Position duration
startEndDateobject
Period boundaries
Show child attributesHide child attributes
start string | null
Start date (ISO 8601)
end string | null
End date (ISO 8601, null if ongoing)
educationobject[]
Education history
Show child attributesHide child attributes
degreeName string | null
Degree name (e.g. "B.S.")
fieldOfStudy string | null
Field of study
description string | null
Additional description
grade string | null
Reported grade
schoolName string | null
School name
schoolUrl string | null
School Social profile URL
schoolLogoUrl string | null
School logo URL
startEndDate DateRange | null
Education period
startEndDateobject
Period boundaries
Show child attributesHide child attributes
start string | null
Start date (ISO 8601)
end string | null
End date (ISO 8601, null if ongoing)
languagesobject[]
Spoken languages
Show child attributesHide child attributes
language string | null
Language name
proficiency string | null
Proficiency level (e.g. "Native", "Professional working")
certificationsobject[]
Professional certifications
Show child attributesHide child attributes
name string | null
Certification name
organizationName string | null
Issuing organization
organizationUrl string | null
Organization Social profile URL
issuedDate string | null
Issue date (ISO 8601)
recommendationsobject[]
Received recommendations
Show child attributesHide child attributes
caption string | null
Short caption / role of the recommender
description string | null
Recommendation text
authorFullname string | null
Full name of the recommender
authorUrl string | null
Recommender Social profile URL
testScoresobject[]
Standardized test scores
Show child attributesHide child attributes
testTitle string | null
Test name
score string | null
Score value
date string | null
Date taken (ISO 8601)
quotasobject
Credits and rate limit usage after this request
Show child attributesHide child attributes
creditsConsumed number
Credits consumed by this request
workspaceobject
Workspace-level limits
Show child attributesHide child attributes
id string
Your workspace identifier
hasUnlimitedCredits boolean
Whether workspace credits are unlimited
allowDailyOvercost boolean
Whether the workspace may exceed its daily cap
creditsobject
Credit balance
Show child attributesHide child attributes
total number
Total credits in your plan
used number
Credits consumed so far
left number
Remaining credits
dailyLimitobject
Daily request limit (null if not configured)
Show child attributesHide child attributes
limit number
Maximum requests per day
used number
Requests made today
left number
Remaining requests today
nextReset string
When the daily window resets (ISO 8601)
minuteRateLimitobject
Per-minute rate limit
Show child attributesHide child attributes
limit number
Maximum requests per minute
used number
Requests made in the current minute
left number
Remaining requests in the current minute
nextReset string
When the minute window resets (ISO 8601)
keyobject
API key-level limits (null when request is from dashboard)
Show child attributesHide child attributes
id string
API key identifier
dailyLimitobject
Daily limit for this key (null if not configured)
Show child attributesHide child attributes
limit number
Maximum requests per day
used number
Requests made today
left number
Remaining requests today
nextReset string
When the daily window resets (ISO 8601)
minuteRateLimitobject
Minute rate limit for this key
Show child attributesHide child attributes
limit number
Maximum requests per minute
used number
Requests made in the current minute
left number
Remaining requests in the current minute
nextReset string
When the minute window resets (ISO 8601)
metadataobject
Request tracking information
Show child attributesHide child attributes
requestId string
Unique identifier for this request
executionTimeMs number
Total execution time in milliseconds
updatedAt string
Last upstream update timestamp (ISO 8601). Only present when data is from cache.

Previous

Company search

Next

Profile live