Authentication

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

Base URL

All API endpoints use the following base URL:

https://api.websitecategorizationapi.com/v1

Categorize Endpoint

GET /v1/categorize

Returns IAB taxonomy categories for a given domain with confidence scores.

Parameters

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)

Example Request

                    
curl -X GET "https://api.websitecategorizationapi.com/v1/categorize?domain=spotify.com&taxonomy=v2" \

  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

                    
{

  "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

  }

}

Error Codes

The API uses standard HTTP status codes and returns detailed error messages:

400

Bad Request

Invalid parameters or malformed request. Check your domain format.

401

Unauthorized

Missing or invalid API key. Verify your Authorization header.

429

Rate Limited

Too many requests. Implement exponential backoff or upgrade your plan.

500

Server Error

Internal server error. Retry with exponential backoff.

API Documentation