# SiteCheck Shop & Social – Telegram Channel Preview

> SiteCheck Shop & Social – Telegram Channel Preview is a paid API for AI agents from api.shopsocial-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Fetches the public preview of a Telegram channel, including title, description, subscriber/media counts, and the latest ~20 posts with text, view counts, and timestamps.

## Facts

- Endpoint: GET https://api.shopsocial-api.workers.dev/api/social/telegram-channel?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-shop-social-telegram-channel-preview-4ff15f3a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FhRY3RlcVIvQPvqevc6zr

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sitecheck-shop-social-telegram-channel-preview-4ff15f3a
```

Example prompt: Pull the latest posts and stats from the Telegram channel 'durov' — I want to see the subscriber count, description, and the most recent messages with their view counts.

## When to prefer this

Use this endpoint when you need quick, structured metadata and recent post history from a public Telegram channel without requiring Telegram API credentials or bot tokens. It is ideal for monitoring, research, or competitive analysis of public channels. Prefer it over Telegram's official API when you want a simple, pay-per-call REST interface with no authentication setup.

## Known failure modes

- Private or non-existent channel returns an error or empty result — only public channels with a t.me/s preview are supported
- Invalid username format (e.g. too short, contains illegal characters) returns a validation error
- Channel with no public preview (e.g. private groups, bots without channels) returns no data
- Rate limiting or Telegram-side blocking may cause intermittent failures
- Channels with very few posts may return fewer than 20 items

## How this service works

Pay-per-call e-commerce, product, price and social media data tools for AI agents, from public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

Returns a JSON object containing: the channel's title, username, and description; counters for subscribers, photos, videos, and links; a list of up to ~20 recent posts each with ID, URL, ISO 8601 date, text content, and view count string; the source URL; and a checkedAt timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "channel"
     ],
     "properties": {
      "channel": {
       "type": "string",
       "description": "Public channel username without @ (5-32 letters, digits or _)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "posts": [
   {
    "id": 441,
    "url": "https://t.me/telegram/441",
    "date": "2026-05-14T16:08:31+00:00",
    "text": "Bot-to-Bot Communication. Bots are now able to respond to other bots, not just users.\n\nAI enthusiasts can utilize this to create custom workflows with autonomous agents.\n\nMay Features\n1 • 2 • 3 • 4 • 5 • More",
    "views": "1.59M"
   },
   {
    "id": 442,
    "url": "https://t.me/telegram/442",
    "date": "2026-05-14T16:08:52+00:00",
    "text": "Chat Automation in Profiles. Every Telegram user can now connect a bot to their profile – and let it respond to messages on their behalf.\n\nMay Features\n1 • 2 • 3 • 4 • 5 • More",
    "views": "1.35M"
   }
  ],
  "source": "https://t.me/s/telegram",
  "channel": {
   "title": "Telegram News",
   "username": "telegram",
   "description": "The official Telegram on Telegram. Much recursion. Very Telegram. Wow."
  },
  "counters": {
   "links": "378",
   "photos": "16",
   "videos": "228",
   "subscribers": "9.25M"
  },
  "checkedAt": "2026-10-23T09:37:47.459Z",
  "postCount": 20
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-shop-social-telegram-channel-preview-4ff15f3a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.shopsocial-api.workers.dev](https://www.zero.xyz/host/api.shopsocial-api.workers.dev/llms.txt)
