{"openapi":"3.1.0","info":{"title":"CPA.TG Rumors Public API","version":"1.3.1","summary":"Открытая read-only лента сплетен CPA рынка без ключей и регистрации.","description":"Открытая read-only лента и каталог медиа без ключей: JSON, RSS, Atom, JSON Feed, NDJSON, CSV и проверяемые gzip-снимки. CC0 1.0, бесплатно, изменение и коммерческое использование разрешены, атрибуция не обязательна в пределах прав CPA.TG.","termsOfService":"https://cpa.tg/api/rumors/v1/docs#terms","license":{"name":"CC0 1.0 Universal","identifier":"CC0-1.0"}},"servers":[{"url":"https://cpa.tg/api/rumors/v1"}],"security":[],"paths":{"/":{"get":{"operationId":"getApiIndex","summary":"API index and live statistics","responses":{"200":{"description":"API index"}}}},"/posts":{"get":{"operationId":"listPosts","summary":"List rumor posts","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque cursor from meta.next_cursor."},{"name":"channel","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"tag","in":"query","schema":{"type":"string"}},{"name":"sentiment","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string","maxLength":120}},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"until","in":"query","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Cursor-paginated posts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostCollection"}}}},"422":{"description":"Ошибка запроса","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/posts/{id}":{"get":{"operationId":"getPost","summary":"Get one post or album representative","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Post","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostResponse"}}}},"404":{"description":"Ошибка запроса","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/channels":{"get":{"operationId":"listChannels","summary":"List source channels","responses":{"200":{"description":"Channels"}}}},"/channels/{slug}":{"get":{"operationId":"getChannel","summary":"Get a source channel","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Channel"},"404":{"description":"Ошибка запроса","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/channels/{slug}/posts":{"get":{"operationId":"listChannelPosts","summary":"List posts from one channel","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque cursor from meta.next_cursor."},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"tag","in":"query","schema":{"type":"string"}},{"name":"sentiment","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string","maxLength":120}},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"until","in":"query","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Channel posts"},"404":{"description":"Ошибка запроса","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/tags":{"get":{"operationId":"listTags","summary":"List tags","responses":{"200":{"description":"Tags"}}}},"/entities":{"get":{"operationId":"listEntities","summary":"List public entities","responses":{"200":{"description":"Entities"}}}},"/feed.rss":{"get":{"operationId":"getRssFeed","summary":"RSS 2.0 feed","parameters":[{"name":"channel","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"RSS feed","content":{"application/rss+xml":{}}}}}},"/feed.json":{"get":{"operationId":"getJsonFeed","summary":"JSON Feed 1.1","parameters":[{"name":"channel","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON Feed"}}}},"/openapi.json":{"get":{"operationId":"getOpenApi","summary":"OpenAPI 3.1 contract","responses":{"200":{"description":"OpenAPI document"}}}},"/feed.atom":{"get":{"operationId":"getAtomFeed","summary":"Atom 1.0 feed","responses":{"200":{"description":"Atom feed","content":{"application/atom+xml":{}}}}}},"/export.ndjson":{"get":{"operationId":"exportNdjsonPage","summary":"Cursor-paginated NDJSON","responses":{"200":{"description":"One JSON object per line"}}}},"/export.csv":{"get":{"operationId":"exportCsvPage","summary":"Cursor-paginated UTF-8 CSV","responses":{"200":{"description":"CSV with header"}}}},"/snapshot-manifest.json":{"get":{"operationId":"getSnapshotManifest","summary":"Latest full snapshot manifest with SHA-256","responses":{"200":{"description":"Snapshot manifest"},"503":{"description":"Snapshot is building"}}}},"/snapshot.json.gz":{"get":{"operationId":"downloadJsonSnapshot","summary":"Complete gzip JSON snapshot","responses":{"200":{"description":"Gzip file"}}}},"/snapshot.ndjson.gz":{"get":{"operationId":"downloadNdjsonSnapshot","summary":"Complete gzip NDJSON snapshot","responses":{"200":{"description":"Gzip file"}}}},"/snapshot.csv.gz":{"get":{"operationId":"downloadCsvSnapshot","summary":"Complete gzip CSV snapshot","responses":{"200":{"description":"Gzip file"}}}},"/snapshots/{snapshot_id}/snapshot.json.gz":{"get":{"operationId":"downloadImmutableJsonSnapshot","summary":"Immutable gzip JSON snapshot","parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{8}T[0-9]{6}Z$"}}],"responses":{"200":{"description":"Exact manifest-bound gzip file"},"404":{"description":"Snapshot expired"}}}},"/snapshots/{snapshot_id}/snapshot.ndjson.gz":{"get":{"operationId":"downloadImmutableNdjsonSnapshot","summary":"Immutable gzip NDJSON snapshot","parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{8}T[0-9]{6}Z$"}}],"responses":{"200":{"description":"Exact manifest-bound gzip file"},"404":{"description":"Snapshot expired"}}}},"/snapshots/{snapshot_id}/snapshot.csv.gz":{"get":{"operationId":"downloadImmutableCsvSnapshot","summary":"Immutable gzip CSV snapshot","parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{8}T[0-9]{6}Z$"}}],"responses":{"200":{"description":"Exact manifest-bound gzip file"},"404":{"description":"Snapshot expired"}}}},"/snapshots/{snapshot_id}/media-manifest.ndjson.gz":{"get":{"operationId":"downloadImmutableMediaNdjsonManifest","summary":"Immutable gzip media NDJSON manifest","parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{8}T[0-9]{6}Z$"}}],"responses":{"200":{"description":"Exact manifest-bound gzip file"},"404":{"description":"Snapshot expired"}}}},"/snapshots/{snapshot_id}/media-manifest.csv.gz":{"get":{"operationId":"downloadImmutableMediaCsvManifest","summary":"Immutable gzip media CSV manifest","parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{8}T[0-9]{6}Z$"}}],"responses":{"200":{"description":"Exact manifest-bound gzip file"},"404":{"description":"Snapshot expired"}}}},"/media":{"get":{"operationId":"listMedia","summary":"Cursor-paginated downloadable media catalog","responses":{"200":{"description":"Media collection"}}}},"/media/{id}":{"get":{"operationId":"getMedia","summary":"One media metadata resource","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^(?:[a-f0-9]{40}|media-[1-9][0-9]{0,9})$"}}],"responses":{"200":{"description":"Media metadata"},"404":{"description":"Not found"}}}},"/media/export.ndjson":{"get":{"operationId":"exportMediaNdjsonPage","summary":"Cursor-paginated media NDJSON","responses":{"200":{"description":"Media NDJSON"}}}},"/media/export.csv":{"get":{"operationId":"exportMediaCsvPage","summary":"Cursor-paginated media CSV","responses":{"200":{"description":"Media CSV"}}}},"/media-manifest.ndjson.gz":{"get":{"operationId":"downloadMediaNdjsonManifest","summary":"Complete gzip media manifest","responses":{"200":{"description":"Gzip media NDJSON"}}}},"/media-manifest.csv.gz":{"get":{"operationId":"downloadMediaCsvManifest","summary":"Complete gzip media manifest","responses":{"200":{"description":"Gzip media CSV"}}}},"/tombstones":{"get":{"operationId":"listTombstones","summary":"Deleted record identifiers","responses":{"200":{"description":"Cursor-paginated deletions"}}}},"/schema.json":{"get":{"operationId":"getPostJsonSchema","summary":"JSON Schema 2020-12 for one post","responses":{"200":{"description":"JSON Schema"}}}},"/agent.md":{"get":{"operationId":"getAgentInstructions","summary":"Machine-readable agent instructions","responses":{"200":{"description":"Markdown"}}}},"/skill.md":{"get":{"operationId":"getAgentSkill","summary":"Portable Claude/Codex/agent skill prompt","responses":{"200":{"description":"Markdown"}}}},"/license.json":{"get":{"operationId":"getReuseLicenseJson","summary":"Machine-readable CC0/open reuse policy","responses":{"200":{"description":"Reuse policy"}}}},"/license.md":{"get":{"operationId":"getReuseLicenseMarkdown","summary":"Human-readable CC0/open reuse policy","responses":{"200":{"description":"Reuse policy"}}}},"/health":{"get":{"operationId":"getApiHealth","summary":"Database and snapshot freshness","responses":{"200":{"description":"Health status"}}}}},"components":{"securitySchemes":{},"schemas":{"Post":{"type":"object","required":["id","published_at","text","channel","media","entities","tags","metrics","reuse","links"],"properties":{"id":{"type":"integer"},"published_at":{"type":"string","format":"date-time"},"text":{"type":"string"},"summary":{"type":["string","null"]},"summary_generated_by_ai":{"type":"boolean"},"sentiment":{"type":["string","null"]},"channel":{"type":"object"},"source_url":{"type":["string","null"],"format":"uri"},"media":{"type":"array","items":{"type":"object"}},"entities":{"type":"array","items":{"type":"object"}},"tags":{"type":"array","items":{"type":"object"}},"metrics":{"type":"object"},"links":{"type":"object"},"reuse":{"type":"object","required":["license","license_url","price","authentication_required","permission_required","attribution_required","commercial_use_allowed","modification_allowed","redistribution_allowed"],"additionalProperties":true}},"additionalProperties":true},"PostResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Post"},"meta":{"type":"object"},"links":{"type":"object"}}},"PostCollection":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Post"}},"meta":{"type":"object"},"links":{"type":"object"}}},"Problem":{"type":"object","required":["type","title","status","code","detail","request_id"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"request_id":{"type":"string"}}}}},"x-agent-instructions":"https://cpa.tg/api/rumors/v1/agent.md"}