GET
/
api
/
search
Search People
curl --request GET \
  --url https://search.clado.ai/api/search \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "profile": {
        "id": "3917303",
        "name": "Alex Johnson",
        "location": "San Francisco, California, United States",
        "location_country": "United States",
        "location_regions": [
          "Americas",
          "Northern America",
          "AMER"
        ],
        "headline": "Senior Software Engineer at TechCorp Inc",
        "description": "Experienced software engineer specializing in machine learning and distributed systems",
        "linkedin_url": "https://www.linkedin.com/in/alexjohnson",
        "picture_permalink": "https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2",
        "connections_count": 500,
        "followers_count": 1200,
        "is_working": true,
        "is_decision_maker": false,
        "total_experience_duration_months": 48,
        "projected_total_salary": 150000,
        "post_count": 15,
        "posts": "Excited to share our latest ML research on distributed training optimization",
        "liked_posts": "Great insights on PyTorch optimization techniques",
        "recommendations": "Alex is an exceptional engineer with deep ML expertise",
        "recommendations_count": 8,
        "skills": [
          "Python",
          "Machine Learning",
          "Software Engineering",
          "Data Science"
        ]
      },
      "experience": [
        {
          "title": "Senior Software Engineer",
          "company_name": "TechCorp Inc",
          "start_date": "2021-01-01T00:00:00",
          "end_date": "1970-01-01T00:00:00",
          "description": "Working on machine learning infrastructure and scalable systems",
          "location": "San Francisco, CA"
        }
      ],
      "education": [
        {
          "degree": "Master of Science",
          "field_of_study": "Computer Science",
          "school_name": "State University",
          "start_date": "2017-09-01T00:00:00",
          "end_date": "2019-06-01T00:00:00"
        }
      ],
      "posts": [
        {
          "text": "Excited to share our latest ML research on distributed training optimization",
          "totalReactionCount": 45,
          "likeCount": 38,
          "appreciationCount": 2,
          "empathyCount": 1,
          "InterestCount": 1,
          "praiseCount": 3,
          "commentsCount": 8,
          "repostsCount": 2,
          "postUrl": "https://www.linkedin.com/feed/update/urn:li:activity:7276799769082007552/",
          "postedAt": "2w",
          "postedDate": "2024-01-15 10:30:00.000 +0000 UTC",
          "postedDateTimestamp": 1705315800000,
          "reposted": false,
          "urn": "7276799769082007552",
          "author": {
            "firstName": "Alex",
            "lastName": "Johnson",
            "username": "alexjohnson",
            "url": "https://www.linkedin.com/in/alexjohnson"
          },
          "image": [],
          "mentions": [],
          "companyMentions": [
            {
              "id": 12345,
              "name": "TechCorp Inc",
              "publicIdentifier": "techcorp-inc",
              "url": "https://www.linkedin.com/company/techcorp-inc/"
            }
          ],
          "isBrandPartnership": false
        }
      ]
    }
  ],
  "total": 1,
  "query": "software engineers at tech companies"
}
Search through millions of LinkedIn profiles using natural language queries. This endpoint provides fast searching with AI-powered relevance matching.

Search People

curl -X GET "https://search.clado.ai/api/search?query=software engineers in San Francisco&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

ParameterTypeRequiredDescription
querystringYesNatural language search query
limitintegerNoMaximum number of results (default: 30, max: 100)

Examples

Basic Search:
curl -X GET "https://search.clado.ai/api/search?query=data scientists at startups" \
  -H "Authorization: Bearer YOUR_API_KEY"
Search with Limit:
curl -X GET "https://search.clado.ai/api/search?query=product managers&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "results": [
    {
      "profile": {
        "id": "3917303",
        "name": "Alex Johnson",
        "location": "San Francisco, CA",
        "headline": "Senior Software Engineer at TechCorp Inc",
        "description": "Experienced software engineer specializing in machine learning and distributed systems",
        "linkedin_url": "https://www.linkedin.com/in/alexjohnson"
      },
      "experience": [
        {
          "title": "Senior Software Engineer",
          "company_name": "TechCorp Inc",
          "start_date": "2021-01-01T00:00:00",
          "end_date": "1970-01-01T00:00:00",
          "description": "Working on machine learning infrastructure and scalable systems",
          "location": "San Francisco, CA"
        }
      ],
      "education": [
        {
          "degree": "Master of Science",
          "field_of_study": "Computer Science",
          "school_name": "State University",
          "start_date": "2017-09-01T00:00:00",
          "end_date": "2019-06-01T00:00:00"
        }
      ]
    }
  ],
  "total": 1,
  "query": "software engineers in San Francisco"
}

Query Examples

QueryDescription
”software engineers at major tech companies”Find engineers at leading technology companies
”product managers with MBA”Find PMs with MBA education
”founders in fintech”Find startup founders in financial technology
”data scientists with PhD”Find PhD-level data scientists
”marketing directors in healthcare”Find marketing leaders in health industry

Error Responses

Status CodeDescription
400Bad Request - Invalid parameters or limit exceeded
401Unauthorized - API key missing or invalid
422Validation Error - Missing required ‘query’ parameter
500Internal Server Error - Search processing error
503Service Unavailable - Search service temporarily down

Notes

  • This endpoint costs 5 credits per request
  • Rate limited to 20 requests per minute per API key
  • End date of “1970-01-01T00:00:00” indicates current position
  • Results are ranked by AI-powered relevance matching

Authorizations

Authorization
string
header
required

API key authentication. Keys start with 'lk_'.

Query Parameters

query
string
required

Natural language search query to find LinkedIn profiles (e.g., 'software engineers at tech companies', 'product managers with MBA')

limit
integer
default:30

Maximum number of profiles to return in the response (1-100)

Required range: 1 <= x <= 100

Response

200
application/json

Successful response

The response is of type object.