# API de ofertas

```
GET https://api.offer18.com/api/af/offers
```

:link: [<mark style="color:azul;">**Haga clic para probar la API de ofertas**</mark>](https://offer18.readme.io/reference/offers-api-1)

### **Parámetros comunes**

<table data-header-hidden><thead><tr><th width="150">Ruta</th><th width="150"> </th><th> </th></tr></thead><tbody><tr><td><strong>Parámetro</strong></td><td><strong>Tipo</strong></td><td><strong>Descripción</strong></td></tr><tr><td>key</td><td>Cadena</td><td>Clave API</td></tr><tr><td>aid</td><td>Entero</td><td>Id de Afiliado</td></tr><tr><td>mid</td><td>Entero</td><td>Su MID de anunciante</td></tr></tbody></table>

***

### Filtros

<table data-header-hidden><thead><tr><th width="150">Consulta</th><th width="150"> </th><th width="376.2"> </th></tr></thead><tbody><tr><td><strong>Consulta</strong></td><td><strong>Tipo</strong></td><td><strong>Descripción</strong></td></tr><tr><td>offer_id</td><td>Entero</td><td>ID de oferta (&#x26;offer_id=000,001,002)</td></tr><tr><td>page</td><td>Entero</td><td>Número de página (&#x26;page=1)</td></tr><tr><td>category</td><td>Cadena</td><td>Categoría de la oferta (&#x26;category=000,000,000)</td></tr><tr><td>modelo</td><td>Cadena</td><td><p>Modelo de oferta (&#x26;model=CPA,CPC) </p><p><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="../../../universal/valores-comunes#models"><mark style="color:azul;">Ver modelos</mark></a></p></td></tr><tr><td>country</td><td>Cadena</td><td><p>Ofertas por país (&#x26;country=US, IN, AU) </p><p><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="../../../universal/valores-comunes#countries"><mark style="color:azul;">Ver países</mark></a></p></td></tr><tr><td><strong>offer_status</strong></td><td>Entero</td><td>Valores permitidos:<br><strong>1:</strong> Ofertas activas (&#x26;offer_status=1)</td></tr><tr><td><strong>autorizado</strong></td><td>Entero</td><td>Valores permitidos:<br><strong>1:</strong> Ofertas asignadas (&#x26;authorized=1)</td></tr></tbody></table>

{% code overflow="wrap" %}

```
https://api.offer18.com/api/af/offers?key=000000000&aid=0000&mid=0000&offer_id=0000000&model=000
```

{% endcode %}

***

### Ejemplo de solicitud API

![](https://497363578-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2F9zE27hsuq4SCIethKMln%2Fimage.png?alt=media\&token=919949d7-c9c1-410b-a1db-744af85ac084)

***

### **Respuesta de la API**

```json
{
  "response": "200",
  "data": {
    "00011": {
      "offerid": "00011",
      "name": "XXXXX",
      "logo": "https://example.com/sample.jpeg/",
      "status": "active",
      "category": "download campaigns, gaming, subscription offers, Ecommerece Campaign",
      "currency": "USD",
      "price": 100,
      "model": "CPA",
      "date_start": "2019-05-09 02:19:00",
      "date_end": "2021-08-31 02:19:00",
      "preview_url": "https://www.example.com/?offerid=00011",
      "offer_terms": "These are the offer terms",
      "offer_kpi": "",
      "country_allow": "IN,US",
      "country_block": "GB",
      "city_allow": "",
      "city_block": "",
      "os_allow": "",
      "os_block": "",
      "device_allow": "",
      "device_block": "",
      "isp_allow": "",
      "isp_block": "",
      "browser_allow": "",
      "browser_block": "",
      "capping": [
        {
          "rule_type": "shared_capping",
          "event": "",
          "type": "gross_conversions",
          "period": "daily",
          "value": 100,
          "timezone": null,
          "rule_id": "00000"
        },
        {
          "rule_type": "affiliate_capping",
          "event": "",
          "type": "approved_conversions",
          "period": "daily",
          "value": 100,
          "timezone": null,
          "rule_id": "00000"
        }
      ],
      "events": [
        {
          "event_name": "registration",
          "event_token": "registration"
        }
      ],
      "payout": [
        {
          "payout": "515.0000",
          "currency": "USD",
          "model": "CPA",
          "condition": [
            [
              {
                "field": "event",
                "operator_type": "is_equal",
                "value": "reagistration"
              },
              {
                "field": "country",
                "operator_type": "is_equal",
                "value": "US"
              },
              {
                "field": "device_type",
                "operator_type": "is_equal",
                "value": "smartphone"
              },
              {
                "field": "browser",
                "operator_type": "is_equal",
                "value": "ch"
              },
              {
                "field": "os",
                "operator_type": "is_equal",
                "value": "android"
              }
            ]
          ],
          "rule_id": "00000"
        }
      ],
      "suppression_list": [
        {
          "name": "Sample Suppression list",
          "file_url": "https:\/\/storage.googleapis.com\/offer18-user-data\/suppression\/0000\/3dd0e00000f9202c8602b84feaf7_file.zip?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=service-account%40offer18.iam.gserviceaccount.com%2F20250324%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20250324T122057Z&X-Goog-Expires=172800&X-Goog-SignedHeaders=host&X-Goog-Signature=5ce353be3a209f62098d934b32b40d3af66b52a203ca821158c642a7c80c939af5bbad6435c2ce441b24e52df7f7bed4d4c54af8c4a8b54510c1dd7a55922ea49e52e1d1d4b6060000000653252a5d09c272f4748acf990c6eee95e166a87515fe984224fd587cf2c33d",
          "unsubscribe_url": "https:\/\/example.com",
          "subject_lines": "sample subject lines",
          "from_lines": "sample from lines"
        }
      ],
      "impression_url": "https://mynet.o18.click/i?o=00011&m=000&a=00000",
      "click_url": "https://mynet.o18.click/c?o=00011&m=000&a=00000",
      "authorized": "true",
      "creatives": [
        {
          "type": "image",
          "url": "https://example.com/creative_00001.png"
        },
        {
          "type": "image",
          "url": "https://example.com/creative_00002.png"
        },
        {
          "type": "html",
          "url": "https:example.com/creative00002.zip"
        }
      ],
      "targeting": [
        {
          "action_on_clicks": "allow",
          "condition": [
            [
              {
                "field": "country",
                "operator_type": "is_equal",
                "value": "IN,US"
              },
              {
                "field": "device_type",
                "operator_type": "not_equal",
                "value": "smartphone"
              }
            ]
          ],
          "rule_id": "101"
        },
        {
          "action_on_clicks": "reject",
          "condition": [
            [
              {
                "field": "os",
                "operator_type": "not_equal",
                "value": "android"
              }
            ]
          ],
          "rule_id": "102"
        },
        {
          "action_on_impressions": "allow",
          "condition": [
            [
              {
                "field": "country",
                "operator_type": "is_equal",
                "value": "IN,US"
              },
              {
                "field": "os",
                "operator_type": "is_equal",
                "value": "windows"
              }
            ]
          ],
          "rule_id": "103"
        }
      ]
    }
  }
}
```

{% hint style="info" %}

1. **Capping compartido -** Una única regla de capping compartida por múltiples afiliados.
2. La URL del archivo de supresión será válida solo por 2 horas. Recomendamos descargar y usar el archivo de inmediato para asegurar acceso y funcionalidad sin interrupciones.
   {% endhint %}

#### Solicitar oferta

<table data-header-hidden><thead><tr><th width="163.8046846634862">Consulta</th><th width="150"> </th><th width="407.6775081031496"> </th></tr></thead><tbody><tr><td><strong>Consulta</strong></td><td><strong>Tipo</strong></td><td><strong>Descripción</strong></td></tr><tr><td>offer_access</td><td>Entero</td><td>Valores permitidos<br><strong>1:</strong> Aprobar ofertas públicas (&#x26;offer_access=1)</td></tr></tbody></table>

{% code overflow="wrap" %}

```
https://api.offer18.com/api/af/offers?key=000000000&aid=0000&mid=0000&offer_access=1
```

{% endcode %}


---

# Agent Instructions: 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:

```
GET https://knowledgebase.offer18.com/es/afiliado/api-de-afiliados/api-de-ofertas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.