Report a URL
Tell us about a URL that returned missing, wrong or blocked content. Reports go to the Webclaw team, who use them to decide which sites to fix first. Reporting costs no credits.
POST
/v1/feedbackReport a URL that didn't work.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
url | string | Yes | The URL that didn't work. Must be an absolute http or https URL. |
reason | string | Yes | What went wrong. One of the reasons below. |
note | string | No | Anything that helps us reproduce it, up to 2,000 characters. |
request_id | string | No | The ID of the request that failed, if you have one. |
Reasons
| Reason | Use it when |
|---|---|
partial_content | Content is missing or cut short. |
wrong_content | The response shows the wrong page or the wrong content. |
blocked | The response is a block, captcha or challenge page instead of the content. |
error | The request failed with an error. |
other | Something else. Describe it in note. |
Example
curl
curl -X POST https://api.webclaw.io/v1/feedback \
-H "Authorization: Bearer wc_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/pricing",
"reason": "partial_content",
"note": "The pricing table is missing from the markdown."
}'Response
A new report returns 201 Created with its ID.
json
{
"id": "6d1f3c2a-8b4e-4f7a-9c11-2e5b7a0d9f43"
}Note
You can send up to 10 reports a minute. Past that the endpoint returns
429; wait a minute and try again. Reports need an account API key, and a request with an invalid body returns 400 with the reason in error.