API v5 文档

用于实时报价、运行时状态、源覆盖范围和聚合目录浏览的公共 API。所有公共集成必须保留 Avion Tracker 归属并链接回 https://tracker.discordlabs.app。

需要归属 90 请求/分钟/IP 版本化的公共表面 OpenAPI-ready

端点

Public integrations should target v5 only. The routes below cover status, coverage, feeds and catalog access for websites, widgets and bots.

GET /api/v5/meta

版本信息、链接、限制和平台摘要。

GET /api/v5/status

运行时健康状况、网关状态、分片、集群和实时覆盖。

GET /api/v5/coverage

活跃源的逐源和逐商店细分。

GET /api/v5/offers

公共直播提供带有过滤器的提要：模式、排序、商店、平台、种类、限制。

GET /api/v5/catalog

使用 q、源、限制和偏移参数进行目录搜索和浏览。

GET /api/v5/trending

跟踪标题按实时传播、免费掉落和市场覆盖率排名。

GET /api/v5/latest

最新跟踪的标题和新的目录动态。

GET /api/v5/freenow

当前免费优惠的快捷方式，按最近的到期日排序。

GET /api/v5/feeds/source/:sourceKey

仪表板、小部件和外部镜子的按源实时馈送。

GET /api/v5/feeds/store/:storeKey

每个商店的实时反馈，带有模式和排序控件。

GET /api/v5/openapi.json

用于客户端生成的机器可读 OpenAPI 合约。

使用政策

您可以嵌入或镜像 API v5 数据，但您的集成必须明显归功于 Avion Tracker，保留返回 https://tracker.discordlabs.app 的源链接，并保持版权标头不变。技术控制可以减少滥用，但法律归属仍然很重要。

版权

保护

API v5 ships with per-IP rate limiting, branding headers, canonical docs links and explicit attribution metadata in every response.

示例

Use the ready-made public routes below for widgets, cron pulls, websites and dashboards.

立即免费公开

curl https://tracker.discordlabs.app/api/v5/freenow?limit=12

来源提要

https://tracker.discordlabs.app/api/v5/feeds/source/epic?mode=free&limit=20

Coverage snapshot

curl https://tracker.discordlabs.app/api/v5/coverage

部署说明

Cache responses briefly, preserve attribution headers, and link back to https://tracker.discordlabs.app whenever you embed or mirror the data.

响应样本

每个响应都将数据包含在一个稳定的信封中，其中包含版本、时间戳和属性元数据。

{
  "apiVersion": "v5",
  "resource": "offers",
  "generatedAt": 1777648089664,
  "attribution": {
    "brand": "Avion Tracker",
    "website": "https://tracker.discordlabs.app",
    "docs": "https://tracker.discordlabs.app/docs/api-v5",
    "dashboard": "https://tracker.discordlabs.app/dashboard",
    "copyright": "Copyright 2026 Avion Tracker. Public mirrors, embeds and dashboards must attribute Avion Tracker and link back to https://tracker.discordlabs.app.",
    "attributionRequired": true
  },
  "data": {
    "total": 2,
    "filtered": 2,
    "mode": "free",
    "sort": "ending",
    "store": null,
    "platform": null,
    "kind": "all",
    "offers": [
      {
        "key": "indiegala:https://www.indiegala.com/giveaways/card/grav-blazer-squared/1196402",
        "externalId": "https://www.indiegala.com/giveaways/card/grav-blazer-squared/1196402",
        "sourceKey": "indiegala-direct",
        "title": "Grav Blazer Squared",
        "description": "Enter the IndieGala giveaway for a chance to win a free key.",
        "url": "https://www.indiegala.com/giveaways/card/grav-blazer-squared/1196402",
        "imageUrl": "https://steamcdn-a.akamaihd.net/steam/apps/703530/header.jpg",
        "store": "indiegala",
        "type": "other",
        "kind": "game",
        "currency": "USD",
        "originalPrice": null,
        "discountedPrice": 0,
        "startsAt": null,
        "endsAt": 1777648382607,
        "platforms": [
          "windows"
        ],
        "rating": null,
        "discountPercent": null,
        "isFree": true
      },
      {
        "key": "indiegala:https://www.indiegala.com/giveaways/card/the-universim/1196261",
        "externalId": "https://www.indiegala.com/giveaways/card/the-universim/1196261",
        "sourceKey": "indiegala-direct",
        "title": "The Universim",
        "description": "Enter the IndieGala giveaway for a chance to win a free key.",
        "url": "https://www.indiegala.com/giveaways/card/the-universim/1196261",
        "imageUrl": "https://steamcdn-a.akamaihd.net/steam/apps/352720/header.jpg",
        "store": "indiegala",
        "type": "other",
        "kind": "game",
        "currency": "USD",
        "originalPrice": null,
        "discountedPrice": 0,
        "startsAt": null,
        "endsAt": 1777649042607,
        "platforms": [
          "windows"
        ],
        "rating": null,
        "discountPercent": null,
        "isFree": true
      }
    ]
  }
}