Licitadores - Servicio de categoría

El servicio de categorías de solo lectura le permite ver todas las categorías que están registradas en el sistema Xandr. Las categorías se asignan tanto a las marcas como a los creativos: puede ver qué categorías se asignan mediante el servicio de marca o el servicio creativo. A continuación, puede permitir o no permitir estas categorías de marcas y creatividades mediante el servicio de perfiles de anuncios.

Nota:

Para las categorías de sitio y emplazamiento, use el servicio de categoría de contenido.

API de REST

Método HTTP	Endpoint	Description
`GET`	https://api.adnxs.com/category	Ver todas las categorías en el sistema Xandr.
`GET`	https://api.adnxs.com/category/CATEGORY_ID	Ver información acerca de una categoría en particular.

Campos JSON

Nota:

Nuestro sistema usa los campos countries_and_brands y countries_and_regions se definen a continuación para permitir que los creativos relacionados con las apuestas se publiquen en los países y regiones donde están legalmente permitidos, lo que nos pone en conformidad con las leyes aplicables.

Para obtener más información sobre nuestras políticas oficiales relacionadas con el juego, consulte nuestras políticas de juego del lado de compra y del lado de la venta.
Para obtener más información sobre cómo funciona la lista de permitidos por país y región, ponte en contacto con Asistencia al cliente.

Campo	Tipo	Descripción
`id`	Entero	El identificador de la categoría. Requerido en:`PUT`, en la cadena de consulta
`name`	string	Nombre de la categoría. Requerido en:`POST`
`is_sensitive`	booleano	Si `true`, la categoría aparece como "sensible" y, a menudo, es prohibida por los editores. Valor predeterminado:`false`
`last_modified`	marca de tiempo	La fecha y hora en que se modificó por última vez la categoría.
`requires_allowlist_on_external`	booleano	Si las marcas o los creativos de esta categoría requieren la inclusión en la lista de permitidos para servir en el inventario externo (es decir, RTB). Valor predeterminado:`false`
`requires_allowlist_on_managed`	booleano	Si las marcas o los creativos de esta categoría requieren la inclusión de permitidos para servir en el inventario administrado. Valor predeterminado:`false`
`is_brand_eligible`	booleano	Si `true`, la categoría es apta para asociarse con marcas dentro del proceso de auditoría. Valor predeterminado:`true`
`requires_allowlist`	booleano	Si las marcas o los recursos creativos de esta categoría requieren la inclusión en la lista de permitidos para poder publicar. Valor predeterminado:`false`
`countries_and_brands`	matriz de objetos	Esta matriz contiene la configuración de la lista de permitidos de marca agrupada por país o región. Para obtener más información, consulte "Países y marcas" a continuación.

Países y marcas

Campo	Tipo	Descripción
`brand_id`	Entero	El Id. de la marca.
`brand_name`	string	El nombre de la marca.
`brand`	multi_object	Un objeto que contiene información sobre la marca permitida en este país o región. Para obtener más información, consulte "Marca" a continuación.
`country`	string	Una cadena de 2 caracteres que hace referencia al país o región en la que la marca está en la lista de permitidos. Para obtener una lista de los códigos admitidos, consulte los códigos de país ISO 3166-1.

Regiones y marcas

Campo	Tipo	Descripción
`brand_id`	Entero	El Id. de la marca.
`brand_name`	string	El nombre de la marca.
`brand`	multi_object	Objeto que contiene información sobre la marca que se incluye en la lista de permitidos en esta región.
`region`	string	Cadena que hace referencia a la región en la que la marca está en la lista de permitidos. Para obtener una lista de los códigos admitidos, consulte la norma ISO 3166-2.

Ejemplos

Ver todas las categorías

$ curl -b cookies -c cookies "https://api.adnxs.com/category"
{
  "response": {
    "status": "OK",
    "count": 88,
    "start_element": null,
    "num_elements": null,
    "categories": [
      {
        "id": 1,
        "name": "Airlines",
        "is_sensitive": false,
        "last_modified": "2010-03-19 17:48:36",
        "requires_allowlist_on_external": false,
        "requires_allowlist_on_managed": false,
        "is_brand_eligible": true,
        "requires_allowlist": false,
        "allowlist": {
          "countries_and_brands": [],
          "regions_and_brands": []
        }
      },
      {
        "id": 2,
        "name": "Apparel",
        "is_sensitive": false,
        "last_modified": "2010-03-19 17:48:36",
        "requires_allowlist_on_external": false,
        "requires_allowlist_on_managed": false,
        "is_brand_eligible": true,
        "requires_allowlist": false,
        "allowlist": {
          "countries_and_brands": [],
          "regions_and_brands": []
        }
      },
      {
        "id": 3,
        "name": "Appliances",
        "is_sensitive": false,
        "last_modified": "2010-03-19 17:48:36",
        "requires_allowlist_on_external": false,
        "requires_allowlist_on_managed": false,
        "is_brand_eligible": true,
        "requires_allowlist": false,
        "allowlist": {
          "countries_and_brands": [],
          "regions_and_brands": []
        }
      },
      "dbg": {
      ...
    }
  }
}

Ver una categoría específica

$ curl -b cookies -c cookies "https://api.adnxs.com/category/1"
{
  "response": {
    "status": "OK",
    "count": 1,
    "start_element": null,
    "num_elements": null,
    "category": {
      "id": 1,
      "name": "Airlines",
      "is_sensitive": false,
      "last_modified": "2010-03-19 17:48:36",
      "requires_allowlist_on_external": false,
      "requires_allowlist_on_managed": false,
      "is_brand_eligible": true,
      "requires_allowlist": false,
      "allowlist": {
        "countries_and_brands": [],
        "regions_and_brands": []
      }
    },
    "dbg": {
      ...
    }
  }
}

Last updated on 2026-08-18