Skip to main content

​
Get started in three steps

Start acquiring structured web data with the WraithBytes API.

​
Step 1: Get your API key

Sign up for a WraithBytes account and generate your API key from the dashboard.
Keep your API key secure. Never commit it to version control or share it publicly.
Store your API key in environment variables:
export WRAITHBYTES_API_KEY="your_api_key_here"
Or in your .env file:
WRAITHBYTES_API_KEY=your_api_key_here
Add .env to your .gitignore to prevent accidentally committing your API key.

​
Step 2: Make your first request

All web acquisition goes through a single endpoint: POST /api/v1/internet/fetch/ 
curl -X POST https://web-acq.wraithbytes.com/api/v1/internet/fetch/ \
  -H "Authorization: Bearer $WRAITHBYTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.linkedin.com/in/username",
    "options": {
      "json": true
    }
  }'

const response = await fetch('https://web-acq.wraithbytes.com/api/v1/internet/fetch/', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.WRAITHBYTES_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://www.linkedin.com/in/username',
    options: {
      json: true
    }
  })
});

const data = await response.json();
console.log(data);

import os
import requests

url = "https://web-acq.wraithbytes.com/api/v1/internet/fetch/"
headers = {
    "Authorization": f"Bearer {os.getenv('WRAITHBYTES_API_KEY')}",
    "Content-Type": "application/json"
}
payload = {
    "url": "https://www.linkedin.com/in/username",
    "options": {
        "json": True
    }
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data)

package main

import (
    "context"
    "fmt"
    "log"
    "os"

    wraithbytes "github.com/wraithbytes/sdk-go"
)

func main() {
    client := wraithbytes.NewClient(os.Getenv("WRAITHBYTES_API_KEY"))

    resp, err := client.Fetch(context.Background(), &wraithbytes.FetchRequest{
        URL: "https://www.linkedin.com/in/username",
        Options: &wraithbytes.FetchOptions{
            JSON: true,
        },
    })
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("Success: %v\nData: %v\n", resp.Success, resp.Data)
}
Install the SDK: go get github.com/wraithbytes/sdk-go

​
Step 3: Handle the response

All responses follow the same envelope structure:
{
  "success": true,
  "status": "success",
  "data": {
    "name": "John Doe",
    "location": "San Francisco, CA",
    "about": "Software engineer...",
    "experience": [...],
    "education": [...],
    "skills": ["Python", "Go", "JavaScript"]
  }
}
When an error occurs:
{
  "success": false,
  "error": {
    "code": "INVALID_URL",
    "message": "Invalid URL format"
  }
}
Check the API Reference for detailed response schemas.
Token Cost: This request costs 1 token ($0.0005). AI enrichment costs 5–8 tokens depending on the option. See Token Economics for details.

​
Next steps

Token Economics

Understand pricing and free tier

Configuration

Explore output formats and options

Custom Web Parsers

See all supported platforms

Go SDK

Use the official Go client library

​
Common use cases

Fetch LinkedIn profiles to enrich your CRM data with structured professional information.
Acquire company data, product listings, and reviews at scale from multiple platforms.
Extract articles, news, and blog posts as clean Markdown for AI processing.
Monitor competitor websites, product pages, and job listings over time using historical results.