Retrieve a bulk search

curl -X GET "https://api.reverselooker.com/reverse-contact/bulk?id=550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: your_api_key"

const bulkId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(
  `https://api.reverselooker.com/reverse-contact/bulk?id=${bulkId}`,
  {
    headers: {
      'x-api-key': 'your_api_key'
    }
  }
);

const data = await response.json();

console.log(`Progress: ${data.number_finished}/${data.number_requested}`);

if (data.status === 'completed') {
  const foundProfiles = data.results.filter(r => r.qualification === 'found');
  console.log(`${foundProfiles.length} profiles found`);
}

import requests

bulk_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.get(
    f'https://api.reverselooker.com/reverse-contact/bulk?id={bulk_id}',
    headers={
        'x-api-key': 'your_api_key'
    }
)

data = response.json()

print(f"Progress: {data['number_finished']}/{data['number_requested']}")

if data['status'] == 'completed':
    found = [r for r in data['results'] if r['qualification'] == 'found']
    print(f"{len(found)} profiles found")

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2024-01-15T10:30:00Z",
  "last_update": "2024-01-15T10:31:45Z",
  "number_requested": 100,
  "number_finished": 45,
  "status": "ongoing",
  "results": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "email": "john.doe@company.com",
      "qualification": "found",
      "linkedin_url": "https://linkedin.com/in/johndoe",
      "full_name": "John Doe",
      "headline": "Senior Software Engineer",
      "company_name": "Company Inc.",
      "location": "San Francisco, CA"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "email": "jane.smith@startup.io",
      "qualification": "not_found",
      "linkedin_url": null,
      "full_name": null,
      "headline": null,
      "company_name": null,
      "location": null
    },
    {
      "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "email": "bob.wilson@enterprise.co",
      "qualification": "ongoing",
      "linkedin_url": null,
      "full_name": null,
      "headline": null,
      "company_name": null,
      "location": null
    }
  ]
}

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2024-01-15T10:30:00Z",
  "last_update": "2024-01-15T10:35:00Z",
  "number_requested": 100,
  "number_finished": 100,
  "status": "completed",
  "results": [...]
}

{
  "error": "Invalid API key"
}

{
  "error": "Bulk search not found"
}

Authentication

string

required

Your API key

Query Parameters

string

required

The bulk search identifier returned by POST /reverse-contact/bulk.Example: 550e8400-e29b-41d4-a716-446655440000

curl -X GET "https://api.reverselooker.com/reverse-contact/bulk?id=550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: your_api_key"

const bulkId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(
  `https://api.reverselooker.com/reverse-contact/bulk?id=${bulkId}`,
  {
    headers: {
      'x-api-key': 'your_api_key'
    }
  }
);

const data = await response.json();

console.log(`Progress: ${data.number_finished}/${data.number_requested}`);

if (data.status === 'completed') {
  const foundProfiles = data.results.filter(r => r.qualification === 'found');
  console.log(`${foundProfiles.length} profiles found`);
}

import requests

bulk_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.get(
    f'https://api.reverselooker.com/reverse-contact/bulk?id={bulk_id}',
    headers={
        'x-api-key': 'your_api_key'
    }
)

data = response.json()

print(f"Progress: {data['number_finished']}/{data['number_requested']}")

if data['status'] == 'completed':
    found = [r for r in data['results'] if r['qualification'] == 'found']
    print(f"{len(found)} profiles found")

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2024-01-15T10:30:00Z",
  "last_update": "2024-01-15T10:31:45Z",
  "number_requested": 100,
  "number_finished": 45,
  "status": "ongoing",
  "results": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "email": "john.doe@company.com",
      "qualification": "found",
      "linkedin_url": "https://linkedin.com/in/johndoe",
      "full_name": "John Doe",
      "headline": "Senior Software Engineer",
      "company_name": "Company Inc.",
      "location": "San Francisco, CA"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "email": "jane.smith@startup.io",
      "qualification": "not_found",
      "linkedin_url": null,
      "full_name": null,
      "headline": null,
      "company_name": null,
      "location": null
    },
    {
      "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "email": "bob.wilson@enterprise.co",
      "qualification": "ongoing",
      "linkedin_url": null,
      "full_name": null,
      "headline": null,
      "company_name": null,
      "location": null
    }
  ]
}

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2024-01-15T10:30:00Z",
  "last_update": "2024-01-15T10:35:00Z",
  "number_requested": 100,
  "number_finished": 100,
  "status": "completed",
  "results": [...]
}

{
  "error": "Invalid API key"
}

{
  "error": "Bulk search not found"
}

Response

string

required

Unique bulk search identifier.

string

required

Search creation date (ISO 8601 format).

string

required

Last update date (ISO 8601 format).

number

required

Total number of emails in the initial request.

number

required

Number of completed searches. Use this field to track progress.

string

required

Overall bulk search status: ongoing, completed, or failed.

array

required

List of individual results for each email.

Show Result properties

string

Unique identifier for the individual search.

string

The searched email.

string

Status: ongoing, found, or not_found.

string

LinkedIn profile URL (if found).

string

Full name (if found).

string

LinkedIn headline (if found).

string

Current company (if found).

string

Location (if found).

Polling for large volumes

For large bulk searches, implement polling with backoff:

async function waitForBulkCompletion(bulkId, apiKey) {
  let delay = 2000; // Start at 2 seconds
  const maxDelay = 30000; // Maximum 30 seconds

  while (true) {
    const response = await fetch(
      `https://api.reverselooker.com/reverse-contact/bulk?id=${bulkId}`,
      { headers: { 'x-api-key': apiKey } }
    );

    const data = await response.json();

    console.log(`Progress: ${data.number_finished}/${data.number_requested}`);

    if (data.status === 'completed' || data.status === 'failed') {
      return data;
    }

    await new Promise(resolve => setTimeout(resolve, delay));
    delay = Math.min(delay * 1.5, maxDelay); // Exponential backoff
  }
}

The bulk response contains a summary of profiles (name, headline, company, location). To get the full profile of a contact (experience, education, skills), use GET /reverse-contact/single with the individual ID.

Configure a webhook when creating the bulk search to be automatically notified when processing is complete.

Introduction Create a bulk search

API documentation

Endpoints

Authentication

Query Parameters

Response

Polling for large volumes

​Authentication

​Query Parameters

​Response

​Polling for large volumes

Authentication

Query Parameters

Response

Polling for large volumes