Search for Users

Search for LinkedIn user profiles using natural language queries with criteria-based matching

Search through millions of LinkedIn profiles using natural language queries. The system uses AI-powered criteria matching with a customizable acceptance threshold to find the most relevant profiles.

Search Users

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

Query Parameters

Parameter	Type	Required	Description
query	string	Yes	Natural language search query
limit	integer	No	Maximum number of results (default: 30, max: 100)
school	array	No	Filter by school names
company	array	No	Filter by company names (current or past employers)
acceptance_threshold	integer	No	Match score threshold 0-100 (default: 73)

Examples

Basic Search:

curl -X GET "https://search.clado.ai/api/search/users?query=data scientists at startups" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search with School Filter:

curl -X GET "https://search.clado.ai/api/search/users?query=product managers&school=Stanford University&school=Harvard University" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search with Company Filter:

curl -X GET "https://search.clado.ai/api/search/users?query=software engineers&company=Google&company=Facebook&company=Apple" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search with Both School and Company Filters:

curl -X GET "https://search.clado.ai/api/search/users?query=machine learning engineers&school=MIT&school=Stanford University&company=Google&company=OpenAI" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search with Custom Threshold:

curl -X GET "https://search.clado.ai/api/search/users?query=AI researchers&acceptance_threshold=85" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "results": [
    {
      "profile": {
        "id": "3917303",
        "name": "John Doe",
        "location": "San Francisco, CA",
        "headline": "Senior Software Engineer at Google",
        "description": "Experienced software engineer specializing in machine learning...",
        "title": "Senior Software Engineer",
        "profile_picture_url": "https://media.licdn.com/dms/image/example.jpg",
        "linkedin_url": "https://www.linkedin.com/in/johndoe",
        "twitter_handle": "johndoe",
        "websites": [
          {
            "url": "https://johndoe.com"
          }
        ],
        "criteria": {
          "Works as software engineer": "YES",
          "Located in San Francisco": "YES",
          "Has AI/ML experience": "MAYBE"
        }
      },
      "experience": [
        {
          "title": "Senior Software Engineer",
          "company_name": "Google",
          "start_date": "2021-01-01T00:00:00",
          "end_date": "1970-01-01T00:00:00",
          "description": "Working on machine learning infrastructure...",
          "location": "San Francisco, CA",
          "company_logo": "https://media.licdn.com/dms/image/google-logo.jpg"
        }
      ],
      "education": [
        {
          "degree": "Master of Science",
          "field_of_study": "Computer Science",
          "school_name": "Stanford University",
          "school_logo": "https://media.licdn.com/dms/image/stanford-logo.jpg",
          "start_date": "2017-09-01T00:00:00",
          "end_date": "2019-06-01T00:00:00",
          "description": "Specialized in machine learning and AI"
        }
      ],
      "languages": ["English", "Spanish"]
    }
  ],
  "total": 1,
  "query": "software engineers in San Francisco"
}

Query Examples

Query	Description
”software engineers at FAANG companies”	Find engineers at Facebook, Apple, Amazon, Netflix, Google
”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 Code	Description
400	Bad Request - Invalid parameters or limit exceeded
401	Unauthorized - API key missing or invalid
402	Payment Required - Insufficient credits
422	Validation Error - Missing required ‘query’ parameter
500	Internal Server Error - Search processing error
503	Service Unavailable - Search service temporarily down

Notes

• Each result costs 1 credit
• Profiles are matched using AI-powered criteria evaluation
• Criteria show match confidence: YES, MAYBE, NO
• End date of “1970-01-01T00:00:00” indicates current position
• Higher acceptance thresholds return fewer but more relevant results
• School filter supports multiple values for OR logic
• Company filter supports multiple values for OR logic and searches both current and past employers

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

query · string · required

Natural language search query

limit · integer · default: 10

Maximum number of results (default: 30, max: 100)

Required range: x <= 100

school · string[]

Filter by school names

company · string[]

Filter by company names (current or past employers)

acceptance_threshold · integer · default: 73

Minimum match score threshold (0-100). Defaults to 73.

Required range: 0 <= x <= 100

Response

200

application/json

Successful search operation

The response is of type object.