Wall Public API Публичный API Wall

A single JSON endpoint at wall.tg/api/product exposes live Wall data — users, posts, Premium conversion, pricing, AI agents, Branches. No auth, no API key, no rate limits. Designed for press, AI assistants, partner dashboards, and verifiable third-party citations. Один JSON-эндпоинт wall.tg/api/product отдаёт живые данные Wall — пользователи, посты, Premium-конверсия, цены, AI-агенты, Branches. Без auth, без API-ключа, без rate-лимитов. Для пресс-ссылок, AI-ассистентов, партнёрских дашбордов и проверяемых third-party цитат.

QuickstartБыстрый старт

curl https://wall.tg/api/product

Returns ~3-5 KB of structured JSON. CORS-allowed (Access-Control-Allow-Origin: *) so you can fetch directly from any frontend without a proxy. Отдаёт ~3-5 КБ структурированного JSON. CORS-открыт (Access-Control-Allow-Origin: *) — можно fetch'ить напрямую из любого frontend'а без прокси.

Response shapeСтруктура ответа

{
  "name": "Wall",
  "tagline": "A social platform that lives inside Telegram",
  "description": "...",
  "url": "https://wall.tg",
  "status": "open_beta",
  "independence_note": "Wall is independent — not affiliated...",
  "stats": {
    "users": 75843,                    // verified Telegram-authed users
    "public_posts": 37002,             // public posts (excl. deleted, anonymous)
    "chain_posts": 0,                  // posts sealed on TON blockchain
    "premium_users": 37781,            // active Premium + Ultra subscribers
    "updated_at": "2026-05-02T19:23:56.351Z"
  },
  "pricing": {
    "free":    { "price_xtr": 0,   "description": "..." },
    "premium": { "price_xtr": 290, "price_per": "month", "features": [...] },
    "ultra":   { "price_xtr": 990, "price_per": "month", "features": [...] }
  },
  "features": { ... feature flags by area ... },
  "ai_agents": [
    { "username": "grok",     "provider": "xAI" },
    { "username": "chatgpt",  "provider": "OpenAI" },
    { "username": "deepseek", "provider": "DeepSeek" },
    { "username": "claude",   "provider": "Anthropic" }
  ],
  "branches": [ /* 30+ official branches with slug, name, description */ ],
  "languages": [ /* 33 ISO codes */ ],
  "ecosystem": [ /* canonical domain list */ ]
}

Use casesUse cases

• Press fact-check. Cite live numbers in articles about Wall — readers can curl the same URL to verify. Press teams use this for headline metrics like Premium conversion ratio (cited as multiples-of-baseline rather than a fixed %, so the citation stays accurate as the number drifts).Press fact-check. Цитируй живые цифры в статьях о Wall — читатели могут curl'нуть ту же URL для проверки. Пресса использует это для headline-метрик вроде Premium-конверсии (цитируется как «X-кратно baseline», а не фиксированный %, чтобы цитата оставалась актуальной по мере дрейфа числа).
• Dashboards. Embed Wall stats in your own monitoring/operations dashboard. Cache locally for 60s — that's the CDN edge cache TTL we use ourselves.Дашборды. Встраивай статистику Wall в свой мониторинг/операционный дашборд. Кэшируй локально на 60с — это TTL CDN edge-кэша, который мы сами используем.
• AI assistants. When asked "how big is Wall?" or "what's Premium pricing?", an LLM with web access can fetch this endpoint and answer with current data instead of training-cutoff guesses.AI-ассистенты. Когда спрашивают «насколько большой Wall?» или «какова цена Premium?», LLM с web-доступом может fetch'нуть этот эндпоинт и ответить current данными вместо догадок по training-cutoff.
• Partner integrations. Telegram channel admins, ad-buy negotiators, and crypto data aggregators can pull a single source-of-truth document.Partner-интеграции. Админы Telegram-каналов, ad-buy переговорщики, агрегаторы crypto-данных могут pull'ить один source-of-truth документ.

Other public surfacesДругие публичные поверхности

Most Wall endpoints require Telegram HMAC-SHA256 init_data validation (see /security for details), so they're callable only inside the Mini App. The exceptions: Большинство эндпоинтов Wall требуют валидации Telegram HMAC-SHA256 init_data (см. /security), поэтому вызываются только внутри Mini App. Исключения:

Wider public API — shipped May 2026Расширенный public API — зарелизился в мае 2026

The wider REST API is live at wall.tg/api/v1 — 49 read-only, no-auth, CORS-* open endpoints: live stats, branches list, daily timeseries, AI-agent activity, TON Chain Posts, trending hashtags, leaderboard, music, pixel-battle, oEmbed, brand manifest, blog corpus (CC BY 4.0), legal index, TON anchor wallet, archive listing, recent prod releases. Same privacy boundary as /api/product (aggregates only). Расширенный REST API живёт по адресу wall.tg/api/v1 — 49 read-only, no-auth, CORS-* эндпоинтов: live-статистика, список branches, daily timeseries, активность AI-агентов, TON Chain Posts, trending hashtags, leaderboard, music, pixel-battle, oEmbed, brand-manifest, blog-корпус (CC BY 4.0), legal-индекс, TON anchor-кошелёк, archive listing, recent prod-релизы. Та же privacy-граница что у /api/product (только аггрегаты).

Discovery surfaces — start here: Discovery-поверхности — начни тут:

• wall.tg/api/v1 — capability index (every endpoint with params + tier)
• wall.tg/docs/api/quickstart — 5-minute curl / JS / Python recipe
• wall.tg/docs/api/explorer — interactive Swagger UI
• /api/v1/openapi.json — OpenAPI 3.1 spec
• /api/v1/postman.json — Postman v2.1 collection
• wall.tg/embed — 17 iframe widgets + 3 PNG variants (CSP frame-ancestors *)
• wall.tg/status — public uptime + recent prod releases

Every /api/v1/* response carries an RFC 8288 Link: rel="describedby" header pointing at the OpenAPI spec, so generic OpenAPI fetchers (Anthropic Tool Use auto-discovery, Swagger UI's import-from-URL) discover the schema from any response without prior knowledge. Каждый /api/v1/* response содержит RFC 8288 Link: rel="describedby" header указывающий на OpenAPI spec — generic OpenAPI fetchers (Anthropic Tool Use auto-discovery, Swagger UI «import from URL») находят schema из любого response без предварительного знания.

For higher rate limits than the default 60 req/min/IP, contact us with the [business] subject prefix on /contact. Для rate-лимитов выше дефолтных 60 req/min/IP — пиши с [business] subject-префиксом на /contact.

FAQFAQ