API Reference
Feedback System
Submit feedback about scraping results to help improve domain strategies. Two paths available: programmatic API and web form.
Overview
PayPerScrape provides two ways to submit feedback about scraping results:
- API Endpoint - For programmatic submissions from your application
- Web Form - For human users to submit feedback via the web interface
Feedback helps improve domain strategies by identifying issues like incomplete content, JavaScript requirements, geo-blocking, and more.
API Endpoint
POST https://payperscrape.com/api/feedback/submit
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| domain | string | Yes | Domain that was scraped (must match a domain you scraped in last 24 hours) |
| issue_type | enum | Yes | Type of issue encountered (see Issue Types below) |
| wallet | string | No | Wallet address used for payment (optional but recommended) |
| original_request_id | string | No | Optional request ID from your scraping request |
| notes | string | No | Additional notes (max 300 characters) |
Request Example
API Feedbackjson
Issue Types (API)
| Value | Description |
|---|---|
| INCOMPLETE | Content appears incomplete or truncated |
| NEEDS_JS | Domain requires JavaScript rendering to display content |
| NEEDS_PROXY | Domain requires premium proxy to access |
| LOGIN_WALL | Content is behind a login wall |
| GEO_BLOCKED | Content is blocked by geographic restrictions |
| UNEXPECTED_STRUCTURE | HTML structure is unexpected or malformed |
| OTHER | Other issues not covered above |
Web Form
The web form is available at /feedback and includes:
- CAPTCHA verification (Cloudflare Turnstile)
- Domain auto-detection from URL parameters
- Issue type selection
- Requirement flags (JS, Geo, Premium, Login)
- Optional notes field (max 1000 characters)
- Optional email for follow-up
Issue Types (Web)
| Value | Description |
|---|---|
| incomplete | Content appears incomplete or truncated |
| login-wall | Content is behind a login wall |
| wrong-content | Wrong content was returned |
| broken-html | HTML structure is broken or malformed |
| geo-blocked | Content is blocked by geographic restrictions |
| other | Other issues not covered above |
Rate Limits
Feedback endpoints have strict rate limits to prevent abuse:
API Endpoint (/api/feedback/submit)
- IP-based: 5 requests per hour
- Wallet-based: 3 requests per hour (stricter)
- Domain must be scraped in last 24 hours
Web Form (/api/feedback/web)
- IP-based: 3 requests per hour
- CAPTCHA required (Cloudflare Turnstile)
- Domain must be scraped in last 7 days
Response
Success Response (200)
Successjson
Error Responses
| Code | Description |
|---|---|
| 400 | Invalid request body or validation error |
| 403 | Domain not scraped recently, CAPTCHA failed (web), or wallet mismatch |
| 413 | Request body exceeds 10 KB limit |
| 429 | Rate limit exceeded (check Retry-After header) |
| 500 | Internal server error |
How Feedback Helps
When you submit feedback, it helps improve domain strategies:
- Automatic Strategy Updates: Approved feedback can automatically update domain strategies (e.g., force JS rendering or premium mode)
- Better Future Scrapes: Your feedback helps ensure future scrapes of the same domain use the optimal strategy
- Community Benefit: Your feedback benefits all users scraping the same domain
Note: All feedback is moderated. Approved feedback may trigger automatic domain strategy updates to improve scraping results.