# CreatorFinder

> CreatorFinder verifies public creator source URLs and returns source-backed
> creator contact records. Accepted results include a public email, social
> profile URLs, source URL, verification timestamp, confidence score, and
> provenance metadata.

## Canonical URLs

- [Homepage](https://creatorfinder.dev/)
- [Human docs](https://creatorfinder.dev/docs/)
- [API origin](https://api.creatorfinder.dev)
- [OpenAPI](https://api.creatorfinder.dev/openapi.json)
- [x402 metadata](https://api.creatorfinder.dev/.well-known/x402)
- [Agent capability manifest](https://api.creatorfinder.dev/.well-known/agent-capabilities.json)
- [Full AI context](https://creatorfinder.dev/llms-full.txt)

## Primary Operations

- `POST /v1/creator-discovery/verify`: verify one customer-supplied public source URL.
- `POST /v1/creator-discovery/jobs/quote`: quote a creator discovery job.
- `POST /v1/creator-discovery/jobs`: create an async discovery job.
- `GET /v1/creator-discovery/jobs/{job_id}`: get job status.
- `GET /v1/creator-discovery/jobs/{job_id}/results`: get JSON results.
- `GET /v1/creator-discovery/jobs/{job_id}/results.csv`: get CSV results.
- `GET /v1/creator-discovery/providers`: inspect the provider pool.
- `POST /v1/creator-discovery/opt-out`: request suppression or removal.

## Verified Result Rule

An accepted profile must pass live verification:

- the current public source page was fetched
- the exact public email string appears on that page
- at least one supported public social/profile URL appears on that page
- source URL, fetch status, extraction version, and timestamp are retained

## Pricing

- Launch unit price: USD 0.010000 per verified creator result.
- Runtime payment metadata and 402 challenges, when enabled, are authoritative.
- Agents should enforce budget caps and use idempotency keys for state-changing calls.

## Boundaries

CreatorFinder uses public pages and customer-provided public source URLs. It
does not guess emails, use private datasets, use breach data, or return records
without live source-page proof.