Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: PeopleSearch.im Email API
version: 1.0.0
description: 'The same people-search backend as PeopleSearch.im, over HTTP. Search a global professional database in plain English, reveal full profiles, and fetch verified professional emails. Pay-as-you-go: 1 credit per profile, credits refunded when a lookup finds nothing. The same tools are also available to AI agents as a Model Context Protocol (MCP) server at https://peoplesearch.im/api/mcp.'
termsOfService: https://peoplesearch.im/legal/terms
servers:
- url: https://peoplesearch.im
security:
- bearerAuth: []
- apiKeyHeader: []
tags:
- name: Email
paths:
/api/v1/email:
post:
operationId: fetchEmail
summary: Fetch a verified work email (1 credit)
description: Look up the professional email for a profile id returned by deliver/reveal. Refunded if no email is found.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- id
properties:
id:
type: string
responses:
'200':
description: The email and its status.
'401':
description: Missing or invalid API key.
'402':
description: Out of credits.
tags:
- Email
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: sk_sift_…
description: A PeopleSearch.im API key, created at /developers.
apiKeyHeader:
type: apiKey
in: header
name: X-API-Key
description: The same PeopleSearch.im API key (sk_sift_…), sent as a header.
x-mcp:
endpoint: https://peoplesearch.im/api/mcp
transport: streamable-http
description: Remote MCP server exposing the same operations as agent tools. Authenticate with OAuth 2.1 (the MCP authorization spec; the server's 401 points at its protected resource metadata) or with the same API key as this REST API (Bearer token or X-API-Key header).
authorization:
protectedResourceMetadata: https://peoplesearch.im/.well-known/oauth-protected-resource/api/mcp
authorizationServerMetadata: https://peoplesearch.im/.well-known/oauth-authorization-server
tools:
- name: people_search
title: Search people
credits: 0
- name: reveal_profile
title: Reveal a person
credits: 1
- name: find_people
title: Find & unlock a batch of people
credits: 1
- name: fetch_email
title: Fetch a verified work email
credits: 1
- name: find_work_email
title: Find a person's work email
credits: 2
- name: verify_email
title: Verify an email address
credits: 1
- name: find_company_emails
title: Find a company's emails
credits: 2
- name: reverse_email_lookup
title: Reverse email lookup
credits: 13
- name: find_linkedin_profile
title: Find a LinkedIn profile
credits: 2
- name: lookup_linkedin_profile
title: Look up a LinkedIn profile
credits: 2
- name: lookup_company
title: Look up a company
credits: 1
- name: company_search
title: Search companies
credits: 0
- name: check_credits
title: Check credit balance
credits: 0