abm-dev People Finder API
Find decision-makers at target companies by role — powered by multi-source search and optional enrichment
Find decision-makers at target companies by role — powered by multi-source search and optional enrichment
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/abm-dev:abm-dev-people-finder-api"
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.
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.
A second provider on the same verified email joins the account you already have.
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