find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/peoplesearch-im:peoplesearch-im-tools-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: PeopleSearch.im Tools 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: Tools
paths:
  /api/v1/tools:
    post:
      operationId: runTool
      summary: Run a single lookup tool
      description: 'Dispatch any lookup tool by its id, passing that tool''s fields in `input`: work-email-finder (Email Finder by Name: firstname, lastname, domainOrCompany; 2 credits); email-verifier (Email Verifier: email; 1 credit); reverse-email-lookup (Reverse Email Lookup: email; 13 credits); email-finder (Company Email Finder: domainOrCompany; 2 credits); linkedin-profile-finder (LinkedIn Profile Finder: firstname, lastname, companyOrDomain; 2 credits); linkedin-profile-lookup (LinkedIn Profile Lookup: url; 2 credits); company-lookup (Company Lookup: url; 1 credit); company-search (Company Search: query; free). Credits are refunded when a tool finds nothing.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tool
              - input
              properties:
                tool:
                  type: string
                  enum:
                  - work-email-finder
                  - email-verifier
                  - reverse-email-lookup
                  - email-finder
                  - linkedin-profile-finder
                  - linkedin-profile-lookup
                  - company-lookup
                  - company-search
                input:
                  type: object
                  additionalProperties:
                    type: string
      responses:
        '200':
          description: The tool result.
        '401':
          description: Missing or invalid API key.
        '402':
          description: Out of credits.
      tags:
      - Tools
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