---
title: "Read marketplace ads reporting"
method: GET
path: "/v1/admin/ads/reports"
tags: ["Operations"]
---

# Read marketplace ads reporting

`GET /v1/admin/ads/reports`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/admin/ads/reports`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-LOPPEE-API-Key`

Read marketplace ads reporting. The response is scoped and validated by the runtime repository; unknown or unauthorized resources use the canonical error envelope.

## Query parameters

- `range` string

## Response `200`

Read marketplace ads reporting response

- object: Aggregates only: times shown, valid ad taps, tap rate, revenue (charges minus invalid-tap credits), fill rate (filled Sponsored slots over 2 per search with a slot, from the anonymous demand log) and invalid-tap rate, in total, by category, by advertiser state and per day; truncated when a window holds more records than one bounded read. Requires manage_billing.

## Other responses

- `401`: ErrorResponse
- `403`: ErrorResponse
- `404`: ErrorResponse
- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)