We’re excited to grant you early access to our new Reverse Email Lookup endpoint, which retrieves person-level data from a single email address. You’ll have 200 free credits to test and evaluate its performance.

Endpoint Overview

Method: GET

URL: https://api.surfe.com/v1/people/search/byEmail

// Request body (query params)
interface PeopleSearchRequest {
  email: string;
  linkedInURLSufficient: boolean;
}

interface Person 

interface PersonResponse {
  person: {
    id: string;
    firstName: string;
    lastName: string;
    name: string;
    jobTitle: string;
    companyName: string;
    companyWebsite: string;
    linkedinUrl: string;
    country: string;
    seniorities: string[];
    departments: string[];
    subdepartments: string[];
  }
}

// Example usage:
const examplePerson: PersonResponse = {
  person: {
    id: "12345678-90ab-cdef-1234-567890abcdef",
    firstName: "John",
    lastName: "Doe",
    name: "John Doe",
    jobTitle: "Software Engineer",
    companyName: "TechCorp",
    companyWebsite: "<http://www.techcorp.com>",
    linkedinUrl: "<http://www.linkedin.com/in/john-doe>",
    country: "United States",
    seniorities: ["Mid-Level"],
    departments: ["Engineering"],
    subdepartments: ["Software Development"]
  }
};

Average Response Time: ~2 seconds or les

Optimizing Your Queries

• If you only need the LinkedIn URL, set linkedInURLSufficient=true to reduce query time.
• To maximize fill rates for all fields, set linkedInURLSufficient=false.

Example Request (cURL)

curl --location \\
'[<https://api.surfe.com/v1/people/search/byEmail?email=nour.talaat%40surfe.com&linkedInURLSufficient=true>](<https://api.surfe.com/v1/people/search/byEmail?email=nour.talaat%40surfe.com&linkedInURLSufficient=true>)' \\
--header 'Authorization: Bearer <api-key>'

Replace <api-key> with the key available here (you’ll need a Surfe account).

Additional API Capabilities

For more advanced use cases (e.g., company data enrichment, signals, etc.), check out our Surfe API Docs.

Let us know if you need any help getting started!