Response Schema
The Website Categorization API returns structured JSON responses containing domain categorization data. This dictionary defines all fields and their meanings to help you correctly interpret and use the data in your applications.
Categorization Response
The main categorization endpoint returns the following structure:
{
"domain": "example.com",
"categories": [...],
"meta": {...},
"enrichment": {...}
}
Root Fields
| Field |
Type |
Description |
domain |
string |
The domain that was categorized, normalized to lowercase without protocol or path. |
categories |
array |
Array of category objects representing the domain's content classifications. Contains 1-5 categories ordered by confidence score. |
meta |
object |
Metadata about the API request including request ID, processing time, and usage information. |
enrichment |
object |
Optional additional data about the domain (available on higher-tier plans). |
Category Object Fields
| Field |
Type |
Description |
id |
string |
IAB category identifier (e.g., "IAB19-6"). Unique identifier for the category in the taxonomy. |
name |
string |
Human-readable category name (e.g., "Technology & Computing > Software"). |
tier |
integer |
Category depth in the taxonomy hierarchy. Tier 1 is top-level, Tier 2 is sub-category, etc. Range: 1-4. |
confidence |
float |
Confidence score for this categorization. Range: 0.0 to 1.0, where 1.0 indicates highest confidence. |
parent_id |
string |
ID of the parent category (null for Tier 1 categories). Enables traversing the category hierarchy. |
Meta Object Fields
| Field |
Type |
Description |
request_id |
string |
Unique identifier for this API request. Include in support requests for troubleshooting. |
processing_time_ms |
integer |
Server-side processing time in milliseconds. |
credits_used |
integer |
Number of API credits consumed by this request. |
cached |
boolean |
Whether the result was served from cache (true) or computed in real-time (false). |
last_updated |
string |
ISO 8601 timestamp of when this domain was last analyzed. |
Enrichment Object Fields
Available on Professional and higher plans:
| Field |
Type |
Description |
business_model |
string |
Detected business model (e.g., "saas", "ecommerce", "publisher", "marketplace"). |
audience |
string |
Primary target audience (e.g., "b2b", "b2c", "enterprise", "smb"). |
traffic_tier |
string |
Relative traffic level (e.g., "high", "medium", "low", "minimal"). |
company_size |
string |
Estimated company size (e.g., "enterprise", "mid_market", "small_business", "startup"). |
technologies |
array |
Array of detected technologies on the website (CMS, analytics, frameworks, etc.). |
Confidence Score Interpretation
Use confidence scores to filter results based on your quality requirements:
- 0.90 - 1.00: Very high confidence, suitable for automated decisions
- 0.75 - 0.89: High confidence, reliable for most use cases
- 0.50 - 0.74: Moderate confidence, consider human review for critical decisions
- Below 0.50: Lower confidence, treat as suggestions rather than definitive classifications