[
  {
    "id": "123",
    "imageUrl": "https://cdn.foodsave.kz/ads/abc.jpg",
    "link": "/partner/42",
    "placement": "home",
    "startsAt": "2026-05-01T00:00:00Z",
    "endsAt": "2026-06-01T00:00:00Z"
  }
]

Ads API

Base path: /api/v1/ads

Overview

Read endpoints are public; admin endpoints require a bearer token with advertising permissions.

Responses are cached for 5 seconds for performance. Use the If-Modified-Since header for conditional fetching.

GET `/api/v1/ads/banners`

Return active banners filtered by placement, locale and city.

cURL
JavaScript
Python

curl --request GET \
  --url "https://api.foodsave.kz/api/v1/ads/banners?placement=home&locale=ru-KZ" \
  -H "Authorization: Bearer $FOODSAVE_API_KEY" \
  -H 'Accept: application/json'

const response = await fetch('https://api.foodsave.kz/api/v1/ads/banners?placement=home&locale=ru-KZ', {
  headers: { Authorization: `Bearer ${process.env.FOODSAVE_API_KEY}` }
})

console.log(await response.json())

import os
import requests

response = requests.get(
    'https://api.foodsave.kz/api/v1/ads/banners?placement=home&locale=ru-KZ',
    headers={'Authorization': f"Bearer {os.environ['FOODSAVE_API_KEY']}"}
)

print(response.json())

[
  {
    "id": "123",
    "imageUrl": "https://cdn.foodsave.kz/ads/abc.jpg",
    "link": "/partner/42",
    "placement": "home",
    "startsAt": "2026-05-01T00:00:00Z",
    "endsAt": "2026-06-01T00:00:00Z"
  }
]

string

imageUrl

string

link

string

placement

string

Errors

Code	Meaning	How to fix
400	BAD_REQUEST	Check query parameters
401	UNAUTHORIZED	Provide a valid API key
429	RATE_LIMIT	Back off or request quota increase

Loyalty API Create Campaign

⌘I

Getting Started

API Reference

Guides

Reference

Get Banners

Ads API

Overview

GET `/api/v1/ads/banners`

Errors

Getting Started

API Reference

Guides

Reference

Documentation Index

​Ads API

​Overview

​GET /api/v1/ads/banners

​Errors

Ads API

Overview

GET `/api/v1/ads/banners`

Errors