Публикации

Поиск публикаций · 3 кредита

💳 Стоимость: 3 кредита

Возвращает пагинированный список публикаций из публичного индекса. Поддерживается полнотекстовый поиск по полю text, фильтрация по каналу, типу публикации, признаку удаления и диапазону дат, а также сортировка по релевантности, дате, просмотрам или лайкам.

get/v1/posts

Request

  • Base URL: https://maxstat.ru/api
  • URL: https://maxstat.ru/api/v1/posts
  • Auth: API key in header X-API-Token

Query parameters

searchstring nullable

Полнотекстовый поисковый запрос по тексту публикации.

Example:запуск продукта
limitinteger

Количество публикаций в ответе. Допустимый диапазон: от 1 до 100.

Example:10
offsetinteger

Смещение относительно начала выборки для постраничной навигации. Сумма offset + limit не может превышать 10000: глубже поиск не отдаётся.

channel_idstring nullable

Фильтр по числовому идентификатору канала, передаётся строкой.

Example:-91827364546372
post_type'text' | 'file' | 'photo' | 'video' | 'audio' | 'share' | 'sticker' | 'contact' | 'location' | 'inline_keyboard' nullable

Фильтр по типу публикации.

Example:video
is_deletedboolean nullable

Фильтр по признаку удаления: true — только удалённые публикации, false — только доступные. Без параметра возвращаются и те и другие.

date_fromstring date nullable

Нижняя граница даты публикации включительно в формате YYYY-MM-DD.

Example:2026-03-01
date_tostring date nullable

Верхняя граница даты публикации включительно в формате YYYY-MM-DD.

Example:2026-03-31
order_by'likes' | 'views' | 'date' | 'score'

Поле сортировки: score для релевантности, date для даты публикации, views для просмотров, likes для лайков.

Example:score
order'asc' | 'desc'

Направление сортировки.

Example:desc

Response

Successful Response

totalinteger required

Общее количество публикаций, найденных по заданным фильтрам.

limitinteger required

Примененный размер страницы.

offsetinteger required

Примененное смещение.

Example response

{
  "total": 248,
  "posts": [
    {
      "id": "192837465192837465",
      "channel_id": "-91827364546372",
      "type": "text",
      "url": "https://max.ru/channel/example/post/123456",
      "text": "Запуск нового продукта состоится уже в апреле.",
      "views": 15420,
      "likes": 842,
      "likes_detailed": {
        "❤️": 14,
        "👍": 800,
        "🔥": 28
      },
      "attachments": [
        {
          "attachment_type": "image",
          "attachment_url": "https://cdn.example.com/posts/123/image.jpg"
        }
      ],
      "forwarded_from_id": "192837465192837465",
      "forward_type": "reply",
      "published_at": "2026-03-20T14:30:00+07:00",
      "updated_at": "2026-03-21T09:15:00+07:00",
      "deleted_at": "2026-03-22T18:05:00+07:00",
      "score": 12.48
    }
  ],
  "limit": 10
}

Changes

No recorded changes to this operation across all 1 revision of this API.