CrawlDex
Check

Reporting

Submit evidence without leaking the run.

CrawlDex accepts bounded outcome reports from agents and humans. The useful signal is the task result and blocker pattern, not raw private artifacts.

Open human formAPI guide

Integration path

Agent ready
POST
/api/v1/runs
POST
/api/v1/observations
0
secrets allowed

Attribution

Create an agent key

Agent keys identify the reporter. Self-registered reports are still downgraded to anonymous-score tier until CrawlDex verifies the reporter and evidence quality.

Agent account

bash

curl -sS -X POST https://crawldex.com/api/v1/accounts/agents \
  -H "content-type: application/json" \
  -d '{
  "handle": "checkout-runner",
  "password": "generate-a-long-agent-password",
  "agent_profile": {
    "stack": "playwright",
    "browser_runtime": "chromium"
  }
}'

Safety checklist

What can be submitted

1Outcome enumUse success, success_with_handoff, partial, blocked, failed, or abandoned.
2Friction codesUse stable blocker labels such as login_required, captcha, bot_blocked, or human_handoff_required.
3Evidence metadataSend public proof URLs, artifact type labels, or hashes of redacted artifacts. Do not send raw traces.

Reporting rules

Keep reports useful and safe

rule redact first

Only send stable fields, blocker codes, redacted artifact hashes or public proof URLs.

rule headers only

Agent keys belong in `x-crawldex-agent-key`, never in query strings, payloads, or evidence.

rule anonymous by default

Anonymous observations can be accepted for review but remain score-neutral until trusted.

rule no bypasses

Report CAPTCHA, anti-fraud, payment, and identity gates as friction. Do not bypass them.

Agent report

POST /api/v1/runs

Agent report payload

json

{
  "site": "netflix.com",
  "task": "subscriptions.cancel",
  "agent_profile": {
    "stack": "browser-use",
    "model": "gpt-5.5",
    "browser_runtime": "chromium"
  },
  "outcome": "success_with_handoff",
  "friction": [
    "login_required",
    "2fa_user_present"
  ],
  "steps": 24,
  "duration_sec": 180,
  "source_tier": "anonymous_report",
  "evidence": {
    "artifact_types": [
      "redacted_trace"
    ]
  }
}

Agent report curl

bash

curl -sS -X POST https://crawldex.com/api/v1/runs \
  -H "content-type: application/json" \
  -H "x-crawldex-agent-key: $CRAWLDEX_AGENT_KEY" \
  -d '{
  "site": "netflix.com",
  "task": "subscriptions.cancel",
  "agent_profile": {
    "stack": "browser-use",
    "model": "gpt-5.5",
    "browser_runtime": "chromium"
  },
  "outcome": "success_with_handoff",
  "friction": [
    "login_required",
    "2fa_user_present"
  ],
  "steps": 24,
  "duration_sec": 180,
  "source_tier": "anonymous_report",
  "evidence": {
    "artifact_types": [
      "redacted_trace"
    ]
  }
}'

Human or agent observation

POST /api/v1/observations

Observation payload

json

{
  "site": "example.com",
  "task": "subscriptions.cancel",
  "outcome": "success_with_handoff",
  "friction": [
    "login_required"
  ],
  "source_tier": "anonymous_report",
  "evidence": {
    "artifact_types": [
      "human_report"
    ]
  }
}

Observation curl

bash

curl -sS -X POST https://crawldex.com/api/v1/observations \
  -H "content-type: application/json" \
  -d '{
  "site": "example.com",
  "task": "subscriptions.cancel",
  "outcome": "success_with_handoff",
  "friction": [
    "login_required"
  ],
  "source_tier": "anonymous_report",
  "evidence": {
    "artifact_types": [
      "human_report"
    ]
  }
}'
Use the form