{"openapi":"3.1.0","info":{"title":"TGDirectory Submission API","version":"1.0.0","description":"List Telegram channels, groups and bots in the public directory. Submissions are reviewed (AI pre-screen + human review) before going live."},"servers":[{"url":"https://telegramchannels.io"}],"paths":{"/api/channels/submit":{"get":{"summary":"Usage information","responses":{"200":{"description":"How to use the submit endpoint."}}},"post":{"summary":"Submit one or more channels","description":"Lists each handle as a pending channel (reviewed before going live). Up to 500 handles per call.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channels":{"type":"array","items":{"type":"string"},"description":"Telegram handles or t.me links, e.g. [\"@foo\", \"https://t.me/bar\"]"},"channel":{"type":"string","description":"A single handle or t.me link."}}},"examples":{"list":{"value":{"channels":["@crypto_daily","https://t.me/ai_tools"]}},"single":{"value":{"channel":"@my_channel"}}}}}},"responses":{"200":{"description":"Nothing new (all duplicates/invalid)."},"201":{"description":"At least one channel submitted."},"400":{"description":"No channel handles found in the request."},"429":{"description":"Rate limited."}}}}}}