# Telemost Telegram Meta Dictionaries

> Telemost Telegram Meta Dictionaries is a paid API for AI agents from api.telemost.io, paid per call via x402, $0.0165/call, status unknown (last checked 2026-09-16).

Returns reference lookup data (countries, categories, or languages) used as filter and targeting values in Telegram analytics queries.

## Facts

- Endpoint: GET https://api.telemost.io/v1/meta/dictionaries
- Price: $0.0165/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/telemost-telegram-meta-dictionaries-9c2f34bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Nt727WtppwdUTzUTg7cbt

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 telemost-telegram-meta-dictionaries-9c2f34bd
```

Example prompt: Can you fetch the full list of countries available as filter values in the Telemost Telegram analytics API?

## When to prefer this

Use this endpoint before making filtered analytics queries to Telemost to discover valid enum values for country, category, or language filters. Ideal when building dynamic filter UIs, validating user-supplied filter inputs, or bootstrapping an integration that needs to know supported targeting dimensions.

## Known failure modes

- Missing or invalid 'kind' parameter returns a 400 or validation error
- Unsupported 'region' enum value may result in a 400 bad request
- Payment not provided or insufficient USDC balance causes a 402 Payment Required response
- Endpoint temporarily unavailable returns 503
- Empty result if no entries exist for the requested kind

## How this service works

Reference data for the Telegram analytics API: countries, categories and languages used for filters and targeting.

## Output

A structured list of valid reference values for the requested dictionary type — either a list of country codes/names, channel categories, or supported languages — which can be used as filter parameters in other Telemost Telegram analytics endpoints.

## 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": [
      "kind"
     ],
     "properties": {
      "kind": {
       "enum": [
        "countries",
        "categories",
        "languages"
       ],
       "type": "string"
      },
      "region": {
       "enum": [
        "cis",
        "worldwide"
       ],
       "type": "string",
       "description": "Optional routing region hint (cis|worldwide). Does not affect payment (not an x402 field)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "kind": "countries",
   "items": []
  },
  "meta": {
   "cached": false,
   "resource": "/v1/meta/dictionaries",
   "generated_at": "2026-07-07T12:00:00.000Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/telemost-telegram-meta-dictionaries-9c2f34bd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.telemost.io](https://www.zero.xyz/host/api.telemost.io/llms.txt)