Search leads

POST

https://ext.gojiberry.ai

directory

leads

Search leads (free preview)

curl --request POST \
  --url https://ext.gojiberry.ai/v1/directory/leads/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": 25,
  "page": 1,
  "jobTitle": [
    "Head of Marketing"
  ],
  "location": [
    "France"
  ],
  "industry": [
    "Software Development"
  ],
  "companySize": [
    "51-200"
  ],
  "name": "<string>",
  "company": "<string>",
  "companyUrl": [
    "<string>"
  ],
  "companyIdentifier": [
    "gojiberryai"
  ],
  "companyLastFundingRoundSince": "2025-01-01",
  "isCompanyHiring": true,
  "hasRecentFundingRound": true,
  "hasRecentlyChangedJob": true,
  "hasRecentActivity": true
}
'

import requests

url = "https://ext.gojiberry.ai/v1/directory/leads/search"

payload = {
    "limit": 25,
    "page": 1,
    "jobTitle": ["Head of Marketing"],
    "location": ["France"],
    "industry": ["Software Development"],
    "companySize": ["51-200"],
    "name": "<string>",
    "company": "<string>",
    "companyUrl": ["<string>"],
    "companyIdentifier": ["gojiberryai"],
    "companyLastFundingRoundSince": "2025-01-01",
    "isCompanyHiring": True,
    "hasRecentFundingRound": True,
    "hasRecentlyChangedJob": True,
    "hasRecentActivity": True
}
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({
    limit: 25,
    page: 1,
    jobTitle: ['Head of Marketing'],
    location: ['France'],
    industry: ['Software Development'],
    companySize: ['51-200'],
    name: '<string>',
    company: '<string>',
    companyUrl: ['<string>'],
    companyIdentifier: ['gojiberryai'],
    companyLastFundingRoundSince: '2025-01-01',
    isCompanyHiring: true,
    hasRecentFundingRound: true,
    hasRecentlyChangedJob: true,
    hasRecentActivity: true
  })
};

fetch('https://ext.gojiberry.ai/v1/directory/leads/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://ext.gojiberry.ai/v1/directory/leads/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([
    'limit' => 25,
    'page' => 1,
    'jobTitle' => [
        'Head of Marketing'
    ],
    'location' => [
        'France'
    ],
    'industry' => [
        'Software Development'
    ],
    'companySize' => [
        '51-200'
    ],
    'name' => '<string>',
    'company' => '<string>',
    'companyUrl' => [
        '<string>'
    ],
    'companyIdentifier' => [
        'gojiberryai'
    ],
    'companyLastFundingRoundSince' => '2025-01-01',
    'isCompanyHiring' => true,
    'hasRecentFundingRound' => true,
    'hasRecentlyChangedJob' => true,
    'hasRecentActivity' => true
  ]),
  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://ext.gojiberry.ai/v1/directory/leads/search"

	payload := strings.NewReader("{\n  \"limit\": 25,\n  \"page\": 1,\n  \"jobTitle\": [\n    \"Head of Marketing\"\n  ],\n  \"location\": [\n    \"France\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"name\": \"<string>\",\n  \"company\": \"<string>\",\n  \"companyUrl\": [\n    \"<string>\"\n  ],\n  \"companyIdentifier\": [\n    \"gojiberryai\"\n  ],\n  \"companyLastFundingRoundSince\": \"2025-01-01\",\n  \"isCompanyHiring\": true,\n  \"hasRecentFundingRound\": true,\n  \"hasRecentlyChangedJob\": true,\n  \"hasRecentActivity\": true\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://ext.gojiberry.ai/v1/directory/leads/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"limit\": 25,\n  \"page\": 1,\n  \"jobTitle\": [\n    \"Head of Marketing\"\n  ],\n  \"location\": [\n    \"France\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"name\": \"<string>\",\n  \"company\": \"<string>\",\n  \"companyUrl\": [\n    \"<string>\"\n  ],\n  \"companyIdentifier\": [\n    \"gojiberryai\"\n  ],\n  \"companyLastFundingRoundSince\": \"2025-01-01\",\n  \"isCompanyHiring\": true,\n  \"hasRecentFundingRound\": true,\n  \"hasRecentlyChangedJob\": true,\n  \"hasRecentActivity\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ext.gojiberry.ai/v1/directory/leads/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  \"limit\": 25,\n  \"page\": 1,\n  \"jobTitle\": [\n    \"Head of Marketing\"\n  ],\n  \"location\": [\n    \"France\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"name\": \"<string>\",\n  \"company\": \"<string>\",\n  \"companyUrl\": [\n    \"<string>\"\n  ],\n  \"companyIdentifier\": [\n    \"gojiberryai\"\n  ],\n  \"companyLastFundingRoundSince\": \"2025-01-01\",\n  \"isCompanyHiring\": true,\n  \"hasRecentFundingRound\": true,\n  \"hasRecentlyChangedJob\": true,\n  \"hasRecentActivity\": true\n}"

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

{
  "leads": [
    {}
  ],
  "total": 123,
  "page": 123,
  "limit": 123
}

Authorizations

Authorization

string

header

required

API key from Settings → API. Send it as Authorization: Bearer .

Headers

x-impersonate-user-id

string

ID of an organization member to act on behalf of. The API key user must be the owner of the organization and the target user must belong to the same organization.

Body

application/json

Search filters. At least one filter is required. String-array fields also accept a single string.

limit

number

Number of leads per page (1-100, default 10)

Example:

25

page

number

Page number, starts at 1

Example:

1

jobTitle

string[]

Job titles to match

Example:

["Head of Marketing"]

location

string[]

Locations or countries to match

Example:

["France"]

industry

string[]

Industries to prefer

Example:

["Software Development"]

companySize

string[]

Company size brackets (e.g. "2-10", "51-200", "10001+")

Example:

["51-200"]

name

string

Full name of the person

company

string

Company name

companyUrl

string[]

LinkedIn company URLs to restrict the search to

companyIdentifier

string[]

Exact LinkedIn company identifiers (the vanity slug in linkedin.com/company/) to restrict the search to

Example:

["gojiberryai"]

companyLastFundingRoundSince

string

Only companies with a funding round since this date (YYYY-MM-DD)

Example:

"2025-01-01"

isCompanyHiring

boolean

Only companies with at least one active job posting

hasRecentFundingRound

boolean

Only companies with a funding round in the last 6 months

hasRecentlyChangedJob

boolean

Only people who started their current position in the last 3 months

hasRecentActivity

boolean

Only people who were active on LinkedIn (posted, commented or reacted) in the last 90 days. People whose last activity date is unknown are excluded.

Response

Page of masked leads. Empty string fields become available after revealing the lead.

leads

object[]

total

number

Total number of leads matching the filters, capped at 10 000 (the deepest page reachable anyway)

page

number

limit

number

⌘I

Search leads (free preview)

curl --request POST \
  --url https://ext.gojiberry.ai/v1/directory/leads/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": 25,
  "page": 1,
  "jobTitle": [
    "Head of Marketing"
  ],
  "location": [
    "France"
  ],
  "industry": [
    "Software Development"
  ],
  "companySize": [
    "51-200"
  ],
  "name": "<string>",
  "company": "<string>",
  "companyUrl": [
    "<string>"
  ],
  "companyIdentifier": [
    "gojiberryai"
  ],
  "companyLastFundingRoundSince": "2025-01-01",
  "isCompanyHiring": true,
  "hasRecentFundingRound": true,
  "hasRecentlyChangedJob": true,
  "hasRecentActivity": true
}
'

import requests

url = "https://ext.gojiberry.ai/v1/directory/leads/search"

payload = {
    "limit": 25,
    "page": 1,
    "jobTitle": ["Head of Marketing"],
    "location": ["France"],
    "industry": ["Software Development"],
    "companySize": ["51-200"],
    "name": "<string>",
    "company": "<string>",
    "companyUrl": ["<string>"],
    "companyIdentifier": ["gojiberryai"],
    "companyLastFundingRoundSince": "2025-01-01",
    "isCompanyHiring": True,
    "hasRecentFundingRound": True,
    "hasRecentlyChangedJob": True,
    "hasRecentActivity": True
}
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({
    limit: 25,
    page: 1,
    jobTitle: ['Head of Marketing'],
    location: ['France'],
    industry: ['Software Development'],
    companySize: ['51-200'],
    name: '<string>',
    company: '<string>',
    companyUrl: ['<string>'],
    companyIdentifier: ['gojiberryai'],
    companyLastFundingRoundSince: '2025-01-01',
    isCompanyHiring: true,
    hasRecentFundingRound: true,
    hasRecentlyChangedJob: true,
    hasRecentActivity: true
  })
};

fetch('https://ext.gojiberry.ai/v1/directory/leads/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://ext.gojiberry.ai/v1/directory/leads/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([
    'limit' => 25,
    'page' => 1,
    'jobTitle' => [
        'Head of Marketing'
    ],
    'location' => [
        'France'
    ],
    'industry' => [
        'Software Development'
    ],
    'companySize' => [
        '51-200'
    ],
    'name' => '<string>',
    'company' => '<string>',
    'companyUrl' => [
        '<string>'
    ],
    'companyIdentifier' => [
        'gojiberryai'
    ],
    'companyLastFundingRoundSince' => '2025-01-01',
    'isCompanyHiring' => true,
    'hasRecentFundingRound' => true,
    'hasRecentlyChangedJob' => true,
    'hasRecentActivity' => true
  ]),
  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://ext.gojiberry.ai/v1/directory/leads/search"

	payload := strings.NewReader("{\n  \"limit\": 25,\n  \"page\": 1,\n  \"jobTitle\": [\n    \"Head of Marketing\"\n  ],\n  \"location\": [\n    \"France\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"name\": \"<string>\",\n  \"company\": \"<string>\",\n  \"companyUrl\": [\n    \"<string>\"\n  ],\n  \"companyIdentifier\": [\n    \"gojiberryai\"\n  ],\n  \"companyLastFundingRoundSince\": \"2025-01-01\",\n  \"isCompanyHiring\": true,\n  \"hasRecentFundingRound\": true,\n  \"hasRecentlyChangedJob\": true,\n  \"hasRecentActivity\": true\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://ext.gojiberry.ai/v1/directory/leads/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"limit\": 25,\n  \"page\": 1,\n  \"jobTitle\": [\n    \"Head of Marketing\"\n  ],\n  \"location\": [\n    \"France\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"name\": \"<string>\",\n  \"company\": \"<string>\",\n  \"companyUrl\": [\n    \"<string>\"\n  ],\n  \"companyIdentifier\": [\n    \"gojiberryai\"\n  ],\n  \"companyLastFundingRoundSince\": \"2025-01-01\",\n  \"isCompanyHiring\": true,\n  \"hasRecentFundingRound\": true,\n  \"hasRecentlyChangedJob\": true,\n  \"hasRecentActivity\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ext.gojiberry.ai/v1/directory/leads/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  \"limit\": 25,\n  \"page\": 1,\n  \"jobTitle\": [\n    \"Head of Marketing\"\n  ],\n  \"location\": [\n    \"France\"\n  ],\n  \"industry\": [\n    \"Software Development\"\n  ],\n  \"companySize\": [\n    \"51-200\"\n  ],\n  \"name\": \"<string>\",\n  \"company\": \"<string>\",\n  \"companyUrl\": [\n    \"<string>\"\n  ],\n  \"companyIdentifier\": [\n    \"gojiberryai\"\n  ],\n  \"companyLastFundingRoundSince\": \"2025-01-01\",\n  \"isCompanyHiring\": true,\n  \"hasRecentFundingRound\": true,\n  \"hasRecentlyChangedJob\": true,\n  \"hasRecentActivity\": true\n}"

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

{
  "leads": [
    {}
  ],
  "total": 123,
  "page": 123,
  "limit": 123
}

Getting Started

API reference

Authorizations

Headers

Body

Response