Quickstart

First extraction in four steps

Create an account, grab a token, extract comments from a public URL, then export JSON.

1. Create an account

Open commenthunter.click/login. Free accounts include starter credits. Store secrets as environment variables. Never put keys in prompts, client-side public repos, or webhook payloads you do not control.

2. Get a Bearer token

REST calls use the Supabase project:

• Base: https://jdstzpeukxcxxnodvess.supabase.co/functions/v1
• apikey header: the project anon/publishable key
• Authorization: Bearer: user access JWT from sign-in (preferred; deducts that user's credits). For unauthenticated tests, the anon key may be passed as Bearer as well, subject to anonymous limits.

After email or Google sign-in, the browser stores a Supabase session. Copy access_token from the session for agent use, or sign in via POST /auth/v1/token?grant_type=password.

3. Extract comments

curl "https://jdstzpeukxcxxnodvess.supabase.co/functions/v1/extract-comments" \
  --header "Authorization: Bearer $COMMENTHUNTER_USER_JWT" \
  --header "apikey: $COMMENTHUNTER_ANON_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "urls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],
    "limit": 50,
    "includeReplies": true
  }'

Success returns comments, topLevelCount, creditsUsed, and optional partial if the job is still collecting. Failures return errorCode and errorMessage — see Errors.

4. Point an agent at the contract

• OpenAPI: https://commenthunter.click/openapi.json
• Short LLM index: https://commenthunter.click/llms.txt
• Full LLM docs: https://commenthunter.click/llms-full.txt

The API does not bypass plan entitlements. Credit multipliers still apply.