> For the complete documentation index, see [llms.txt](https://docs.targetpick.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.targetpick.io/targetpick_eng/for-dsp/report-api/banner.md).

# Banner

{% hint style="info" %}
SSP :arrow\_right: DSP
{% endhint %}

CJ MezzoMedia SSP calls the Report API to the DSP as follows.\
The response delivered to the SSP must be in JSON array format and is case-sensitive. If there are any special considerations or additional requirements when calling the DSP API, please share them during the integration discussion.

## 1. API Endpoint <a href="#api-endpoint" id="api-endpoint"></a>

<table><thead><tr><th width="374">request Url</th><th>Description</th></tr></thead><tbody><tr><td>http://{DSP domain}</td><td>DSP media API endpoint that can be called by your system</td></tr></tbody></table>

### API Request Parameters <a href="#api-request-parameters" id="api-request-parameters"></a>

| Parameter | Scope    | Description                                 | Sample     |
| --------- | -------- | ------------------------------------------- | ---------- |
| key       | optional | Used if DSP needs to define a value per SSP | 44800908   |
| sdate     | required | Start date for daily query (yyyy-mm-dd)     | 2019-01-01 |
| edate     | required | End date for daily query (yyyy-mm-dd)       | 2019-01-01 |

### **Report API Sample**

<table><thead><tr><th width="570">Sample url</th><th>Description</th></tr></thead><tbody><tr><td>{DSP URL}?key={keyvalue}&#x26;sdate=2018-09-30&#x26;edate=2018-10-03</td><td>When key is included</td></tr><tr><td>{DSP URL}?sdate=2018-09-30&#x26;edate=2018-10-03</td><td>When key is not included</td></tr></tbody></table>

##

## **2. API Response**

| Parameter | Description                                 |
| --------- | ------------------------------------------- |
| date      | Date (e.g., 2018-10-02)                     |
| pubid     | Target site ID or app ID                    |
| request   | Request count                               |
| imps      | Impression count                            |
| click     | Click count                                 |
| revenue   | Media revenue (VAT excluded)                |
| …         | Please share if there are additional fields |

### Example

{% tabs %}
{% tab title="Response" %}
{% code lineNumbers="true" %}

```json
{
    "data": [
        {
            "pubid": "0338E1B551069026A4EA5B805413E2FD",
            "date": "20181121",
            "request": 1588,
            "imps": 1588,
            "click": 1,
            "revenue": 70
        },
        {
            "pubid": "0338E1B551069026A4EA5B805413E555",
            "date": "20181121",
            "request": 33,
            "imps": 33,
            "click": 1,
            "revenue": 70
        },
        {
            "pubid": "0338E1B551069026A4EA5B805413E666",
            "date": "20181121",
            "request": 44,
            "imps": 55,
            "click": 1,
            "revenue": 70
        },
        ...
    ]
}
```

{% endcode %}
{% endtab %}
{% endtabs %}