Website Categorization API - Classify Website Content

Category Web Intelligence

Endpoints 3

Key Features 8

Frequently Asked Questions 4

Used by people at amazing companies

Trust signals before you integrate

Transparent docs, authenticated requests, and visible reliability details make it easier to evaluate DomScan before you ship.

99.99% Uptime

Production-ready endpoints are designed for 99.99% uptime and documented status handling.

OpenAPI API artifacts

OpenAPI, Swagger, Postman, CLI, SDK, and MCP links are one click away.

API keys Protected access

Authenticated endpoints use API keys with clear credit costs before you call them.

10,000 Free allowance

Start with 10,000 monthly credits and upgrade only when usage grows.

What this API helps you ship

Use this page as a production brief: endpoints, examples, response shape, and the workflow pieces needed to plug DomScan into your own product.

Product workflows

Embed domain checks, DNS intelligence, risk signals, or enrichment into onboarding, search, and internal tools.

Analyst automation

Replace repeated manual lookups with scheduled jobs, alerting, and reproducible investigation steps.

Clean JSON data

Use predictable fields, documented status codes, and credit costs instead of scraping provider pages.

AI and ops tooling

Feed agents, dashboards, SOAR playbooks, and CRMs through OpenAPI, SDK, Postman, or MCP.

Integration workflow

A simple path from first request to repeatable production usage.

Authenticate once

Send your API key with the documented header and keep requests consistent across services.

Query with examples

Start from the curl and HTTP samples, then map the parameters into your application code.

Operate and monitor

Use status codes, credit costs, and response fields to build retries, logs, and alerts.

Developer kit

Jump from this page into machine-readable docs, request collections, SDKs, or agent tooling.

OpenAPI schema

Generate clients or inspect every request and response shape.

Postman collection

Import ready-made requests for manual testing and team handoff.

SDKs and CLI

Use maintained packages and command-line workflows instead of writing boilerplate.

MCP integration

Expose domain intelligence to AI agents and internal assistant workflows.

Parameters and response map

Scan the inputs, output fields, and status codes before wiring the endpoint into your client.

Request parameters

Parameter

urldomaincategoriessubcategoriesdomainsurls

Response fields

Example Response

urlprimary_categoryprimary_category_idcategoriesprimary_category_confidencetitledescriptionlanguagelanguage_confidenceadult_contentsignals_usedcached

Status coverage

HTTP Status Codes

200400402429500502503504

Endpoints

GET /v1/categorize

Credits: 2Authentication: optional

urldomain

GET /v1/categorize/taxonomy

Credits: 0Authentication: optional

categoriessubcategories

POST /v1/categorize/bulk

Credits: 2Authentication: optional

domainsurls

Trust signals before you integrate

Transparent docs, authenticated requests, and visible reliability details make it easier to evaluate DomScan before you ship.

Uptime API artifacts

OpenAPI, Swagger, Postman, CLI, SDK, and MCP links are one click away.

API keys Protected access

Authenticated endpoints use API keys with clear credit costs before you call them.

Free allowance Sign Up for Free

Start with 10,000 monthly credits and upgrade only when usage grows.

Active Example Request

Start from the curl and HTTP samples, then map the parameters into your application code.

Key Features

35 Top-Level Categories

IAB-inspired taxonomy with 35 top-level categories and 134 subcategories covering E-commerce, Technology, News, Business, Finance, Education, Gaming, and more.

Confidence Scores

Know how confident each category classification is.

Keyword Evidence

See which keywords triggered each category match.

Multiple Categories

Sites often fit multiple categories - we show the top matches.

Metadata Extraction

Extract page title, description, and language.

Adult Content Flag

Detect potentially adult or NSFW content.

Language Detection

Identify the primary language of the page.

Content Analysis

Deep analysis of page text content.

Example Request

GET /v1/categorize bash

Open

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/categorize?url=https://example.com"

Example Response

200 OK json

{
  "url": "https://example.com",
  "primary_category": "SaaS & Cloud",
  "primary_category_id": "IAB25",
  "categories": [
    {
      "category_id": "IAB25",
      "category": "SaaS & Cloud",
      "subcategory_id": null,
      "subcategory": null,
      "confidence": 84,
      "keywords_found": [
        "platform",
        "dashboard",
        "enterprise"
      ],
      "signals": [
        {
          "source": "keyword_title",
          "evidence": "Matched platform and dashboard in the page title."
        }
      ]
    },
    {
      "category_id": "IAB19",
      "category": "Technology & Computing",
      "subcategory_id": null,
      "subcategory": null,
      "confidence": 72,
      "keywords_found": [
        "api",
        "developer",
        "automation"
      ],
      "signals": [
        {
          "source": "keyword_body",
          "evidence": "Developer-focused terms appear repeatedly in page copy."
        }
      ]
    }
  ],
  "primary_category_confidence": "high",
  "title": "Developer platform for AI apps",
  "description": "Build with APIs, models, and cloud workflows",
  "language": "en",
  "language_confidence": "high",
  "adult_content": false,
  "signals_used": 12,
  "cached": false,
  "total_time_ms": 412,
  "checked_at": "2026-04-18T21:00:00Z"
}

Frequently Asked Questions

What categories are supported?

We support 35 IAB-inspired top-level categories and 134 subcategories. Use /v1/categorize/taxonomy to retrieve the exact IDs and response names. Categories include Shopping & E-commerce, Technology & Computing, News & Media, Blog & Personal, Business, Personal Finance, Education, Health & Fitness, Gaming, Sports, Travel, Food & Drink, Real Estate, and many more.

How is categorization determined?

We use multi-signal analysis including weighted keyword matching (title, description, headings, body), schema.org structured data, Open Graph tags, meta generator detection, TLD heuristics (.gov, .edu), URL path patterns, and HTML structure analysis. Categories are ranked by confidence based on aggregated signal strength.

Can a site have multiple categories?

Yes, most sites match multiple categories. We return up to 5 categories sorted by confidence, with the primary category being the highest-confidence match.

Is adult content detection reliable?

Adult content detection looks for common keywords. It may not catch all adult content and could have false positives. Use as a signal, not a definitive filter.

Related Tools & Resources

HTTP Status Codes

We document the HTTP status codes you should handle so you can distinguish successful responses, auth issues, credits, rate limits, missing data, and upstream failures.

OK 200

Request successful

Bad Request 400

Invalid parameters

Payment Required 402

Not enough credits to run this request.

Too Many Requests 429

Rate limit exceeded

Server Error 500

Internal error

Bad Gateway 502

Upstream RDAP error

Service Unavailable 503

Upstream service unavailable or temporarily rate limited.

Gateway Timeout 504

Upstream lookup timed out.

Categorize Websites

View Full API Documentation APIs