GET 数据查询

腾讯天气

腾讯天气，点击查看详细参数与调用示例。

累计调用 13 今日调用 0

更新于 2026-10-16

调用地址

GET

https://itapi.top/api/txtq

请求参数

参数名	类型	必填	说明	示例
ip	int	必填	要查询的IP地址，若不提供则使用客户端IP	北京
city	string	必填	城市名称（与ip、location互斥，优先级次于ip）	北京
district	int	必填	当使用city参数时，可指定区/县名称，提高定位精度	北京
location	int	必填	完整地理位置，格式为：省份,城市,区县（与ip、city互斥，优先级最低）	北京
full	int	必填	是否返回完整天气数据（当前版本始终返回完整数据，此参数预留）	北京
minify	int	必填	是否压缩JSON输出（去掉美化空格），1表示压缩	北京
test	int	必填	测试模式，可选值：ip（IP测试）、geo（地理API测试）、weather（天气API测试）	北京
province	string	必填	省份名称（测试模式专用）	北京

响应示例

200 OK

{"api":"IP与天气查询接口","version":"3.0","timestamp":"2026-10-16 19:55:07","success":false,"client_ip":"154.12.85.233","processing_time":"570.26ms","error":"所有IP查询API都失败了","error_type":"API_ERROR"}

在线测试

ip *

city *

district *

location *

full *

minify *

test *

province *

代码示例

cURL · GET

curl "https://itapi.top/api/txtq?ip=%E5%8C%97%E4%BA%AC&city=%E5%8C%97%E4%BA%AC&district=%E5%8C%97%E4%BA%AC&location=%E5%8C%97%E4%BA%AC&full=%E5%8C%97%E4%BA%AC&minify=%E5%8C%97%E4%BA%AC&test=%E5%8C%97%E4%BA%AC&province=%E5%8C%97%E4%BA%AC"

PHP

<?php
$res  = file_get_contents("https://itapi.top/api/txtq?ip=%E5%8C%97%E4%BA%AC&city=%E5%8C%97%E4%BA%AC&district=%E5%8C%97%E4%BA%AC&location=%E5%8C%97%E4%BA%AC&full=%E5%8C%97%E4%BA%AC&minify=%E5%8C%97%E4%BA%AC&test=%E5%8C%97%E4%BA%AC&province=%E5%8C%97%E4%BA%AC");
$json = json_decode($res, true);
print_r($json);

JavaScript

const res  = await fetch("https://itapi.top/api/txtq?ip=%E5%8C%97%E4%BA%AC&city=%E5%8C%97%E4%BA%AC&district=%E5%8C%97%E4%BA%AC&location=%E5%8C%97%E4%BA%AC&full=%E5%8C%97%E4%BA%AC&minify=%E5%8C%97%E4%BA%AC&test=%E5%8C%97%E4%BA%AC&province=%E5%8C%97%E4%BA%AC");
const json = await res.json();
console.log(json);

Python

import requests

r = requests.get("https://itapi.top/api/txtq?ip=%E5%8C%97%E4%BA%AC&city=%E5%8C%97%E4%BA%AC&district=%E5%8C%97%E4%BA%AC&location=%E5%8C%97%E4%BA%AC&full=%E5%8C%97%E4%BA%AC&minify=%E5%8C%97%E4%BA%AC&test=%E5%8C%97%E4%BA%AC&province=%E5%8C%97%E4%BA%AC", timeout=10)
print(r.json())

返回接口列表