> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/api/es/api-publica-de-exoclick/api-para-desarrolladores.md).

# API para desarrolladores

Con la API de la plataforma es posible automatizar todas las funciones que se encuentran en el Panel de Administración.

<details>

<summary>1. ¿Qué pueden automatizar los anunciantes?</summary>

* Campañas/grupos, variaciones, ofertas y formatos de anuncios
* Segmentación/bloqueo de opciones de segmentación, categorías
* Objetivos
* Obtener estadísticas, incluidos los datos de usuarios de adblock
* Presupuesto diario, financiación de la cuenta, tipos de pago
* Nombre de la página de destino, URL y algoritmo de reparto de tráfico

</details>

<details>

<summary>2. ¿Qué pueden automatizar los editores?</summary>

* Formatos de anuncios y zonas de anuncios
* Sitios, verificaciones de URL
* Bloquear tipos de anuncios y categorías de productos
* Obtener todas las estadísticas, incluidos los datos de usuarios de adblock
* Precios de puja por formato de anuncio/GEO, modelos de precios
* Tipos de pago

</details>

<details>

<summary>3. Cómo usar la API</summary>

* La interfaz de la API es rápida y fácil de usar
* Simplemente selecciona un parámetro y pulsa el botón **Probarlo** para generar código automáticamente

</details>

<details>

<summary>4. Descargar documentación técnica</summary>

* [Cliente PHP](https://github.com/exads/exads-api-client-php)

</details>

## Cómo usar la API de la plataforma

Acabamos de actualizar nuestra API de la plataforma a la versión 2. Esta última versión te permite automatizar absolutamente todas las funciones dentro del Panel de Administración. Puedes usar la API para procesos sencillos, como automatizar tareas repetitivas para ahorrar tiempo, hasta proyectos más complejos, como cambiar creatividades de banners sobre la marcha.

### Funciones

Tanto editores como anunciantes tienen a su disposición una amplia variedad de funciones. Aquí tienes un resumen de lo que se puede automatizar:

#### Anunciantes

* Campañas individuales/grupales, variaciones, ofertas, formatos de anuncios.
* Segmentación/bloqueo de opciones de segmentación, categorías, franjas horarias.
* Objetivos.
* Obtener estadísticas, incluidos los datos de usuarios de adblock.
* Presupuesto diario, financiación de la cuenta, tipos de pago.
* Nombre de la página de destino, URL y algoritmo de reparto de tráfico.

#### Editores

* Formatos de anuncios y zonas de anuncios.
* Sitios, verificaciones de URL.
* Bloquear tipos de anuncios y categorías de productos.
* Obtener todas las estadísticas, incluidos los datos de usuarios de adblock.
* Precios de puja por formato de anuncio/GEO, modelos de precios.
* Tipos de pago.

**Antes de empezar**

La interfaz de la API muestra una lista de títulos de grupos. Haz clic en un grupo y se desplegarán todas las opciones disponibles.

![lista de API](/files/56d0ebd64ba06451ee47a23067d02a931aab3e81)

### Verbos HTTP

La API admite el siguiente subconjunto de verbos HTTP. Ten en cuenta que no todas las funciones admitirán todos los verbos.

![Usos de la API](/files/a42c540e31eefa21eb2dc2e271f95b9074189930)

¡Empecemos!

### Configuración

Para acceder a las solicitudes restringidas de la API, debe haber un token de sesión configurado. Para establecer un token, debes tener una cuenta válida.

La creación del token de API está disponible en tu **Mi perfil** menú. Selecciona Tokens de API.

![mi perfil](/files/99ee84b2972f09809dd3fe0bc897cbdb6c094ce2)

Haz clic en **Nuevo token de API**.

![tokens de api](/files/6402a417d557b25e96287b7f9da9b1d5be7b2ded)

Escribe el nombre del token; para este tutorial hemos llamado al nuestro «testToken» y luego haz clic en **Guardar**.

Se ha creado el ID del token.

![id del token](/files/ea46e3a7e520073befd2b825087c77e7d90eab20)

### Iniciar sesión en la API

En la interfaz de la API, haz clic en el botón **Iniciar sesión** en la parte superior derecha de la pantalla e introduce tu nombre de usuario y contraseña o proporciona un token de API. Haz clic en **Enviar** y se enviará una solicitud de inicio de sesión a la API para recuperar un token de sesión válido. Este token se utilizará luego para validar todas las solicitudes de API que desees realizar durante la sesión.

![inicio de sesión en api](/files/75810d9f95218f76f9f8a8eeb7a3023e3db9452d)

![inicio de sesión en api](/files/224ed61158ce20e390064714904ee5095c00e2f9)

### Cómo hacer una solicitud a la API

Tomemos el ejemplo del grupo Campaigns; haz clic en él y el grupo se desplegará para mostrar las solicitudes disponibles:

Haz clic en la solicitud que quieras automatizar; en este ejemplo solicitaremos datos para el CID 1923724 usando:

![obtener campaña](/files/2f4448d20b17cb32bbb4f5f1543402e5c3616986)

Haz clic en **Obtener campaña** lo que despliega la ventana. Introduce el número de ID de la campaña en el campo:

![id de campaña](/files/d20c55333dbfd0dae6392c14a7ef7e5622c6cea5)

Luego haz clic en el botón **Pruébalo ahora** El cuerpo de la respuesta generará el código automáticamente.

![cuerpo de la respuesta](/files/ad01e5d26dfa12bb8131a280dab0a8f63ba6e530)

Un código de respuesta de 200 significa que está bien usarlo.

### Cómo pausar una campaña

Aquí tienes otro ejemplo. Primero selecciona la función correcta del grupo Campaigns:

![pausar campaña](/files/69277cea99cd36e580770188acc082b06fdac798)

Haz clic en **Pausar** para una o más campañas. Una vez abierto, haz clic en el Valor de ejemplo y luego en el recuadro amarillo; esto pegará automáticamente la estructura json en el cuadro del cuerpo.

![pausar](/files/0cbdc029bf272bfd259cdb886c6bdadab57fb32e)

Ahora el valor actual es cero, así que cambia el cero por el CID que quieras poner en pausa. Luego haz clic en el botón **Probarlo** para generar el código necesario.

![id de campaña](/files/53cd3b8a88f127ef105b78dc3c13acbf5c3efd7e)

### Cómo actualizar los precios de una campaña

Selecciona la función correcta:

![id de campaña](/files/29e54960a7221f6018dac41a389f1febaa5bfbc9)

Haz clic en **Actualizar una campaña**, para abrir la ventana. Añade el CID en el campo de id de campaña y luego haz clic en Valor de ejemplo; haz clic en el recuadro amarillo, que copiará la estructura json en el cuadro del cuerpo.

Este código contiene algunas funciones diferentes, pero queremos el código de precios de la campaña, así que borra la parte del código que no se necesita dejando el código de precios de la campaña en el cuadro, como se muestra abajo:

![id de campaña](/files/46965a9c45c36fdb1c9507dbb261136835dd03ef)

Ahora necesitamos cambiar dos cosas en el cuadro del cuerpo: el modelo (abajo hay una lista de los valores relacionados con el modelo de precios).

```
CampaignPricing {
model (integer, optional): Modelo de precios de la campaña (1: CPC, 2: CPM, 3: CPA, 4: Smart CPM, 5: CPV) = [‘1’, ‘2’, ‘3’, ‘4’, ‘5’],
price (number, optional): Precio de la campaña
}
```

Vamos a quedarnos con CPC, así que dejaremos el modelo en 1

Ahora necesitamos cambiar el precio de cero al precio que queremos. Vamos a cambiarlo a 200, lo que significa que el nuevo precio será de 200 céntimos o dos euros.

![id de campaña](/files/029dc7460bb7ea7670fef9ebf4419a23f5054e5d)

Luego simplemente haz clic en el botón **Probarlo** para generar el código. ¡Fácil!

Como puedes ver, la API está repleta de funciones para automatizar; el único límite es tu imaginación para desbloquear el poder de la automatización.

Por último, asegúrate de suscribirte a nuestro boletín de la API, que encontrarás en la parte inferior de la interfaz de la API, para que puedas recibir las últimas noticias y actualizaciones.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/api/es/api-publica-de-exoclick/api-para-desarrolladores.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
