Skip to main content
POST
/
api
/
v1
/
internet
/
fetch
Fetch URL
curl --request POST \
  --url https://api.example.com/api/v1/internet/fetch/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "filters": {},
  "options": {
    "options.markdown": true,
    "options.json": true,
    "options.include_links": true,
    "options.include_html": "<string>",
    "options.image_urls": true,
    "options.json_schema": {},
    "options.ai": {}
  }
}
'
{
  "success": true,
  "status": "success",
  "data": {
    "name": "John Doe",
    "location": "San Francisco, CA",
    "about": "Software engineer...",
    "experience": [...]
  }
}

​
Description

The primary endpoint for all web data acquisition. Send any URL and WraithBytes automatically detects the platform, selects the appropriate parser, and returns structured data.
Token Cost: 1 token (standard) | 5 tokens (AI summary) | 8 tokens (AI JSON extraction) | beta (image/audio)

​
Authentication

This endpoint requires Bearer authentication. Include your API key in the Authorization header.
Authorization: Bearer YOUR_API_KEY

​
Request Body

​
url
string
required
The URL to fetch and parse. The platform is auto-detected from the URL host.Examples:
  • https://www.linkedin.com/in/username
  • https://www.amazon.com/dp/B08N5WRWNW
  • https://example.com/any-page
​
filters
object
Parser-specific filters for narrowing results. Available filter keys vary by parser — see the Custom Web Parsers section for each parser’s supported filters.
​
options
object
Controls what data the parser returns. See Fetch Options.

​
Request Examples

​
Basic Fetch

{
  "url": "https://example.com/article"
}

​
Fetch with Options

{
  "url": "https://example.com/article",
  "options": {
    "markdown": true,
    "include_links": true,
    "image_urls": true
  }
}

​
LinkedIn Profile

{
  "url": "https://www.linkedin.com/in/username",
  "options": {
    "json": true
  }
}

​
LinkedIn Job Search with Filters

{
  "url": "https://www.linkedin.com/jobs/search",
  "filters": {
    "search_term": "golang developer",
    "location": "San Francisco",
    "job_types": "full_time",
    "work_arrangement": "remote"
  }
}

​
AI-Enhanced Fetch

{
  "url": "https://example.com/long-article",
  "options": {
    "markdown": true,
    "ai": {
      "summary": true
    }
  }
}

​
Response

​
success
boolean
Whether the request completed successfully.
​
status
string
Status of the fetch operation. "success" on success.
​
data
object
The parsed content. Structure varies by parser — see Custom Web Parsers for platform-specific response formats.
​
error
object
Error details when success is false.

​
Response Example

{
  "success": true,
  "status": "success",
  "data": {
    "name": "John Doe",
    "location": "San Francisco, CA",
    "about": "Software engineer...",
    "experience": [...]
  }
}