Advanced sourcing profile search

Advanced sourcing endpoint for finding professional profiles through Leonar’s extended sourcing network. The underlying provider is abstracted by Leonar and may evolve without affecting your integration.

The response is normalized to Leonar’s sourcing profile format and does not expose provider-specific fields.

Credits

This endpoint is gated by sourcing credits, a separate balance from the regular enrichment credits and provisioned by your Leonar account manager.

• One sourcing credit is consumed for every profile returned by a search.
• Requests that return zero profiles do not consume any credit.
• When the workspace has no remaining sourcing credits, the request returns 402 insufficient_credits and no upstream search is performed.
• Each successful response includes credits_consumed and sourcing_credits_remaining so your integration can track usage.

Rate limiting

Unlike other endpoints, this one is not subject to the global per-API-key rate limit of 2000 requests/hour. Throughput is gated by the sourcing credit balance and upstream availability. Standard X-RateLimit-* response headers are not returned for this endpoint.

Pagination

Pagination is page-based. Send page: 1 for the first page, then use the returned next_page value while has_more is true.

Exact LinkedIn profile lookup

To resolve one known LinkedIn profile, send its public profile URL in linkedin_url. This field must be used on its own and accepts regular linkedin.com/in/... or linkedin.com/pub/... URLs. Sales Navigator and Recruiter URLs are not supported. Exact lookups return at most one profile and use the same normalized response and sourcing-credit accounting as a regular advanced search.

Required scope

The API key must include the sourcing:read scope.

POST /sourcing/advanced/profiles/search

Advanced sourcing profile search

cURL

curl --request POST \
  --url https://app.leonar.app/api/v1/sourcing/advanced/profiles/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_title": [
    "VP of Product",
    "Head of Product"
  ],
  "company": [
    "Stripe",
    "Datadog"
  ],
  "location": [
    "Paris, France",
    "London, United Kingdom"
  ],
  "skills": [
    "SaaS",
    "Product Management"
  ],
  "company_filter": "current",
  "data_types": [
    "personal_email",
    "work_email"
  ],
  "reveal_info": true,
  "page": 1
}
'

import requests

url = "https://app.leonar.app/api/v1/sourcing/advanced/profiles/search"

payload = {
    "job_title": ["VP of Product", "Head of Product"],
    "company": ["Stripe", "Datadog"],
    "location": ["Paris, France", "London, United Kingdom"],
    "skills": ["SaaS", "Product Management"],
    "company_filter": "current",
    "data_types": ["personal_email", "work_email"],
    "reveal_info": True,
    "page": 1
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    job_title: ['VP of Product', 'Head of Product'],
    company: ['Stripe', 'Datadog'],
    location: ['Paris, France', 'London, United Kingdom'],
    skills: ['SaaS', 'Product Management'],
    company_filter: 'current',
    data_types: ['personal_email', 'work_email'],
    reveal_info: true,
    page: 1
  })
};

fetch('https://app.leonar.app/api/v1/sourcing/advanced/profiles/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.leonar.app/api/v1/sourcing/advanced/profiles/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'job_title' => [
        'VP of Product',
        'Head of Product'
    ],
    'company' => [
        'Stripe',
        'Datadog'
    ],
    'location' => [
        'Paris, France',
        'London, United Kingdom'
    ],
    'skills' => [
        'SaaS',
        'Product Management'
    ],
    'company_filter' => 'current',
    'data_types' => [
        'personal_email',
        'work_email'
    ],
    'reveal_info' => true,
    'page' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.leonar.app/api/v1/sourcing/advanced/profiles/search"

	payload := strings.NewReader("{\n  \"job_title\": [\n    \"VP of Product\",\n    \"Head of Product\"\n  ],\n  \"company\": [\n    \"Stripe\",\n    \"Datadog\"\n  ],\n  \"location\": [\n    \"Paris, France\",\n    \"London, United Kingdom\"\n  ],\n  \"skills\": [\n    \"SaaS\",\n    \"Product Management\"\n  ],\n  \"company_filter\": \"current\",\n  \"data_types\": [\n    \"personal_email\",\n    \"work_email\"\n  ],\n  \"reveal_info\": true,\n  \"page\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.leonar.app/api/v1/sourcing/advanced/profiles/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"job_title\": [\n    \"VP of Product\",\n    \"Head of Product\"\n  ],\n  \"company\": [\n    \"Stripe\",\n    \"Datadog\"\n  ],\n  \"location\": [\n    \"Paris, France\",\n    \"London, United Kingdom\"\n  ],\n  \"skills\": [\n    \"SaaS\",\n    \"Product Management\"\n  ],\n  \"company_filter\": \"current\",\n  \"data_types\": [\n    \"personal_email\",\n    \"work_email\"\n  ],\n  \"reveal_info\": true,\n  \"page\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.leonar.app/api/v1/sourcing/advanced/profiles/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"job_title\": [\n    \"VP of Product\",\n    \"Head of Product\"\n  ],\n  \"company\": [\n    \"Stripe\",\n    \"Datadog\"\n  ],\n  \"location\": [\n    \"Paris, France\",\n    \"London, United Kingdom\"\n  ],\n  \"skills\": [\n    \"SaaS\",\n    \"Product Management\"\n  ],\n  \"company_filter\": \"current\",\n  \"data_types\": [\n    \"personal_email\",\n    \"work_email\"\n  ],\n  \"reveal_info\": true,\n  \"page\": 1\n}"

response = http.request(request)
puts response.read_body

200

Example

{
  "data": {
    "profiles": [
      {
        "profile_id": "jane-doe",
        "first_name": "Jane",
        "last_name": "Doe",
        "headline": "VP of Product at ExampleCo",
        "location": "Paris, France",
        "linkedin_url": "https://www.linkedin.com/in/jane-doe",
        "summary": "Product leader with B2B SaaS experience.",
        "current_job": {
          "title": "VP of Product",
          "company_name": "ExampleCo"
        },
        "experiences": [
          {
            "title": "VP of Product",
            "company_name": "ExampleCo",
            "company_domain": "example.com",
            "start_date": "2021",
            "end_date": null,
            "description": null,
            "is_current": true
          }
        ],
        "educations": [
          {
            "educational_establishment": "HEC Paris",
            "diploma": "MBA",
            "specialization": null,
            "start_date": "2015",
            "end_date": "2017"
          }
        ],
        "skills": [
          "SaaS",
          "Product Management"
        ],
        "open_to_work": false
      }
    ],
    "total_count": 45,
    "filtered_count": 1,
    "next_page": 2,
    "has_more": true,
    "filters_too_strict": false,
    "credits_consumed": 1,
    "sourcing_credits_remaining": 499,
    "request_id": "req_123",
    "leonar_profiles_cached": 1
  }
}

Authorizations

Authorization · string · header · required

API key starting with leo_

Body

application/json

page · integer · default: 1

Results page to return.

Required range: x >= 1

name · string

Full or partial profile name.

Maximum string length: 200

linkedin_url · string<uri>

Public LinkedIn profile URL for an exact lookup. Must be used without any other search filter. Supports linkedin.com/in/... and linkedin.com/pub/... URLs only.

Maximum string length: 500

job_title · string[]

Job titles to include.

Maximum array length: 50

exclude_job_titles · string[]

Job titles to exclude.

Maximum array length: 50

current_titles_only · boolean · default: true

Returns profiles matching the current job title by default. Set to false to return profiles matching current or past job titles. Do not combine with match_experience.

include_related_job_titles · boolean

Include related job titles when matching title filters.

job_function · string[]

Job functions to include.

Maximum array length: 50

seniority · string[]

Seniority levels to include.

Maximum array length: 50

match_experience · enum<string>

Controls how title and company filters are matched against profile experience entries. Do not combine with current_titles_only or company_filter.

Available options: current, past, both

skills · string[]

Skills to include. Boolean syntax may be used in values.

Maximum array length: 50

languages · object[]

Languages to include, optionally with proficiency filters.

Maximum array length: 50

Show child attributes

education · string[]

Schools or institutions to include.

Maximum array length: 50

educations · object[]

Structured education filters.

Maximum array length: 50

Show child attributes

location · string[]

Locations to include.

Maximum array length: 50

location_radius · integer

Radius around the provided locations.

Required range: 1 <= x <= 500

current_work_location · string[]

Current work locations to include.

Maximum array length: 50

past_work_location · string[]

Past work locations to include.

Maximum array length: 50

company · string[]

Companies to include.

Maximum array length: 50

company_filter · enum<string>

Controls whether company filters match current roles, past roles, or both. Do not combine with match_experience.

Available options: current, past, both

current_company_only · boolean

Restrict company matching to current companies.

exclude_companies · string[]

Companies to exclude.

Maximum array length: 50

domain · string[]

Company domains to include.

Maximum array length: 50

industry · string[]

Industries to include.

Maximum array length: 50

company_size · string[]

Company size buckets, e.g. 11_50, 51_200, 201_500.

Maximum array length: 50

keyword · string

Free-text keyword or boolean keyword expression.

Maximum string length: 500

years_of_experience · string[]

Experience ranges, e.g. 2_5, 6_10, or 10.

Maximum array length: 50

years_in_current_role · string[]

Current-role tenure ranges, e.g. 2_5, 6_10, or 10.

Maximum array length: 50

data_types · enum<string>[]

Optional contact data types to retrieve with profiles.

Maximum array length: 3

Available options: personal_email, work_email, phone

reveal_info · boolean

Whether to attempt revealing contact details on returned profiles.

detailed_experience · boolean

Whether to request detailed experience data.

detailed_education · boolean

Whether to request detailed education data.

output_fields · string[]

Optional fields to request from the sourcing network.

Maximum array length: 50

Response

200

application/json

Normalized profile search results. The response includes profiles, pagination information, sourcing credits consumed by this call, and the workspace's remaining sourcing credit balance.

data · object

Show child attributes