API Reference

Authorization: Bearer YOUR_API_KEY

# Install: curl is available on all platforms

curl -X POST https://categorizeapi.com/api/categorize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "https://example.com", "type": "auto"}'

{
  "success": true,
  "category": "Technology & Computing",
  "subcategory": "Web Services",
  "confidence": 0.93,
  "reasoning": "The page describes a software product and its documentation.",
  "input_type": "url",
  "processing_time": 1.14,
  "requests_remaining": 4997
}

{
  "input": "https://example.com/blog/electric-vehicles-2030",
  "type": "auto"
}

{
  "success": true,
  "category": "News & Politics",
  "subcategory": "World News",
  "confidence": 0.87,
  "reasoning": "The text reports on an international diplomatic event.",
  "input_type": "text",
  "processing_time": 0.92,
  "requests_remaining": 4996
}

{
  "error": "Invalid API key"
}

curl -X POST https://categorizeapi.com/api/categorize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "https://www.espn.com",
    "type": "url"
  }'

curl -X POST https://categorizeapi.com/api/categorize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "The Federal Reserve announced a quarter-point rate cut today, citing cooling inflation and a softening labor market.",
    "type": "text"
  }'

class CategorizeAPIClient {
  constructor(apiKey, baseURL = 'https://categorizeapi.com/api') {
    this.apiKey = apiKey;
    this.baseURL = baseURL;
  }

  async categorize(input, type = 'auto') {
    const res = await fetch(`${this.baseURL}/categorize`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ input, type })
    });
    if (!res.ok) {
      const err = await res.json();
      throw new Error(err.error || 'API error');
    }
    return res.json();
  }
}

// Usage
const client = new CategorizeAPIClient('YOUR_API_KEY');

const result = await client.categorize('https://example.com');
console.log('Category:', result.category);
console.log('Confidence:', Math.round(result.confidence * 100) + '%');

import requests

class CategorizeAPIClient:
    def __init__(self, api_key: str, base_url: str = "https://categorizeapi.com/api"):
        self.api_key = api_key
        self.base_url = base_url

    def categorize(self, input: str, type: str = "auto") -> dict:
        response = requests.post(
            f"{self.base_url}/categorize",
            headers={"Authorization": f"Bearer {self.api_key}"},
            json={"input": input, "type": type},
            timeout=30
        )
        response.raise_for_status()
        return response.json()

# Usage
client = CategorizeAPIClient("YOUR_API_KEY")
result = client.categorize("https://example.com")

print(f"Category: {result['category']}")
print(f"Confidence: {round(result['confidence'] * 100)}%")

<?php

class CategorizeAPIClient {
    private string $apiKey;
    private string $baseUrl = 'https://categorizeapi.com/api';

    public function __construct(string $apiKey) {
        $this->apiKey = $apiKey;
    }

    public function categorize(string $input, string $type = 'auto'): array {
        $payload = json_encode(['input' => $input, 'type' => $type]);
        $ch = curl_init($this->baseUrl . '/categorize');
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_POST           => true,
            CURLOPT_POSTFIELDS     => $payload,
            CURLOPT_HTTPHEADER     => [
                'Authorization: Bearer ' . $this->apiKey,
                'Content-Type: application/json'
            ],
            CURLOPT_TIMEOUT        => 30
        ]);
        $body     = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        if ($httpCode !== 200) {
            $err = json_decode($body, true);
            throw new \RuntimeException($err['error'] ?? 'API error');
        }
        return json_decode($body, true);
    }
}

// Usage
$client = new CategorizeAPIClient('YOUR_API_KEY');

$result = $client->categorize('https://example.com');

echo $result['category'] . PHP_EOL;
echo $result['confidence'] . PHP_EOL;