API 文档

详细的API接口说明和使用指南

Trends

GET

描述

获取Twitter趋势话题

接口地址

https://api.twtapi.com/api/v1/twitter/Trends

参数说明

参数名类型是否必须说明
woeidnumber是Where On Earth ID，指定地区。常用值：1=全球, 23424819=日本, 23424977=美国, 2151849=中国香港, 23424775=澳大利亚

返回示例

{
  "success": true,
  "data": {
    "trends": [
      {
        "name": "#Bitcoin",
        "url": "https://twitter.com/search?q=%23Bitcoin",
        "tweet_volume": 125400
      }
    ]
  }
}

错误码说明

后端常见业务错误码说明。所有接口统一返回格式：{ code, msg, data }。

说明：`code` 是响应体中的业务状态码，可能与 HTTP 状态码不同。

错误码名称含义建议处理
200成功请求处理成功。读取 `data` 获取业务数据。
400请求参数错误参数不合法或业务校验未通过。检查必填参数、取值范围与请求格式。
401未授权鉴权失败（未登录、缺少或无效 API Key）。重新登录或传入有效的 `X-API-Key`。
402余额不足余额不足或调用次数已用完，无法完成本次调用。请充值或升级套餐后重试。
403无权限没有访问权限或账户状态受限。检查账户状态和接口访问权限。
404资源不存在请求的资源不存在。检查 ID/订单号是否正确、数据是否存在。
429请求过于频繁触发每秒/每小时/月度限流。降低请求频率，并使用退避重试。
500服务器内部错误服务端处理异常。稍后重试；持续失败请联系支持。
502服务暂时不可用服务请求处理失败。请稍后重试。
503服务繁忙系统繁忙或触发全局保护限制。等待短时间后重试。

代码生成器

curl -X GET "https://api.twtapi.com/api/v1/twitter/Trends?lang=zh" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Lang: zh"

测试 API

请求参数