Skip to main content

Overview

The WraithBytes API provides a unified interface for acquiring structured data from any web page. One endpoint handles all platforms — the system automatically detects the site type and applies the appropriate parser.

Base URL

All API requests should be made to:
https://web-acq.wraithbytes.com/api/v1/

Authentication

All API endpoints require Bearer token authentication. Include your API key in the Authorization header of every request:
Authorization: Bearer YOUR_API_KEY
Keep your API key secure and never share it publicly. If you believe your key has been compromised, regenerate it immediately from the dashboard.

Rate Limits

WraithBytes API has no rate limits. You can make unlimited concurrent requests.

Endpoints

Fetch URL

POST /api/v1/internet/fetch/ — Fetch and parse any web page

Fetch Results

GET /api/v1/fetch/results/ — Retrieve historical fetch results

Response Format

All API responses follow a consistent JSON envelope:
{
  "success": true,
  "status": "success",
  "data": { ... }
}

Error Handling

Errors are returned with appropriate HTTP status codes:
CodeDescription
400Bad Request — invalid URL format or missing parameters
401Unauthorized — missing or invalid API key
402Payment Required — insufficient token balance
500Internal Server Error — system error or fetch failure
Error response format:
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable error message"
  }
}

Token Costs

Request TypeTokensCost
Standard fetch1$0.0005
AI summary5$0.0025
AI JSON extraction8$0.0040
AI image/audio (beta)
Fetch results0Free
See Token Economics for full pricing details.