Docs

Call CreatorFinder in one HTTP request.

CreatorFinder verifies public creator source URLs. Send a page URL and receive a verified creator profile or a stable rejection reason.

Updated April 29, 2026

Base URLs

API https://api.creatorfinder.dev

OpenAPI https://api.creatorfinder.dev/openapi.json

Agent context https://creatorfinder.dev/llms.txt

Full AI context https://creatorfinder.dev/llms-full.txt

Verify One Source URL

Use this endpoint when you already have a public creator page, link-in-bio page, profile page, or contact page. The email must appear on the live page, and the page must include at least one supported creator profile URL.

curl -X POST https://api.creatorfinder.dev/v1/creator-discovery/verify \
  -H "content-type: application/json" \
  -d '{
    "source_url": "https://creator.example/profile",
    "min_social_count": 1,
    "require_business_email_context": true
  }'

Accepted Response

{
  "accepted": true,
  "profile": {
    "public_email": "creator@example.com",
    "email_source_url": "https://creator.example/profile",
    "source_checked_at": "2026-04-29T00:00:00Z",
    "social_urls": [
      {"platform": "instagram", "url": "https://www.instagram.com/creator"}
    ],
    "confidence_score": 0.92
  }
}

Rejected Response

Rejections are useful output. They tell a human or agent why a page was not accepted and whether retrying makes sense.

{
  "accepted": false,
  "rejection": {
    "source_url": "https://creator.example/profile",
    "code": "missing_email",
    "reason": "no usable public email found",
    "retryable": false
  }
}

Quote A Job

Quotes return the launch unit price, maximum total, and provider plan. The current deployed Worker exposes the job contract and provider plan; broad provider-backed fanout requires the hosted provider queue to be enabled.

curl -X POST https://api.creatorfinder.dev/v1/creator-discovery/jobs/quote \
  -H "content-type: application/json" \
  -d '{
    "max_results": 50,
    "source_providers": ["sitemap", "common_crawl", "customer_seed"]
  }'

Common Error Codes

source_url_not_allowed The URL targets localhost, a private network, or a blocked host.

missing_email No usable public email appeared on the fetched live page.

missing_social The page did not include enough supported creator profile URLs.

rate_limited The caller exceeded the current API rate-limit window.

Agent Discovery

Agents should read the short routing file first, then inspect OpenAPI and the runtime payment metadata. Runtime API metadata is authoritative.

Short agent file /llms.txt

Full AI context /llms-full.txt

Capability manifest /.well-known/agent-capabilities.json

x402 metadata /.well-known/x402