Complete LinkedIn Profile Retrieval

Extract detailed profile data and posts with comments from LinkedIn profiles

Extract comprehensive profile data including posts, comments, and engagement metrics directly from LinkedIn profiles. This endpoint fetches real-time data with detailed post interactions.

Scrape Profile

curl -X GET "https://search.clado.ai/api/enrich/scrape?linkedin_url=https://www.linkedin.com/in/johndoe" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

Parameter	Type	Required	Description
linkedin_url	string	Yes	LinkedIn profile URL to scrape

Response

{
  "data": {
    "name": "John Doe",
    "headline": "Senior Software Engineer at Google",
    "location": "San Francisco, CA",
    "connection_count": 500,
    "posts": [
      {
        "urn": "7322384544848834560",
        "text": "Excited to announce our new AI product launch...",
        "createdAt": 1679012345,
        "createdAtString": "2024-03-20T12:34:56Z",
        "comments": [
          {
            "isPinned": false,
            "isEdited": false,
            "threadUrn": "thread123",
            "createdAt": 1679012346,
            "createdAtString": "2024-03-20T12:34:57Z",
            "permalink": "https://linkedin.com/feed/comment/thread123",
            "text": "Congratulations on the launch!",
            "author": {
              "name": "Jane Smith",
              "headline": "Product Manager at Meta"
            }
          }
        ],
        "comment_metadata": {
          "total": 15,
          "totalPage": 3,
          "paginationToken": "abc123"
        }
      }
    ]
  }
}

Response Fields

Profile Fields

Field	Type	Description
name	string	Full name of the person
headline	string	Professional headline or tagline
location	string	Current location
connection_count	integer	Number of LinkedIn connections
posts	array	Array of post objects

Post Object

Field	Type	Description
urn	string	Unique identifier for the post
text	string	Post content/text
createdAt	integer	Post creation timestamp (Unix)
createdAtString	string	Formatted post creation date
comments	array	Array of comment objects
comment_metadata	object	Comment pagination information

Comment Object

Field	Type	Description
isPinned	boolean	Whether the comment is pinned
isEdited	boolean	Whether the comment was edited
threadUrn	string	Unique identifier for the comment thread
createdAt	integer	Comment creation timestamp (Unix)
createdAtString	string	Formatted comment creation date
permalink	string	Direct URL to the comment
text	string	Comment content
author	object	Comment author information

Comment Metadata

Field	Type	Description
total	integer	Total number of comments on the post
totalPage	integer	Total number of comment pages
paginationToken	string	Token for loading additional comments

Error Responses

Status Code	Description
400	Bad Request - Invalid LinkedIn URL format
401	Unauthorized - API key missing or invalid
402	Payment Required - Insufficient credits (costs 2 credits)
422	Validation Error - Missing required ‘linkedin_url’ parameter
500	Internal Server Error - Error processing request or endpoint unavailable

Notes

• Each request costs 2 credits
• Automatically fetches comments for all posts
• Posts are sorted by creation date (most recent first)
• Comment pagination allows loading additional comments if needed
• Real-time data fetched directly from LinkedIn
• Profile must be public or connection accessible
• Rate limits may apply based on usage
• Username is extracted automatically from LinkedIn URL

Authorizations

Authorization · string · header · required

API key must be provided as a Bearer token in the Authorization header. Example: lk_your_api_key_here

Query Parameters

linkedin_url · string · required

The LinkedIn profile URL to scrape.

Response

200

application/json

Successful scraping operation

The response is of type object.