Referencia para Desarrolladores

Categorización de sitios web Documentación API

Categorización de sitios web Documentación API: Clasifica sitios web en categorías de industria como comercio electrónico, tecnología, noticias, entretenimiento y más. Utiliza análisis de dominio, señales de contenido y búsquedas en bases de datos conocidas para determinar la categoría principal con puntuación de confianza.

Categorización de sitios web

Clasifica sitios web en categorías de industria como comercio electrónico, tecnología, noticias, entretenimiento y más. Utiliza análisis de dominio, señales de contenido y búsquedas en bases de datos conocidas para determinar la categoría principal con puntuación de confianza.

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

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