Skip to main content
POST
/
sourcing
/
search
Search candidate profiles
curl --request POST \
  --url https://api-service.fribl.co/api/v1/sourcing/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "query": "<string>",
  "options": {
    "high_freshness": true,
    "reveal_emails": true,
    "reveal_phones": true
  },
  "pagination": {
    "limit": 25,
    "offset": 123
  }
}
'
{
  "session_id": "<string>",
  "results": [
    {
      "docid": "john-doe-a1b2c3d4",
      "profile": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "docid": "john-doe-a1b2c3d4",
        "linkedin_slug": "john-doe-a1b2c3d4",
        "first_name": "John",
        "last_name": "Doe",
        "picture_url": "<string>",
        "title": "Senior Software Engineer at Acme Corp",
        "summary": "<string>",
        "gender": "male",
        "is_decision_maker": 123,
        "languages": [
          {
            "language": "English",
            "proficiency": "native"
          }
        ],
        "inferred_languages": [
          {
            "language": "English",
            "proficiency": "native"
          }
        ],
        "location": "Amsterdam, Netherlands",
        "location_coordinates": {
          "lat": 52.4,
          "lng": 4.9
        },
        "is_top_universities": true,
        "total_experience_years": 8,
        "estimated_age": 32,
        "expertise": [
          "python",
          "machine-learning",
          "cloud"
        ],
        "has_phone_numbers": true,
        "has_emails": true,
        "followers_count": 500,
        "connections_count": 350,
        "experiences": [
          {
            "company_info": {
              "name": "Acme Corp",
              "unique_name": "<string>",
              "domain": "acme-corp.com",
              "website": "https://www.acme-corp.com",
              "linkedin_url": "https://www.linkedin.com/company/acme-corp",
              "linkedin_slug": "acme-corp",
              "crunchbase_url": "<string>",
              "social_urls": [
                "<string>"
              ],
              "short_address": "Amsterdam, NL",
              "locations": [
                "<string>"
              ],
              "type": "company-info",
              "description": "<string>",
              "industries": [
                "Technology"
              ],
              "specialties": [
                "<string>"
              ],
              "keywords": [
                "<string>"
              ],
              "technologies": [
                "<string>"
              ],
              "founded_in": 2020,
              "num_employees": 150,
              "num_employees_range": "51-200",
              "annual_revenue": 5000000,
              "followers_count": 5000,
              "funding_total_usd": 50000000,
              "last_funding_round_year": 2023,
              "is_startup": true,
              "has_ipo": true,
              "is_b2b": true,
              "is_b2c": true,
              "is_saas": true,
              "is_hiring": true,
              "backed_by_y_combinator": true,
              "icon": "<string>"
            },
            "company_roles": [
              {
                "company": "Acme Corp",
                "company_domain": "acme-corp.com",
                "title": "Senior Software Engineer",
                "start_date": "2023-01-15",
                "end_date": "<string>",
                "duration_years": 2.5,
                "age_years": 0,
                "location": "Amsterdam, Netherlands",
                "location_info": {
                  "lat": 52.4,
                  "lng": 4.9,
                  "country_code": "NL"
                },
                "experience_summary": "<string>",
                "is_current_experience": true
              }
            ],
            "type": "company-experiences"
          }
        ],
        "educations": [
          {
            "university_linkedin_url": "https://www.linkedin.com/school/mit",
            "campus": "MIT",
            "degree": [
              "master"
            ],
            "major": "Master of Science, Computer Science",
            "start_date": "2018-09-01",
            "end_date": "2020-06-01",
            "research": "VH",
            "status": "Public",
            "focus": "CO",
            "rank": "251",
            "score": 50.2,
            "size": "L",
            "country": "United States"
          }
        ],
        "certifications": [
          {
            "title": "AWS Solutions Architect"
          }
        ],
        "publications": [
          {
            "title": "Machine Learning in Modern Applications",
            "issue": "IEEE",
            "date": "2021-03-15"
          }
        ],
        "updated_date": "2024-06-15",
        "business_emails": [
          "jsmith@example.com"
        ],
        "personal_emails": [
          "john.doe@email.com"
        ]
      },
      "score": 123,
      "insights": {}
    }
  ],
  "pagination": {
    "total_estimate": 123,
    "offset": 123,
    "limit": 123,
    "has_more": true
  }
}

Authorizations

x-api-key
string
header
required

API key in UUID format. Include this header with every authenticated request.

Body

application/json

Request body for searching candidate profiles from external sources.

query
string
required

Natural language search query describing the ideal candidate.

options
object

Search options to control result quality and data exposure.

pagination
object

Pagination settings for the search results.

Response

Search results with candidate profiles.

Response from a sourcing search operation.

session_id
string
required

Session identifier for paginating through these results.

results
object[]
required

Array of candidate search result objects.

pagination
object
required

Pagination metadata for the search results.