Enrich people by email (bulk)

curl --request POST \
  --url https://app.tryspecter.com/api/v1/people/by-email/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  "jane.doe@example.com"
]
'

import requests

url = "https://app.tryspecter.com/api/v1/people/by-email/bulk"

payload = ["jane.doe@example.com"]
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify(['jane.doe@example.com'])
};

fetch('https://app.tryspecter.com/api/v1/people/by-email/bulk', 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.tryspecter.com/api/v1/people/by-email/bulk",
  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([
    'jane.doe@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$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.tryspecter.com/api/v1/people/by-email/bulk"

	payload := strings.NewReader("[\n  \"jane.doe@example.com\"\n]")

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

	req.Header.Add("X-API-Key", "<api-key>")
	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.tryspecter.com/api/v1/people/by-email/bulk")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("[\n  \"jane.doe@example.com\"\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/people/by-email/bulk")

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

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "[\n  \"jane.doe@example.com\"\n]"

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

[
  {
    "person_id": "per_34f8a8ad1f7497b83e821345",
    "last_updated": "2026-07-13 17:37:30",
    "email": "jane.doe@example.com",
    "score": 8,
    "talent_signal_ids": [
      "58323b85-153b-4d3d-8c0c-62dbf41198dc"
    ],
    "investor_signal_ids": [
      "0340bac8-bcee-46a2-94bf-cf77e0c34253"
    ],
    "profile_picture_url": "https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg",
    "first_name": "Cosmin",
    "last_name": "Urdea",
    "full_name": "Cosmin Urdea",
    "linkedin_url": "https://www.linkedin.com/in/cosmin-urdea-0848973",
    "linkedin_num_id": 11147428,
    "linkedin_urn": "ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE",
    "twitter_url": "https://x.com/moissinac",
    "github_url": "https://github.com/sarahchen9776",
    "about": "IT Software Consultant / Contractor 20+ years of experience in software development - Systems and Applications Architecture - Product Design / Management - Coach and mentorship Experience in various industries, but mostly in electronic payments. After a full carrier as a full stack developer and, later on, architect, I have decided to put my experience to use from a different perspective as Product Owner/Manager and it has been already 3 years and I am enjoying very much this new role.",
    "tagline": "Software Consultant / Contractor",
    "location": "Bucharest, București, Romania, Europe",
    "region": "Europe",
    "highlights": [
      "major_tech_experience",
      "prior_vc_backed_experience",
      "strong_technical_background",
      "vc_backed_experience"
    ],
    "level_of_seniority": "Senior Level",
    "years_of_experience": 21,
    "education_level": "",
    "experience": [
      {
        "company_name": "valantic (vormals mm1)",
        "linkedin_url": "https://www.linkedin.com/company/mm1",
        "title": "Senior Consultant Fintech & Digital Payment",
        "departments": [
          "Finance"
        ],
        "start_date": "2025-04-01",
        "is_current": true,
        "job_order": 13,
        "company_id": "6744b47c776432406530a72b",
        "domain": "mm1.com",
        "description": "As an Implementation Engineer at valantic, I play a pivotal role in the technical execution of Stripe integration projects, ensuring precision, efficiency, and robust infrastructure in every implementation. Leveraging deep technical expertise and payments industry experience, I design and deploy custom payment solutions that enhance operational efficiency and customer satisfaction.",
        "company_size": "51-200",
        "industry": [
          "Financial Services",
          "Financial Technology"
        ],
        "tech_verticals": [
          [
            "Blockchain, Crypto & Web3",
            "Crypto Exchanges and Trading Infrastructure"
          ]
        ],
        "end_date": "2025-03-01",
        "location": "Stuttgart, Baden-Wurttemberg, Germany, Europe",
        "founded_year": 1997
      }
    ],
    "current_position_title": "Senior Consultant Fintech & Digital Payment",
    "current_position_company_name": "valantic (vormals mm1)",
    "current_position_company_website": "mm1.com",
    "past_position_title": "Product Owner (Contracted)",
    "past_position_company_name": "Riverty",
    "past_position_company_website": "riverty.com",
    "current_tenure": 15,
    "average_tenure": 22,
    "education": [
      {
        "name": "Stanford University",
        "linkedin_url": "https://www.linkedin.com/school/stanford-university",
        "field_of_study": "Computer Science (AI track) and Statistics",
        "degree_title": "Bachelor of Science - BS",
        "description": "<p class=\"show-more-less-text__text--less\">\n        Krieger School of Arts and Sciences<br>Bloomberg School of Public Health<br>(joint degree program)\n<!---->      </p>",
        "start_date": "2024-01-01",
        "end_date": "2028-01-01",
        "location": "Stanford, California, United States, North America"
      }
    ],
    "languages": [
      {
        "name": "English",
        "proficiency_level": "Native Or Bilingual Proficiency"
      },
      {
        "name": "Mandarin Chinese",
        "proficiency_level": "Limited Working Proficiency"
      }
    ],
    "skills": [
      "API Development",
      "Agentic AI",
      "Agentic Orchestration",
      "Algorithmic Trading",
      "Algorithms",
      "Apache Spark",
      "C#",
      "C++",
      "CORS",
      "Communication"
    ],
    "linkedin_followers": 904,
    "linkedin_connections": 500
  }
]

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "OUT_OF_CREDITS",
  "message": "<string>"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Enrich

Enrich people by email (bulk)

Resolve up to 50 email addresses to people in one request - the bulk counterpart to Enrich person by email. Pass a JSON array of email addresses (1-50). Each match is a full person record, the same object Get person by ID returns, plus the email it resolved from and a match confidence score.

Costs 2 credits per matched result.

What you need

A JSON array of 1–50 email addresses.

Behaviour

Each match echoes the email it resolved, so you can map results back to inputs.
Emails that don’t match a person are silently omitted, and the response order isn’t guaranteed.
Every field of the person record is included, so no follow-up call is needed to read a profile.

What you do next

Open a match’s current company. Resolve an experience[].company_id with Get company by ID.
Save the results. Add the matched people to a list you can find with Create people list.

POST

people

by-email

bulk

Enrich people by email (bulk)

curl --request POST \
  --url https://app.tryspecter.com/api/v1/people/by-email/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  "jane.doe@example.com"
]
'

import requests

url = "https://app.tryspecter.com/api/v1/people/by-email/bulk"

payload = ["jane.doe@example.com"]
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify(['jane.doe@example.com'])
};

fetch('https://app.tryspecter.com/api/v1/people/by-email/bulk', 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.tryspecter.com/api/v1/people/by-email/bulk",
  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([
    'jane.doe@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$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.tryspecter.com/api/v1/people/by-email/bulk"

	payload := strings.NewReader("[\n  \"jane.doe@example.com\"\n]")

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

	req.Header.Add("X-API-Key", "<api-key>")
	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.tryspecter.com/api/v1/people/by-email/bulk")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("[\n  \"jane.doe@example.com\"\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/people/by-email/bulk")

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

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "[\n  \"jane.doe@example.com\"\n]"

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

[
  {
    "person_id": "per_34f8a8ad1f7497b83e821345",
    "last_updated": "2026-07-13 17:37:30",
    "email": "jane.doe@example.com",
    "score": 8,
    "talent_signal_ids": [
      "58323b85-153b-4d3d-8c0c-62dbf41198dc"
    ],
    "investor_signal_ids": [
      "0340bac8-bcee-46a2-94bf-cf77e0c34253"
    ],
    "profile_picture_url": "https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg",
    "first_name": "Cosmin",
    "last_name": "Urdea",
    "full_name": "Cosmin Urdea",
    "linkedin_url": "https://www.linkedin.com/in/cosmin-urdea-0848973",
    "linkedin_num_id": 11147428,
    "linkedin_urn": "ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE",
    "twitter_url": "https://x.com/moissinac",
    "github_url": "https://github.com/sarahchen9776",
    "about": "IT Software Consultant / Contractor 20+ years of experience in software development - Systems and Applications Architecture - Product Design / Management - Coach and mentorship Experience in various industries, but mostly in electronic payments. After a full carrier as a full stack developer and, later on, architect, I have decided to put my experience to use from a different perspective as Product Owner/Manager and it has been already 3 years and I am enjoying very much this new role.",
    "tagline": "Software Consultant / Contractor",
    "location": "Bucharest, București, Romania, Europe",
    "region": "Europe",
    "highlights": [
      "major_tech_experience",
      "prior_vc_backed_experience",
      "strong_technical_background",
      "vc_backed_experience"
    ],
    "level_of_seniority": "Senior Level",
    "years_of_experience": 21,
    "education_level": "",
    "experience": [
      {
        "company_name": "valantic (vormals mm1)",
        "linkedin_url": "https://www.linkedin.com/company/mm1",
        "title": "Senior Consultant Fintech & Digital Payment",
        "departments": [
          "Finance"
        ],
        "start_date": "2025-04-01",
        "is_current": true,
        "job_order": 13,
        "company_id": "6744b47c776432406530a72b",
        "domain": "mm1.com",
        "description": "As an Implementation Engineer at valantic, I play a pivotal role in the technical execution of Stripe integration projects, ensuring precision, efficiency, and robust infrastructure in every implementation. Leveraging deep technical expertise and payments industry experience, I design and deploy custom payment solutions that enhance operational efficiency and customer satisfaction.",
        "company_size": "51-200",
        "industry": [
          "Financial Services",
          "Financial Technology"
        ],
        "tech_verticals": [
          [
            "Blockchain, Crypto & Web3",
            "Crypto Exchanges and Trading Infrastructure"
          ]
        ],
        "end_date": "2025-03-01",
        "location": "Stuttgart, Baden-Wurttemberg, Germany, Europe",
        "founded_year": 1997
      }
    ],
    "current_position_title": "Senior Consultant Fintech & Digital Payment",
    "current_position_company_name": "valantic (vormals mm1)",
    "current_position_company_website": "mm1.com",
    "past_position_title": "Product Owner (Contracted)",
    "past_position_company_name": "Riverty",
    "past_position_company_website": "riverty.com",
    "current_tenure": 15,
    "average_tenure": 22,
    "education": [
      {
        "name": "Stanford University",
        "linkedin_url": "https://www.linkedin.com/school/stanford-university",
        "field_of_study": "Computer Science (AI track) and Statistics",
        "degree_title": "Bachelor of Science - BS",
        "description": "<p class=\"show-more-less-text__text--less\">\n        Krieger School of Arts and Sciences<br>Bloomberg School of Public Health<br>(joint degree program)\n<!---->      </p>",
        "start_date": "2024-01-01",
        "end_date": "2028-01-01",
        "location": "Stanford, California, United States, North America"
      }
    ],
    "languages": [
      {
        "name": "English",
        "proficiency_level": "Native Or Bilingual Proficiency"
      },
      {
        "name": "Mandarin Chinese",
        "proficiency_level": "Limited Working Proficiency"
      }
    ],
    "skills": [
      "API Development",
      "Agentic AI",
      "Agentic Orchestration",
      "Algorithmic Trading",
      "Algorithms",
      "Apache Spark",
      "C#",
      "C++",
      "CORS",
      "Communication"
    ],
    "linkedin_followers": 904,
    "linkedin_connections": 500
  }
]

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "OUT_OF_CREDITS",
  "message": "<string>"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Authorizations

X-API-Key

string

header

required

Body

application/json

Required array length: 1 - 50 elements

Response

The people matched to the supplied emails. Unmatched emails are omitted.

person_id

string

required

The Specter person ID for this person, can be used in people endpoints.

Example:

"per_34f8a8ad1f7497b83e821345"

last_updated

string

required

A date for when the person was last updated in Specter. Uses the format YYYY-MM-DD HH:MM:SS.

Example:

"2026-07-13 17:37:30"

string<email>

required

The email address this result resolved from, echoed back.

Example:

"jane.doe@example.com"

score

number

required

Confidence in the match, from 1 to 10. A score of 7 or higher is generally a reliable match; treat lower scores with increasing caution.

Example:

8

talent_signal_ids

string[] | null

Talent signal IDs for this person. To read the signals themselves, call Get person talent signals rather than resolving these IDs individually.

Example:

["58323b85-153b-4d3d-8c0c-62dbf41198dc"]

investor_signal_ids

string[] | null

Investor-interest signal IDs for this person. There is no per-person investor-interest endpoint; read these signals from the by-date feed.

profile_picture_url

string | null

A url for a profile picture if there is one.

Example:

"https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg"

first_name

string

First name

Example:

"Cosmin"

last_name

string

Last Name

Example:

"Urdea"

full_name

string

Full name

Example:

"Cosmin Urdea"

linkedin_url

string

URL for LinkedIn account.

Example:

"https://www.linkedin.com/in/cosmin-urdea-0848973"

linkedin_num_id

number

The numeric ID for the LinkedIn account.

Example:

11147428

linkedin_urn

string

The URN from LinkedIn for the account.

Example:

"ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE"

twitter_url

string | null

URL for Twitter account.

Example:

"https://x.com/moissinac"

github_url

string | null

URL for Github account.

Example:

"https://github.com/sarahchen9776"

about

string | null

A description of the person.

Example:

"IT Software Consultant / Contractor 20+ years of experience in software development - Systems and Applications Architecture - Product Design / Management - Coach and mentorship Experience in various industries, but mostly in electronic payments. After a full carrier as a full stack developer and, later on, architect, I have decided to put my experience to use from a different perspective as Product Owner/Manager and it has been already 3 years and I am enjoying very much this new role."

tagline

string | null

A shorter tagline for the person.

Example:

"Software Consultant / Contractor"

location

string | null

Where the person is located.

Example:

"Bucharest, București, Romania, Europe"

region

string | null

Main region where the person is located.

Example:

"Europe"

highlights

string[]

Type of highlight, the full list will be added shortly.

Example:

[
  "major_tech_experience",
  "prior_vc_backed_experience",
  "strong_technical_background",
  "vc_backed_experience"
]

level_of_seniority

string | null

Top level of seniority the person has achieved.

Example:

"Senior Level"

years_of_experience

number | null

Years of experience the person has worked for.

Example:

21

education_level

string | null

Top level of education that the person has.

Example:

""

experience

Experience · object[]

Companies that the person has worked for.

Show child attributes

current_position_title

string | null

Title of the person's current position

Example:

"Senior Consultant Fintech & Digital Payment"

current_position_company_name

string | null

Name of the company where the person currently works.

Example:

"valantic (vormals mm1)"

current_position_company_website

string | null

Website for the company where the person currently works.

Example:

"mm1.com"

past_position_title

string | null

Title of the person's last position

Example:

"Product Owner (Contracted)"

past_position_company_name

string | null

Name of the company where the person last left.

Example:

"Riverty"

past_position_company_website

string | null

Website for the company where the person last left.

Example:

"riverty.com"

current_tenure

number | null

Length of time the person has been in their current job.

Example:

15

average_tenure

number | null

Average length of time in a position.

Example:

22

education

Education · object[]

Educational background for the person

Show child attributes

languages

Language · object[] | null

Languages that the person speaks

Show child attributes

Example:

[
  {
    "name": "English",
    "proficiency_level": "Native Or Bilingual Proficiency"
  },
  {
    "name": "Mandarin Chinese",
    "proficiency_level": "Limited Working Proficiency"
  }
]

skills

string[]

List of skills that the person has.

Example:

[
  "API Development",
  "Agentic AI",
  "Agentic Orchestration",
  "Algorithmic Trading",
  "Algorithms",
  "Apache Spark",
  "C#",
  "C++",
  "CORS",
  "Communication"
]

linkedin_followers

number

Number of followers the person has on LinkedIn.

Example:

904

linkedin_connections

number

Number of connections the person has on LinkedIn.

Example:

500

Enrich

Search

Companies

People

Investors

Transactions

Signals

Lists

Saved Searches

Network

Account

Enrich people by email (bulk)

What you need

Behaviour

What you do next

Authorizations

Body

Response