# CreatorFinder API

Public creator discovery and source verification with email provenance.

## Endpoints

- OpenAPI: https://api.creatorfinder.dev/openapi.json
- Quote a discovery job: POST https://api.creatorfinder.dev/v1/creator-discovery/jobs/quote
- Find creators by niche/platform: POST https://api.creatorfinder.dev/v1/creator-discovery/jobs
- Poll a discovery job: GET https://api.creatorfinder.dev/v1/creator-discovery/jobs/{job_id}
- Get verified results: GET https://api.creatorfinder.dev/v1/creator-discovery/jobs/{job_id}/results
- Verify one source URL: POST https://api.creatorfinder.dev/v1/creator-discovery/verify
- List source providers: GET https://api.creatorfinder.dev/v1/creator-discovery/providers
- Capability manifest: https://api.creatorfinder.dev/.well-known/agent-capabilities.json

## Find Then Verify Flow

1. Call /jobs/quote with niche, platforms, max_results, and optional seed_urls.
2. Call /jobs with the same body and an Idempotency-Key.
3. Poll /jobs/{job_id} until status is completed.
4. Read /jobs/{job_id}/results. Every returned result passed live verification.

## Rules

- Public pages only.
- No guessed emails.
- Every accepted email must appear on the fetched live source page.
- Every accepted profile needs at least one supported social URL.
- Platform/niche filters are applied only after live source verification.
- Results include source URL and source_checked_at.

## Source Provider Priority

1. Public link-in-bio/profile sitemaps.
2. Common Crawl CDX.
3. urlscan.io.
4. Internet Archive CDX.
5. Platform APIs.
6. Customer-provided seed URLs/domains.