Everything you need to integrate the Website Categorization API into your applications. Detailed endpoint references, parameters, and examples.
All API requests require authentication using a Bearer token. Include your API key in the Authorization header with every request. You can obtain your API key from your account dashboard after registration.
Authorization: Bearer YOUR_API_KEY
All API endpoints use the following base URL:
https://api.websitecategorizationapi.com/v1
Returns IAB taxonomy categories for a given domain with confidence scores.
| Parameter | Type | Description |
|---|---|---|
| domain required | string | The domain to categorize (e.g., "example.com") |
| taxonomy optional | string | IAB taxonomy version: "v2" or "v3" (default: "v2") |
| min_confidence optional | float | Minimum confidence threshold 0-1 (default: 0.5) |
curl -X GET "https://api.websitecategorizationapi.com/v1/categorize?domain=spotify.com&taxonomy=v2" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"domain": "spotify.com",
"categories": [
{
"id": "IAB1-6",
"name": "Music & Audio",
"tier": 2,
"confidence": 0.96
},
{
"id": "IAB1",
"name": "Arts & Entertainment",
"tier": 1,
"confidence": 0.94
}
],
"meta": {
"request_id": "req_abc123",
"credits_used": 1,
"cached": true
}
}
The API uses standard HTTP status codes and returns detailed error messages:
Invalid parameters or malformed request. Check your domain format.
Missing or invalid API key. Verify your Authorization header.
Too many requests. Implement exponential backoff or upgrade your plan.
Internal server error. Retry with exponential backoff.