Referencia para desarrolladores

Categorización de sitios web

Consulta la documentación de la API de Categorización de sitios web, con parámetros de solicitud, campos de respuesta, ejemplos de código y gestión de errores para integraciones con DomScan.

Categorización de sitios web

Clasifica sitios web en categorías inspiradas en IAB de DomScan mediante análisis de múltiples señales: coincidencia ponderada de palabras clave, schema.org, Open Graph, detección de meta generator, heurísticas de TLD, patrones de URL y estructura HTML. Usa /v1/categorize/taxonomy para listar los ID de categoría y subcategorías compatibles.

GET /v1/categorize

Parámetros de consulta

Parámetro	Tipo	obligatorio
url	string	opcional
domain	string	opcional
skip_cache	string	opcional
min_confidence	integer	opcional

Campos de respuesta

Campo	Tipo
`url`	string
`primary_category`	string \| null
`primary_category_id`	string \| null
`categories[]`	object[]
`categories[]`	object
`categories[].category_id`	string
`categories[].category`	string
`categories[].subcategory_id`	string \| null
`categories[].subcategory`	string \| null
`categories[].confidence`	integer
`categories[].keywords_found[]`	string[]
`categories[].signals[]`	object[]
`categories[].signals[]`	object
`categories[].signals[].source`	string
`categories[].signals[].evidence`	string
`primary_category_confidence`	string
`title`	string \| null
`description`	string \| null
`language`	string \| null
`language_confidence`	string
`adult_content`	boolean
`signals_used`	integer
`cached`	boolean
`total_time_ms`	integer
`checked_at`	string

Solicitud de ejemplo

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/categorize?url=https%3A%2F%2Fexample.com&domain=example.com&skip_cache=example.com&min_confidence=example.com"

Respuesta de ejemplo

{
  "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"
}

GET /v1/categorize/taxonomy

Campos de respuesta

Campo	Tipo
`taxonomy`	string
`version`	string
`official_iab_taxonomy`	boolean
`inspired_by`	string
`category_count`	integer
`subcategory_count`	integer
`notes[]`	string[]
`categories[]`	object[]
`categories[]`	object
`categories[].category_id`	string
`categories[].category`	string
`categories[].taxonomy_name`	string
`categories[].ranked_category`	boolean
`categories[].subcategories[]`	object[]
`categories[].subcategories[]`	object
`categories[].subcategories[].subcategory_id`	string
`categories[].subcategories[].subcategory`	string
`meta`	object

Solicitud de ejemplo

curl "https://domscan.net/v1/categorize/taxonomy"

Respuesta de ejemplo

{
  "taxonomy": "domscan-iab-inspired",
  "version": "v1",
  "official_iab_taxonomy": false,
  "inspired_by": "IAB Tech Lab Content Taxonomy 3.x",
  "category_count": 35,
  "subcategory_count": 134,
  "notes": [
    "DomScan returns IAB-style IDs from its own IAB-inspired taxonomy.",
    "The category field matches the value returned by /v1/categorize for backward compatibility.",
    "IAB29 Adult is primarily exposed through the adult_content boolean in categorization responses."
  ],
  "categories": [
    {
      "category_id": "IAB22",
      "category": "E-commerce",
      "taxonomy_name": "Shopping & E-commerce",
      "ranked_category": true,
      "subcategories": [
        {
          "subcategory_id": "IAB22-1",
          "subcategory": "Online Retail"
        },
        {
          "subcategory_id": "IAB22-2",
          "subcategory": "Deals & Coupons"
        }
      ]
    },
    {
      "category_id": "IAB25",
      "category": "SaaS & Cloud",
      "taxonomy_name": "SaaS & Cloud",
      "ranked_category": true,
      "subcategories": [
        {
          "subcategory_id": "IAB25-3",
          "subcategory": "Developer Tools"
        }
      ]
    }
  ]
}

POST /v1/categorize/bulk

Parámetros del cuerpo

Parámetro	Tipo	obligatorio
urls	string[]	obligatorio

Campos de respuesta

Campo	Tipo
`results[]`	object[]
`results[]`	object
`results[].url`	string
`results[].primary_category`	string \| null
`results[].primary_category_id`	string \| null
`results[].categories[]`	object[]
`results[].categories[]`	object
`results[].categories[].category_id`	string
`results[].categories[].category`	string
`results[].categories[].subcategory_id`	string \| null
`results[].categories[].subcategory`	string \| null
`results[].categories[].confidence`	integer
`results[].categories[].keywords_found[]`	string[]
`results[].categories[].signals[]`	object[]
`results[].categories[].signals[]`	object
`results[].categories[].signals[].source`	string
`results[].categories[].signals[].evidence`	string
`results[].primary_category_confidence`	string
`results[].title`	string \| null
`results[].description`	string \| null
`results[].language`	string \| null
`results[].language_confidence`	string
`results[].adult_content`	boolean
`results[].signals_used`	integer
`results[].cached`	boolean
`results[].total_time_ms`	integer
`results[].checked_at`	string
`meta`	object
`meta.total`	integer
`meta.duration_ms`	integer

Solicitud de ejemplo

curl -X POST "https://domscan.net/v1/categorize/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "urls": [
    "github.com",
    "amazon.com",
    "bbc.com"
  ]
}'

Respuesta de ejemplo

{
  "results": [
    {
      "url": "https://example.com",
      "primary_category": "string",
      "primary_category_id": "string",
      "categories": [
        {
          "category_id": "string",
          "category": "string",
          "subcategory_id": "string",
          "subcategory": "string",
          "confidence": 1,
          "keywords_found": [
            "string"
          ],
          "signals": [
            {
              "source": "string",
              "evidence": "string"
            }
          ]
        }
      ],
      "primary_category_confidence": "high",
      "title": "string",
      "description": "198.51.100.10",
      "language": "string",
      "language_confidence": "high",
      "adult_content": true,
      "signals_used": 1,
      "cached": true,
      "total_time_ms": "2026-04-15T12:00:00Z",
      "checked_at": "2026-04-15T12:00:00Z"
    }
  ],
  "meta": {
    "total": 1,
    "duration_ms": 1
  }
}