Limzo · Schema
GroupDirectory
Compact directory rows for discovering groups. Sorted by Limzo Score.
TelegramBotAnti-SpamGroup Analytics
Properties
| Name | Type | Description |
|---|---|---|
| ok | boolean | |
| docs | string | Human-readable API documentation. |
| openapi | string | Machine-readable OpenAPI document for the REST API. |
| query | stringnull | The normalized search keyword, or null when listing top groups. |
| lang | stringnull | The applied ISO 639-1 language filter, or null when not filtering by language. |
| total_matches | integer | Groups that matched, before the limit was applied. |
| groups | array |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/limzo-com/json-schema/limzo-com-group-directory-schema.json",
"title": "GroupDirectory",
"description": "Compact directory rows for discovering groups. Sorted by Limzo Score.",
"x-generated": "2026-11-17",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/limzo-com-openapi.yml#/components/schemas/GroupDirectory",
"type": "object",
"required": [
"ok",
"total_matches",
"groups"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"docs": {
"type": "string",
"format": "uri",
"description": "Human-readable API documentation."
},
"openapi": {
"type": "string",
"format": "uri",
"description": "Machine-readable OpenAPI document for the REST API."
},
"query": {
"type": [
"string",
"null"
],
"description": "The normalized search keyword, or null when listing top groups."
},
"lang": {
"type": [
"string",
"null"
],
"description": "The applied ISO 639-1 language filter, or null when not filtering by language."
},
"total_matches": {
"type": "integer",
"description": "Groups that matched, before the limit was applied."
},
"groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Use with /s/{slug}.json or the get_group_stats MCP tool."
},
"title": {
"type": "string"
},
"username": {
"type": [
"string",
"null"
],
"description": "Telegram username without @, when the group is public on t.me."
},
"plan": {
"type": "string",
"enum": [
"free",
"pro",
"community"
]
},
"member_count": {
"type": [
"integer",
"null"
]
},
"score": {
"type": "number",
"description": "Limzo Score — the directory ranking metric."
},
"messages_7d": {
"type": "integer"
},
"active_users_7d": {
"type": "integer"
},
"language": {
"type": [
"object",
"null"
],
"description": "The group's language mix (primary language + top languages as percentages). Null when there is not enough signal.",
"properties": {
"primary": {
"type": [
"string",
"null"
],
"description": "Dominant language as an ISO 639-1 code."
},
"distinct": {
"type": "integer",
"description": "Number of distinct languages detected."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
],
"description": "ISO 639-1 language code, or null for the aggregated \"other\" bucket."
},
"name": {
"type": "string"
},
"pct": {
"type": "number",
"description": "Share of the group, 0–100."
}
}
}
}
}
},
"url": {
"type": "string",
"format": "uri",
"description": "The human stats page for this group."
},
"stats_json": {
"type": "string",
"format": "uri",
"description": "Full curated stats payload for this group."
}
}
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/limzo-com-group-directory"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.