> ## Documentation Index
> Fetch the complete documentation index at: https://snowseo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Find People

> Find editors and other people who could add a link at selected prospects.

Pass up to 50 `prospectIds`. The optional `terms` array accepts 3-25 distinct job titles; omit it to search the default editorial, SEO, marketing, and owner roles. Use `GET /v3/outreach/prospects/people-search-terms` to see the suggested titles and defaults.

The request starts background work. The `202` response reports `enqueuedCount`, `enqueuedProspectIds`, `skipped`, and `creditsCharged`. Poll [Outreach Prospects](/docs/api-reference/endpoints/outreach-prospects) while an enqueued site's `status` is `finding_people`, then read [Outreach Contacts](/docs/api-reference/endpoints/outreach-contacts) for names and roles.

This costs 5 AI credits per site searched, with a refund when a site yields nobody new. Sites already being searched, sites that already link to you, and self-serve or creator-platform opportunities are skipped without a charge. Finding people does not buy their email addresses.


## OpenAPI

````yaml POST /v3/outreach/prospects/find-people
openapi: 3.0.0
info:
  title: SnowSEO API
  description: API documentation for SnowSEO
  version: 1.0.0
servers:
  - url: https://api.snowseo.com
    description: Production server
security: []
tags:
  - name: Keywords
    description: Keyword research and suggestion end-points
  - name: Onboarding
    description: Brand onboarding and strategy end-points
  - name: Brands
    description: Brand management end-points
  - name: Organizations
    description: Organization and member end-points
  - name: Integrations
    description: Google Search Console and other integrations
  - name: Utilities
    description: Common utility end-points like screenshots and uploads
externalDocs:
  url: https://snowseo.com/docs
  description: Find more info here
paths:
  /v3/outreach/prospects/find-people:
    post:
      tags:
        - Outreach
      summary: Find contacts at prospects' sites
      description: >-
        Look up the people worth pitching at one site or a batch of them -
        editors, authors, whoever can actually add the link. Returns up to 100
        people per site per call, and NEVER returns anyone the prospect already
        has - so calling it again is how you fetch the next 100 of the same
        search. Runs in the background; poll outreach_prospects while each
        site's status is finding_people, then read the result with
        outreach_prospect_people. Costs 5 credits per site and is refunded when
        a site yields nobody new, so re-running it on a prospect that is already
        fully searched is free but pointless. Skipped at no cost: sites whose
        search is already running, creators on shared platforms like YouTube or
        Medium, where the searchable domain belongs to the platform rather than
        the person you are pitching, and any site where the link is not earned
        by writing to someone - a G2 or Capterra listing you claim yourself, a
        directory you submit to, a Reddit or Stack Overflow thread you answer.
        Read outreach_prospects for those: the playbook field carries the steps
        instead. Also skipped: sites that already link to you (opportunity
        already-linked), since there is nothing left to ask them for.
      operationId: findOutreachProspectPeople
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - prospectIds
              properties:
                prospectIds:
                  type: array
                  minItems: 1
                  maxItems: 50
                  items:
                    type: string
                  description: Prospect IDs to search.
                terms:
                  type: array
                  minItems: 3
                  maxItems: 25
                  items:
                    type: string
                  description: >-
                    Job titles to search for, matched as substrings and OR'd
                    together - 'editor' finds 'Managing Editor'. Between 3 and
                    25 distinct terms; omit to use a sensible default covering
                    editorial, SEO, marketing and owners.
      responses:
        '202':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  enqueuedCount:
                    type: integer
                  enqueuedProspectIds:
                    type: array
                    items:
                      type: string
                  skipped:
                    type: integer
                  creditsCharged:
                    type: number
                additionalProperties: true

````