> For the complete documentation index, see [llms.txt](https://knowledgebase.offer18.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.offer18.com/es/red/api-de-red/api-de-creacion-de-oferta.md). # API de creación de oferta ``` POST https://api.offer18.com/api/m/offers ``` :link: [**Haga clic para probar la API de creación de oferta**](https://offer18.readme.io/reference/offers-api) ### Parámetros comunes | **Consulta** | **Tipo** | **Descripción** | | ------------ | -------- | ----------------------- | | mid | Entero | ID de cuenta de la red | | api-key | Cadena | Clave API de la red | | secret-key | Cadena | Clave secreta de la red | **Acción**


Consulta	Tipo	Descripción
action	Cadena	Valores permitidos: crear / actualizar / eliminar
offer_id	Entero	Requerido en la actualización y eliminación de la oferta

*** ### **Campos**


Cuerpo	Tipo	Descripción
offer_name	Cadena	Nombre de la campaña
advertiser_id	Entero	ID del anunciante
offer_url	URL	URL de la campaña
external_offer_id	Cadena	ID de la campaña externa (si la hay)
app_id	Cadena	ID de la aplicación (si la hay)
logo	URL	URL del logotipo de la campaña
category	Cadena	Categoría de la campaña
preview_url	URL	URL de vista previa de la campaña
currency	Cadena	Moneda de la oferta 🔗 Ver monedas
price_advertiser	Decimal	Precio dado por el anunciante para la campaña
price_affiliate	Decimal	Precio dado al afiliado para la campaña
model_advertiser	Cadena	Modelo de anunciante de la campaña 🔗 Ver modelos
model_affiliate	Cadena	Modelo de anunciante de la campaña 🔗 Ver modelos
hide_affiliate_payout	Entero	Valores permitidos 1: Para ocultar el pago al afiliado
start_datetime	Marca de tiempo UTC	Fecha / hora de inicio (YYYY-MM-DD HH:MM:SS)
end_datetime	Marca de tiempo UTC	Fecha / hora de fin (YYYY-MM-DD HH:MM:SS )
visibility	Cadena	Valores permitidos: público, permiso, privado
status	Cadena	Valores permitidos: aprobado, pendiente
deep_links	Entero	Valores permitidos 1: Para habilitar enlaces profundos en las ofertas
offer_terms	Cadena	Términos de la campaña
offer_kpi	Cadena	Términos KPI de la campaña
private_note	Cadena	Notas privadas en la campaña
imps_url	URL	URL de impresión
landing_page_id_1	Entero	En caso de que el usuario quiera actualizar la página de destino existente
landing_page_name_1	Cadena	Nombre de la primera página de destino
landing_page_url_1	URL	URL de la primera página de destino de la campaña
landing_page_id_2	Entero	En caso de que el usuario quiera actualizar la página de destino existente
landing_page_name_2	Cadena	Nombre de la segunda página de destino
landing_page_url_2	URL	URL de la segunda página de destino de la campaña
creatives	URL	URL de los creativos de la campaña
fallback	booleano	Valores permitidos: 1: Para habilitar el respaldo
fallback_offer_id	Entero	ID de la oferta de respaldo
fallback_url	URL	URL de respaldo
fraud_conv_speed	Entero	Tiempo en segundos
proxy_block	Entero	Valores permitidos: 1: Para bloquear proxies
blank_ref_block	Entero	Valores permitidos: 1: Para bloquear referencias en blanco
hide_referral	Entero	Valores permitidos: 1: Para ocultar la referencia
assign_affiliates	Entero	Asignar afiliados a esta campaña (valores separados por comas)
capping_rule_id	Entero	En caso de que el usuario quiera actualizar la regla de límite existente
capping[0][capping_rule_name]	Cadena	Nombre de la regla de límite
capping[0][capping_rule_type]	Cadena	Tipo de regla de límite 1. advertiser_capping 2. affiliate_capping
capping[0][capping_timezone]	Marca de tiempo	Zona horaria del límite
capping[0][capping_events]	Cadena	Eventos del límite
capping[0][capping_type]	Cadena	Tipo de límite 1. gross_conversions 2. approved_conversions 3. gross_revenue 4. approved_revenue 5. gross_payout 6. approved_payout 7. gross_clicks 8. approved_clicks
capping[0][capping_period]	Cadena	Periodo del límite 1. diario 2. semanal 3. mensual 4. por hora
capping[0][capping_value]	Entero	Valor del límite
capping[0][overcap_action]	Cadena	Acción al superar el límite 1. detener 2. fallback 3. fallback_conversion_accept 4. conversion_accept 5. conversion_reject 6. conversion_pending
capping[0][capping_notification_email]	Cadena	Correo electrónico de notificación del límite
capping[0][capping_affiliate_visibility]	Entero	1: Para mostrar la regla de límite al afiliado
capping[0][capping_affiliate_id]	Cadena	IDs de afiliado (separados por comas)
targeting_rule_id	Entero	En caso de que el usuario quiera actualizar la regla de segmentación existente
target_country	Cadena	Permitir país específico 🔗 Ver países
block_country	Cadena	Bloquear país específico 🔗 Ver países
target_os	Cadena	Permitir sistema operativo específico 🔗 Ver SO
block_os	Cadena	Bloquear sistema operativo específico 🔗 Ver SO
target_device	Cadena	Permitir dispositivos específicos 🔗 Ver dispositivos
block_device	Cadena	Bloquear dispositivos específicos 🔗 Ver dispositivos
target_browser	Cadena	Permitir navegador específico 🔗 Ver navegadores
block_browser	Cadena	Bloquear navegador específico 🔗 Ver navegadores
target_isp	Cadena	Permitir ISP específico
block_isp	Cadena	Bloquear ISP específico
events[0][event_name]	Cadena	Nombre del evento
events[0][event_token]	Cadena	Token del evento
capping_conversion_period	Cadena	En desuso
capping_budget	Entero	En desuso
capping_conversion	Entero	En desuso
capping_budget_period	Cadena	En desuso

**Reglas de límite (Instrucciones)** {% hint style="info" %} 1. Si desea establecer múltiples reglas de límite, puede hacerlo asignando las reglas a diferentes números\ **Ejemplo 1:** \ capping\[**1**]\[capping\_rule\_name] \ capping\[**1**]\[capping\_rule\_type]\ **Ejemplo 2:**\ capping\[**2**]\[capping\_rule\_name] \ capping\[**2**]\[capping\_rule\_type] 2. Si desea actualizar una regla de límite existente, debe enviar **capping\_rule\_id** en la solicitud de la API junto con los nuevos datos a **0**número (cero)\ **Ejemplo:**\ capping\[**0**]\[capping\_rule\_name] \ capping\[**0**]\[capping\_rule\_type] {% endhint %} **Eventos (Instrucciones)** {% hint style="info" %} 1. Si desea crear múltiples eventos, puede hacerlo asignando eventos a diferentes números\ **Ejemplo 1:** \ events\[1]\[event\_name] \ events\[1]\[event\_token]\ **Ejemplo 2:**\ events\[2]\[event\_name] \ events\[2]\[event\_token] {% endhint %} *** ### Ejemplo de solicitud de API **Creación de oferta**

**Respuesta de la API** ``` { "status": "200", "response": "offer_created_successfully", "offer_id": 000012 } ``` **Actualización de oferta**

**Respuesta de la API** ``` { "status": "200", "response": "offer_updated_successfully", "offer_id": "000001" } ``` *** {% hint style="info" %} **Para interacciones seguras, llame siempre a la API desde el lado del servidor.** {% endhint %}