API Reference/Endpoints

Retrieve your own profile

GET/api/linkedin/gateway/users/me

Returns the profile belonging to the connected account itself — its own headline, location, email on file, and whether it currently holds a Premium, Recruiter or Sales Navigator seat.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401. The account behind account_id must belong to your key.

Query parameters

FieldTypeDescription

account_id *stringWhich connected account to read the profile of.

Response fields

FieldTypeDescription

resultobject

{ object, provider, provider_id, first_name, last_name, headline, location, email, occupation, public_identifier, public_profile_url, premium, open_profile }

. premium and open_profile reflect the account's current LinkedIn subscription state.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key.

{ "object": "AccountOwnerProfile", "provider": "LINKEDIN", "provider_id": "ACoAAAEkwwAB9KEc2TrQgOLEQ-vzRyZeCDyc6DQ", "public_identifier": "jane-doe-mkt", "public_profile_url": "https://www.linkedin.com/in/jane-doe-mkt", "first_name": "Jane", "last_name": "Doe", "headline": "Growth Marketing Lead", "location": "Austin, Texas", "email": "jane@example.com", "occupation": "Growth Marketing Lead at Acme", "premium": true, "open_profile": false }