Skip to main content
GET
Search People
Search through millions of LinkedIn profiles using natural language queries. This endpoint provides fast searching with AI-powered relevance matching, pagination support for large result sets, and optional agent-based filtering for higher quality results.
🚨 DEPRECATION NOTICE: The legacy response format will be deprecated on November 1st, 2025. The legacy parameter currently defaults to true but will be removed. Please migrate to the modern format by setting legacy=false. See https://docs.clado.ai/api-reference/changelog for migration details.

Search People

Query Parameters

Examples

Basic Search:
Search with Limit:
Search with Advanced Filtering:
Continue Search with Pagination:

Response

Query Examples

Rate Limits

Rate limits vary by subscription tier:
  • Free Tier: 5 requests per minute
  • Tier 1: 20 requests per minute
  • Tier 2: 200 requests per minute
  • Tier 3: 400 requests per minute

Error Responses

Notes

  • This endpoint costs 5 credits per request (standard search)
  • When advanced_filtering is enabled: 1 credit per result returned (no base charge)
  • End date of “1970-01-01T00:00:00” indicates current position
  • Results are ranked by AI-powered relevance matching
  • When advanced_filtering is enabled:
    • An AI agent reviews and filters results after the initial search
    • You may receive fewer results than the requested limit due to quality filtering
    • Results will have higher relevance and quality but may take slightly longer to process
    • Only pay for results that pass the AI filtering (1 credit per result)

Pagination

  • Every search returns a search_id that can be used to paginate through results
  • Use the search_id with the offset parameter to get subsequent pages
  • The same search criteria and OpenSearch query are reused for pagination
  • Pagination requests with search_id do not require the original query parameter
  • Results maintain consistent ordering across paginated requests
  • Example: To get results 21-40, use search_id from the initial search with offset=20 and limit=20

Authorizations

Authorization
string
header
required

API key authentication. Keys start with 'lk_'.

Query Parameters

query
string

Natural language search query to find LinkedIn profiles (e.g., 'software engineers at tech companies', 'product managers with MBA'). Required for new searches, optional when using search_id for continuation

limit
integer
default:30

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

Required range: 1 <= x <= 100
companies
string[]

List of company names to filter results by

schools
string[]

List of school names to filter results by

advanced_filtering
boolean
default:true

Enable AI agent-based filtering to improve result quality. When enabled, an AI agent reviews all results before returning them, which may return fewer results than the requested limit but with higher relevance and quality

search_id
string<uuid>

ID from a previous search to continue pagination. When provided, uses the same search criteria and query from the original search

offset
integer
default:0

Number of results to skip for pagination. Used with search_id to get subsequent pages of results

Required range: x >= 0
legacy
boolean
default:true

DEPRECATED: Return results in legacy format (default: true). Will be removed November 1st, 2025

Response

Successful response

results
object[]

Array of user profiles matching the search query

total
integer

Total number of profiles found

query
string

The search query that was executed

search_id
string<uuid>

Unique identifier for this search. Use this with offset parameter to paginate through results