webclaw

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/feedback

Report a URL that didn't work.

Request body

FieldTypeRequiredDescription
urlstringYesThe URL that didn't work. Must be an absolute http or https URL.
reasonstringYesWhat went wrong. One of the reasons below.
notestringNoAnything that helps us reproduce it, up to 2,000 characters.
request_idstringNoThe ID of the request that failed, if you have one.

Reasons

ReasonUse it when
partial_contentContent is missing or cut short.
wrong_contentThe response shows the wrong page or the wrong content.
blockedThe response is a block, captcha or challenge page instead of the content.
errorThe request failed with an error.
otherSomething 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.

Get started

Ready to build? Start extracting.

Cancel anytime. One key for every format and endpoint.

View on GitHub