---
title: "POST /api/feed/v1/events/shopping"
method: POST
path: "/api/feed/v1/events/shopping"
tags: ["Feed"]
---

# POST /api/feed/v1/events/shopping

`POST /api/feed/v1/events/shopping`

## Request

- Base URL: `https://api.findticker.com`
- URL: `https://api.findticker.com/api/feed/v1/events/shopping`
- Auth: HTTP bearer

## Request body

- FeedShoppingBatchRequest
  - `event_ids` string[], required
  - `range` '7d' | '14d' | '28d' | '90d'
  - `include_series` boolean
  - `columns` string[]: Metric names to return, comma-separated. Omit for both. Valid: interest, sales.

## Response `200`

One entry per known event id, in the order asked for. Unknown ids come back under meta.missing. Values are as of computed_at and refresh with each rollup job.

- FeedShoppingBatch
  - `data` FeedEventShopping[], required
    - `event_id` string, nullable, required
    - `current` FeedShoppingCurrent, required
      - `interest` integer, nullable
      - `sales` integer, nullable
    - `series` FeedShoppingPoint[], required
      - `snapshot_date` string, required
      - `interest` integer, nullable
      - `sales` integer, nullable
    - `meta` FeedShoppingMeta, required
      - `range` '7d' | '14d' | '28d' | '90d', required
      - `coverage_start` string, nullable, required
      - `points` integer, required
      - `columns` string[], required
  - `meta` object, required
    - `requested` integer, required
    - `returned` integer, required
    - `missing` string[], required
    - `batch_max` integer, required

## Other responses

- `400`: Validation error, an unknown `columns` name (the message lists the valid set), or a batch over the size bound.
- `401`: Missing or invalid API key.
- `403`: The key's account is not entitled to the feed, or the account or the address it calls from is blocked (`reason` `blocked`).
- `429`: The per-minute burst ceiling or the unit budget for the current UTC date is used up.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/findticker/apis/ticker-api.md) · [All operations](https://skmtc.dev/findticker/apis/ticker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/findticker/apis/ticker-api/revisions/b6229ca924f4?raw)