> 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/ru/partnyor/api-partnyorov/api-offerov.md).

# API офферов

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

:link: [<mark style="color:синий;">**Нажмите, чтобы протестировать API офферов**</mark>](https://offer18.readme.io/reference/offers-api-1)

### **Общие параметры**

<table data-header-hidden><thead><tr><th width="150">Путь</th><th width="150"> </th><th> </th></tr></thead><tbody><tr><td><strong>Параметр</strong></td><td><strong>Тип</strong></td><td><strong>Описание</strong></td></tr><tr><td>key</td><td>Строка</td><td>API-ключ</td></tr><tr><td>aid</td><td>Целое число</td><td>ID аффилиата</td></tr><tr><td>mid</td><td>Целое число</td><td>Ваш MID рекламодателя</td></tr></tbody></table>

***

### Фильтры

<table data-header-hidden><thead><tr><th width="150">Параметры запроса</th><th width="150"> </th><th width="376.2"> </th></tr></thead><tbody><tr><td><strong>Параметры запроса</strong></td><td><strong>Тип</strong></td><td><strong>Описание</strong></td></tr><tr><td>offer_id</td><td>Целое число</td><td>ID оффера (&#x26;offer_id=000,001,002)</td></tr><tr><td>page</td><td>Целое число</td><td>Номер страницы (&#x26;page=1)</td></tr><tr><td>category</td><td>Строка</td><td>Категория оффера (&#x26;category=000,000,000)</td></tr><tr><td>model</td><td>Строка</td><td><p>Модель оффера (&#x26;model=CPA,CPC) </p><p><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="/pages/c5cd60bf393cfe040df1d311d8c64cb375cfe4b3#models"><mark style="color:синий;">Просмотреть модели</mark></a></p></td></tr><tr><td>country</td><td>Строка</td><td><p>Офферы по странам (&#x26;country=US, IN, AU) </p><p><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> <a href="/pages/c5cd60bf393cfe040df1d311d8c64cb375cfe4b3#countries"><mark style="color:синий;">Просмотреть страны</mark></a></p></td></tr><tr><td><strong>offer_status</strong></td><td>Целое число</td><td>Допустимые значения:<br><strong>1:</strong> Активные офферы (&#x26;offer_status=1)</td></tr><tr><td><strong>authorized</strong></td><td>Целое число</td><td>Допустимые значения:<br><strong>1:</strong> Назначенные офферы (&#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 %}

***

### Пример запроса API

![](/files/767de15a965e877d14ea94060e2922d0b18f352f)

***

### **Ответ API**

```json
{
  "response": "200",
  "data": {
    "00011": {
      "offerid": "00011",
      "name": "XXXXX",
      "logo": "https://example.com/sample.jpeg/",
      "status": "активный",
      "category": "кампании загрузки, игры, предложения по подписке, кампания электронной коммерции",
      "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": "Это условия оффера",
      "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": "Пример списка подавления",
          "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": "примерные строки темы",
          "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",
      "landing_page_urls": {
                "random": "https://mynet.o18.click/c?o=00011&m=000&a=00000&mo=r",
                "LP1": "https://mynet.o18.click/c?o=00011&m=000&a=00000&mo=LP1",
                "LP2": "https://mynet.o18.click/c?o=00011&m=000&a=00000&mo=LP2"
            },
      "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. **Общий каппинг -** Одно правило каппинга, общее для нескольких партнёров.
2. URL файла подавления будет действителен только 2 часа. Мы рекомендуем как можно скорее скачать и использовать файл, чтобы обеспечить непрерывный доступ и корректную работу.
   {% endhint %}

#### Применить оффер

<table data-header-hidden><thead><tr><th width="163.8046846634862">Параметры запроса</th><th width="150"> </th><th width="407.6775081031496"> </th></tr></thead><tbody><tr><td><strong>Параметры запроса</strong></td><td><strong>Тип</strong></td><td><strong>Описание</strong></td></tr><tr><td>offer_access</td><td>Целое число</td><td>Допустимые значения<br><strong>1:</strong> Одобрять публичные офферы (&#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 %}