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/abm-dev:abm-dev-people-finder-api"

All apis

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

Discovery needs no key. Ratings and market analysis are Pro.

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:
  version: 2.0.0
  title: ABM.dev People Finder API
  description: The account-based marketing API for AI agents. Search, Source, Enrich, and Create over B2B people and companies, every field cited with a source and confidence score.
  contact:
    name: ABM.dev
    url: https://abm.dev
servers:
- url: https://api.abm.dev
  description: Production
- url: https://api-dev.abm.dev
  description: Staging
security:
- ApiKeyAuth: []
tags:
- name: People Finder
  description: Find decision-makers at target companies by role — powered by multi-source search and optional enrichment
paths:
  /v1/people-finder:
    post:
      operationId: createPersonFinderJob
      tags:
      - People Finder
      summary: Create person finder job
      description: Start a new people-finder job to locate decision-makers at a target company by role. Searches multiple sources and optionally enriches and pushes to CRM.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PersonFinderRequest'
      responses:
        '202':
          description: Job accepted for processing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PersonFinderJob'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
    get:
      operationId: listPersonFinderJobs
      tags:
      - People Finder
      summary: List person finder jobs
      description: Return a paginated list of people-finder jobs for the current organization.
      parameters:
      - name: status
        in: query
        schema:
          type: string
          enum:
          - queued
          - processing
          - completed
          - failed
          - cancelled
      - name: limit
        in: query
        schema:
          type: integer
          default: 20
      - name: offset
        in: query
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Paginated list of jobs
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/PersonFinderJob'
                  total:
                    type: integer
  /v1/people-finder/{jobId}:
    get:
      operationId: getPersonFinderJob
      tags:
      - People Finder
      summary: Get job status and results
      description: Retrieve the current status, progress, and results (if complete) for a people-finder job.
      parameters:
      - name: jobId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Job details with results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PersonFinderJob'
        '404':
          $ref: '#/components/responses/NotFound'
    delete:
      operationId: cancelPersonFinderJob
      tags:
      - People Finder
      summary: Cancel job
      description: Cancel a queued or in-progress people-finder job. Already-completed jobs cannot be cancelled.
      parameters:
      - name: jobId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '204':
          description: Job cancelled
        '404':
          $ref: '#/components/responses/NotFound'
  /v1/people-finder/{jobId}/stream:
    get:
      operationId: streamPersonFinderJob
      tags:
      - People Finder
      summary: SSE progress stream
      description: Stream real-time progress updates for a people-finder job via Server-Sent Events.
      parameters:
      - name: jobId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Server-Sent Events stream
          content:
            text/event-stream:
              schema:
                type: string
  /v1/people-finder/list/preview:
    post:
      operationId: previewPersonFinderList
      tags:
      - People Finder
      summary: Preview HubSpot company list
      description: Preview companies from a HubSpot list before submitting people-finder jobs. Returns company names, domains, and estimated credit cost.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - list_id
              properties:
                list_id:
                  type: string
                  description: HubSpot company list ID
                roles:
                  type: array
                  items:
                    type: string
                  description: Roles to search for
                options:
                  $ref: '#/components/schemas/PersonFinderOptions'
      responses:
        '200':
          description: List preview with companies and credit estimate
          content:
            application/json:
              schema:
                type: object
                properties:
                  preview_id:
                    type: string
                    format: uuid
                  companies:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        domain:
                          type: string
                  total_companies:
                    type: integer
                  estimated_credits:
                    type: integer
  /v1/people-finder/list/confirm:
    post:
      operationId: confirmPersonFinderList
      tags:
      - People Finder
      summary: Confirm and queue list jobs
      description: Confirm a previously previewed HubSpot company list and queue people-finder jobs for all companies.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - preview_id
              properties:
                preview_id:
                  type: string
                  format: uuid
      responses:
        '202':
          description: Jobs queued for all companies
          content:
            application/json:
              schema:
                type: object
                properties:
                  jobs_created:
                    type: integer
                  total_credits:
                    type: integer
  /v1/people-finder/upload:
    post:
      operationId: uploadPersonFinderFile
      tags:
      - People Finder
      summary: Upload Excel file of companies
      description: Upload an Excel file containing company names, domains, or LinkedIn URLs to run people-finder jobs against.
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
              - file
              properties:
                file:
                  type: string
                  format: binary
                  description: Excel (.xlsx) or CSV file with company data
                roles:
                  type: string
                  description: Comma-separated roles to search (can also be set at confirm)
      responses:
        '200':
          description: File parsed with preview
          content:
            application/json:
              schema:
                type: object
                properties:
                  upload_id:
                    type: string
                    format: uuid
                  companies_detected:
                    type: integer
                  preview:
                    type: array
                    items:
                      type: object
                  estimated_credits:
                    type: integer
  /v1/people-finder/upload/confirm:
    post:
      operationId: confirmPersonFinderUpload
      tags:
      - People Finder
      summary: Confirm uploaded companies
      description: Confirm a previously uploaded file and queue people-finder jobs for the companies.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - upload_id
              properties:
                upload_id:
                  type: string
                  format: uuid
                roles:
                  type: array
                  items:
                    type: string
                options:
                  $ref: '#/components/schemas/PersonFinderOptions'
      responses:
        '202':
          description: Jobs queued
          content:
            application/json:
              schema:
                type: object
                properties:
                  jobs_created:
                    type: integer
                  total_credits:
                    type: integer
components:
  responses:
    BadRequest:
      description: Invalid request parameters
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              details:
                type: object
    NotFound:
      description: Resource not found
    Unauthorized:
      description: Missing or invalid API key
  schemas:
    PersonFinderCandidate:
      type: object
      properties:
        name:
          type: string
        title:
          type: string
        matchedRole:
          type: string
          description: Which searched role this candidate matched
        confidence:
          type: number
          format: float
          description: Match confidence score (0-1)
        email:
          type: string
          format: email
        linkedinUrl:
          type: string
          format: uri
        location:
          type: string
        sources:
          type: array
          items:
            type: string
          description: Data sources that found this candidate
        hubspotContactId:
          type: string
          description: HubSpot contact ID if created in CRM
        enrichmentJobId:
          type: integer
          description: Enrichment job ID if enrich option was enabled
    PersonFinderOptions:
      type: object
      properties:
        maxPerRole:
          type: integer
          default: 3
          description: Maximum candidates to return per role
        enrich:
          type: boolean
          default: false
          description: Automatically enrich found candidates
        createInCrm:
          type: boolean
          default: false
          description: Create found candidates in connected CRM
    PersonFinderJob:
      type: object
      properties:
        jobId:
          type: string
          format: uuid
        status:
          type: string
          enum:
          - queued
          - processing
          - completed
          - failed
          - cancelled
        companyName:
          type: string
        roles:
          type: array
          items:
            type: string
        percentComplete:
          type: integer
          minimum: 0
          maximum: 100
        currentStep:
          type: string
          description: Human-readable description of the current processing step
        createdAt:
          type: string
          format: date-time
        completedAt:
          type: string
          format: date-time
        result:
          type: object
          properties:
            candidates:
              type: array
              items:
                $ref: '#/components/schemas/PersonFinderCandidate'
            rolesSearched:
              type: integer
            durationSeconds:
              type: number
        error:
          type: string
          description: Error message if status is failed
        statusUrl:
          type: string
          format: uri
          description: URL to poll for status updates
        streamUrl:
          type: string
          format: uri
          description: URL for SSE progress stream
    PersonFinderRequest:
      type: object
      required:
      - roles
      properties:
        companyName:
          type: string
          description: Target company name
        companyWebsite:
          type: string
          format: uri
          description: Target company website URL
        companyLinkedin:
          type: string
          format: uri
          description: Target company LinkedIn page URL
        roles:
          type: array
          items:
            type: string
          description: Job roles to search for (e.g. VP Sales, CTO)
        options:
          $ref: '#/components/schemas/PersonFinderOptions'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Clerk-issued JWT. Used for dashboard/portal requests and for the `/v1/organizations/signup` bootstrap endpoint.
x-tagGroups:
- name: Core API
  tags:
  - Enrichment
  - People Finder
  - Campaigns
- name: Configuration
  tags:
  - Field Configuration
  - Enrichment Config
- name: Integrations
  tags:
  - LinkedIn
  - CRM
  - Webhooks
- name: Account
  tags:
  - Organization
  - Health