{"id":13988664,"url":"https://github.com/PaulSonOfLars/telegram-bot-api-spec","last_synced_at":"2025-07-22T09:31:24.190Z","repository":{"id":37425424,"uuid":"320070606","full_name":"PaulSonOfLars/telegram-bot-api-spec","owner":"PaulSonOfLars","description":"A simple JSON description of the telegram bot API which updates itself every day.","archived":false,"fork":false,"pushed_at":"2025-07-19T17:13:24.000Z","size":760,"stargazers_count":118,"open_issues_count":2,"forks_count":30,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-07-19T20:52:45.174Z","etag":null,"topics":["definition","definition-generation","generation","schema","spec","specification","telegram","telegram-api","telegram-api-json","telegram-bot-api","telegram-bot-api-json","telegram-bot-api-schema","telegram-bot-api-spec","telegram-bots"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PaulSonOfLars.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-12-09T20:24:04.000Z","updated_at":"2025-07-19T17:13:27.000Z","dependencies_parsed_at":"2024-03-01T13:38:16.239Z","dependency_job_id":"e53d0bf0-013c-468d-964a-5bce2a4ce407","html_url":"https://github.com/PaulSonOfLars/telegram-bot-api-spec","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PaulSonOfLars/telegram-bot-api-spec","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaulSonOfLars%2Ftelegram-bot-api-spec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaulSonOfLars%2Ftelegram-bot-api-spec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaulSonOfLars%2Ftelegram-bot-api-spec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaulSonOfLars%2Ftelegram-bot-api-spec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PaulSonOfLars","download_url":"https://codeload.github.com/PaulSonOfLars/telegram-bot-api-spec/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaulSonOfLars%2Ftelegram-bot-api-spec/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266465073,"owners_count":23933055,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["definition","definition-generation","generation","schema","spec","specification","telegram","telegram-api","telegram-api-json","telegram-bot-api","telegram-bot-api-json","telegram-bot-api-schema","telegram-bot-api-spec","telegram-bots"],"created_at":"2024-08-09T13:01:17.721Z","updated_at":"2025-07-22T09:31:23.774Z","avatar_url":"https://github.com/PaulSonOfLars.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# telegram-bot-api-spec\n\nThis repo provides the necessary scripts to scrape the [telegram bot api docs] for method, types, and docstrings.\n\nThe main usecase of having this data is expected to be to generate automated libraries which follow the bot api \ndocumentation to the letter. Assuming the docs are correct, autogenerated libraries provide the following:\n- Easy to update. Simply re-generate the code using the new JSON spec.\n- Typo free. All methods/fields are guaranteed to be correct.\n- No missing fields. If its in the spec, its in your code!\n\nThe output of this script `api.json`, is formatted as such:\n\n```\n{\n  \"methods\": {\n    \u003cmethod name\u003e : {\n      \"name\": // string, method name\n      \"href\": // string, link to docs\n      \"returns\": // array of string, possible return types\n      \"description\": // array of string, documentation lines\n      \"fields\": [\n        {\n          \"name\": // string, field name\n          \"types\": // array of string, possible field types\n          \"required\": // bool, whether field is required\n          \"description\": // string, documentation for field\n        },\n        ...\n      ], // array of fields\n      \"subtypes\": // array of string, all the types that subtype this item (eg, InputMedia has subtypes InputMediaAnimation, InputMediaDocument etc)\n      \"subtype_of\": // array of string, all the \"parent\" types of this type (eg, InputMediaAnimation is a subtype of InputMedia)\n    },\n    ...\n  }, // map of method name -\u003e method details\n  \"types\": {\n    \u003ctype name\u003e : {\n      \"name\": // string, type name\n      \"href\": // string, link to docs\n      \"description\": // array of string, documentation lines\n      \"fields\": [\n        {\n          \"name\": // string, field name\n          \"types\": // array of string, possible field types\n          \"required\": // bool, whether field is required\n          \"description\": // string, documentation for field\n        },\n        ...\n      ], // array of type fields\n    },\n    ...  \n  } // map of type name -\u003e type details\n}\n```\n\n\n\n[telegram bot api docs]: https://core.telegram.org/bots/api","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPaulSonOfLars%2Ftelegram-bot-api-spec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPaulSonOfLars%2Ftelegram-bot-api-spec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPaulSonOfLars%2Ftelegram-bot-api-spec/lists"}