Hunt Townh402
Catalog
ResearchPOSTlive

Web research task

Start an autonomous multi-hop web research task; returns a run id to poll for the report.

$0.10
per call
Success
100%
p50 latency
3.02s
p95 latency
3.17s
Calls (30d)
2
Flow① Web research task (this step) →②Web research task status(free)— the response's native job handle feeds step ②; agents get the same provider-pinned hint in h402.followUp.

Provider contract

Call path
/routes/parallel/research/web-task-async
Method
POST
Selected provider
paralleldefault
Provider price
$0.10
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/parallel/research/web-task-async' \
  -H 'content-type: application/json' \
  -d '{"query":"What are the top 3 open-source vector databases in 2026 and their license types?"}'
CLI
h402 call 'research/web-task-async' --provider 'parallel' --method POST --json '{"query":"What are the top 3 open-source vector databases in 2026 and their license types?"}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

querystringrequired

The research question or task to investigate across the web. Runs as an autonomous multi-hop research job; the report is retrieved from research/web-task-async-status.

e.g.
POST/routes/parallel/research/web-task-async
Request body
{
  "query": "What are the top 3 open-source vector databases in 2026 and their license types?"
}

This starts a job — poll Web research task status (research/web-task-async-status) for the final result.

ResponseExample response
{
  "data": {
    "run_id": "trun_2eef201ee9e84ae1a303dffcf39d6e4b",
    "interaction_id": "trun_2eef201ee9e84ae1a303dffcf39d6e4b",
    "status": "queued",
    "is_active": true,
    "warnings": [
      {
        "type": "warning",
        "message": "enable_events unset for pro. Setting to true by default. Consider setting to false explicitly if you do not want to track events for streaming."
      }
    ],
    "processor": "pro",
    "metadata": {},
    "created_at": "2026-07-22T15:47:21.790277Z",
    "modified_at": "2026-07-22T15:47:21.796561Z",
    "poll_url": "/api/task/trun_2eef201ee9e84ae1a303dffcf39d6e4b"
  },
  "h402": {
    "routeId": "research/web-task-async",
    "provider": "parallel",
    "selectedCandidateId": "research/web-task-async/parallel",
    "routing": "manual",
    "followUp": {
      "routeId": "research/web-task-async-status",
      "path": "/routes/parallel/research/web-task-async-status",
      "method": "GET",
      "params": {
        "run_id": "trun_2eef201ee9e84ae1a303dffcf39d6e4b"
      },
      "docsUrl": "https://h402-test.hunt.town/catalog/research/web-task-async-status",
      "instruction": "This response is a job receipt, not the final result. Poll GET /routes/parallel/research/web-task-async-status with the returned id as run_id (free) until the provider reports completion — terminal status labels are provider-native, and a failure status means the job errored. Final-result example: https://h402-test.hunt.town/catalog/research/web-task-async-status"
    },
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

parallel
x402mpp
100
Success
100%
p50
3.02s
Calls
2
100%
$0.10$0.100/call
Last successful call: 24d ago· Aggregated by h402 — not the source provider