Search Candidates

Find candidates in our global database before creating detailed reports. Use the returned candidateId with the Create Lookup endpoint.

GET https://api.whitebridge.ai/search

Query Parameters

Parameter	Type	Required	Description
query	string	Yes	Search term (name, email, phone, or social media URL)
type	string	Yes	Platform to search: linkedin, facebook, instagram, x, tiktok
next	string	No	Pagination cursor from previous response

Example

GET https://api.whitebridge.ai/search?query=Joe+Doe&type=linkedin

Response

{
  "results": [
    {
      "candidateId": "li-joe-doe-example",
      "avatarUrl": "https://cdn.whitebridge.ai/images/joe-doe-example.jpg",
      "fullName": "Joe Doe",
      "fragments": [
        "Software Engineer",
        "CyberSecure Inc.",
        "New York, USA"
      ]
    }
  ],
  "next": "eyJjb3VudCI6MTAsInRvdGFsIjoxNiwic3RhcnQiOjksInBh",
  "status": "success"
}

Response Fields:

• results - Array of matching candidates
• candidateId - Use this ID to create lookups
• fragments - Additional context (job title, company, location)
• next - Pagination cursor for more results