> For the complete documentation index, see [llms.txt](https://targetmycom.gitbook.io/openrtb_spec/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://targetmycom.gitbook.io/openrtb_spec/openrtb/vk-ad-network-rtb-protocols/s2s-api.md).

# S2S API

VK Ad Network provides comprehensive integration methods that allow publishers to integrate easily with our Ad Server using any server side integration. API integration is the most flexible method of integration if you are unable to integrate with the myTarget SDK. Publisher can efficiently manage multiple platforms through one API. Use our API to integrate Android and iOS apps. 

* Supports newer and better performing ad formats – native (+video via VAST), banner, interstitial, ensuring better monetization for publisher site/app. 
* The ad request is in JSON format and is similar to the OpenRTB specification (version 2.3 or 2.5). 
* Allows several first-party data parameters to be collected, improving the ad served relevance and monetization.

**Main differences with IAB OpenRTB specification:**

* Bid price in BidResponse can not be used for billing (for informational purposes only)
* Suppoted loss notice notification with macros ${AUCTION\_LOSS}

**Endpoint URL**

```
https://ad.mail.ru/api/:SLOTID/?GET(parameters)
```

GET parameters in request

| **name** | **type**              | **description**                                                                                                                                  |
| -------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| SLOTID   | integer; **required** | SLOTID for placement in VK Ad Network UI with integration type ‘s2s/api’                                                                         |
| debug    | integer               | debug request for issue tracking!debug url will be provided in ext.bannerd.debug\_info in response and should be send to VK Ad Network tech team |

See additional requirements for BidRequest and BidResponse

{% content-ref url="/pages/YpAZxNt5CEp3mawemNOX" %}
[BidRequest specification requirements](/openrtb_spec/openrtb/vk-ad-network-rtb-protocols/bidrequest-specification-requirements.md)
{% endcontent-ref %}

{% content-ref url="/pages/ZEhqHbUwFNuabiPizHF7" %}
[BidResponse specification requirements](/openrtb_spec/openrtb/vk-ad-network-rtb-protocols/bidresponse-specification-requirements.md)
{% endcontent-ref %}

### Example BidRequest/BidResponse

{% content-ref url="/pages/b68O5h3aEWwjWTXAxFEL" %}
[OpenRTB v 2.3/2.5](/openrtb_spec/openrtb/vk-ad-network-rtb-protocols/example-bidrequest-and-bidresponse/openrtb-v-2.3-2.5.md)
{% endcontent-ref %}