> ## 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 Prospects

> Start a background search for sites and pages worth pitching for backlinks.

This starts a search using your brand name, website, tracked keywords, and other brand context. It takes no request body. Your brand name and website must be configured first.

The response returns `status`, `creditsCharged`, and `alreadyRunning`. If a search is already active, it is not charged again. Poll [Outreach Prospects](/docs/api-reference/endpoints/outreach-prospects) while `discoveryStatus`, `mentionCheckStatus`, or `relationshipSweepStatus` is `running` to see results appear.

This costs 25 AI credits. A brand's first automatic discovery is free when its prospect list is first opened.

<Note>
  A `409` means the available search angles were used recently, so another pass would repeat the same sites. Add tracked keywords or a topic cluster before retrying. A `402` means there are not enough credits; a `503` means search is temporarily unavailable.
</Note>


## OpenAPI

````yaml POST /v3/outreach/discover/run
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/discover/run:
    post:
      tags:
        - Outreach
      summary: Find new backlink prospects
      description: >-
        Search for pages that mention this brand or its competitors and turn
        them into prospects worth pitching for a backlink. Takes no arguments:
        the search plan is built from the team's brand name and website, both of
        which must be set in settings first. Runs in the background - poll
        outreach_prospects until discoveryStatus, mentionCheckStatus and
        relationshipSweepStatus are idle. Costs credits, and a run already in
        flight is not charged twice.
      operationId: runOutreachDiscovery
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - running
                  creditsCharged:
                    type: number
                  alreadyRunning:
                    type: boolean
                additionalProperties: true

````