API 详情
手机号归属地查询
查询手机号归属地(省/市)与运营商
GET
公开 API
分类:工具
限流 120 / 分钟
完整请求 URL
可直接在浏览器、终端或调试工具中调用
接口说明
手机号归属地查询
查询中国大陆手机号归属地与运营商
请求
GET /api/tools/phone-area?number=13800138000
参数
| 参数 | 必填 | 说明 |
|---|---|---|
| number | 是 | 11 位中国大陆手机号(支持传 +86 前缀) |
响应
code=200 时 data 包含:
number:手机号province:省份/直辖市/特区/自治区city:规范化城市carrier:规范化运营商raw:原始字段备查
在线调试
通过本站代发请求。GET 时会把 JSON 中的键值作为 Query,非 GET 时作为 JSON Body.
示例代码
// GET https://api.avrinbai.cn/api/tools/phone-area
const payload = {
"number": "13888888888"
};
const url = new URL('https://api.avrinbai.cn/api/tools/phone-area');
url.search = new URLSearchParams(payload).toString();
const headers = {
"Accept": "application/json",
"Content-Type": "application/json",
};
const res = await fetch(url.toString(), {
method: "GET",
headers,
});
// 兼容返回 JSON / 纯文本 / 二进制
const contentType = res.headers.get("content-type") || "";
if (contentType.includes("application/json")) {
console.log(await res.json());
} else {
console.log(await res.text());
}
// GET https://api.avrinbai.cn/api/tools/phone-area
import axios from "axios";
const payload = {
"number": "13888888888"
};
const headers = {
"Accept": "application/json",
};
const url = "https://api.avrinbai.cn/api/tools/phone-area";
const res = await axios.request({
url,
method: "GET",
headers,
params: payload,
// responseType: "arraybuffer", // 若接口返回图片/音视频,可按需开启
});
console.log(res.status, res.data);
# GET https://api.avrinbai.cn/api/tools/phone-area
import requests
payload = {
"number": "13888888888"
}
headers = {
"Accept": "application/json",
}
# headers["X-API-Key"] = "YOUR_API_KEY"
res = requests.request(
"GET",
"https://api.avrinbai.cn/api/tools/phone-area",
headers=headers,
params=payload,
timeout=25,
)
print(res.status_code)
print(res.text)
// GET https://api.avrinbai.cn/api/tools/phone-area
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
payload := map[string]any{
"number": "13888888888"
}
u, _ := url.Parse("https://api.avrinbai.cn/api/tools/phone-area")
q := u.Query()
q.Set("number", "13888888888")
u.RawQuery = q.Encode()
targetURL := u.String()
var body io.Reader = nil
req, _ := http.NewRequest("GET", targetURL, body)
req.Header.Set("Accept", "application/json")
req.Header.Set("Content-Type", "application/json")
// req.Header.Set("X-API-Key", "YOUR_API_KEY")
client := &http.Client{}
res, err := client.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
raw, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode)
fmt.Println(string(raw))
}
// GET https://api.avrinbai.cn/api/tools/phone-area
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
payload := map[string]any{
"number": "13888888888"
}
u, _ := url.Parse("https://api.avrinbai.cn/api/tools/phone-area")
q := u.Query()
q.Set("payload", "{\"number\":\"13888888888\"}")
u.RawQuery = q.Encode()
targetURL := u.String()
var body io.Reader = nil
req, _ := http.NewRequest("GET", targetURL, body)
req.Header.Set("Accept", "application/json")
req.Header.Set("Content-Type", "application/json")
// req.Header.Set("X-API-Key", "YOUR_API_KEY")
client := &http.Client{}
res, err := client.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
raw, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode)
fmt.Println(string(raw))
}
// GET https://api.avrinbai.cn/api/tools/phone-area
import okhttp3.*;
public class Demo {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
String payloadJson = {"number":"13888888888"};
HttpUrl.Builder urlBuilder = HttpUrl.parse("https://api.avrinbai.cn/api/tools/phone-area").newBuilder();
urlBuilder.addQueryParameter("number", "13888888888");
String url = urlBuilder.build().toString();
RequestBody body = null;
Request request = new Request.Builder()
.url(url)
.method("GET", body)
.addHeader("Accept", "application/json")
.addHeader("Content-Type", "application/json")
// .addHeader("X-API-Key", "YOUR_API_KEY")
.build();
try (Response response = client.newCall(request).execute()) {
System.out.println(response.code());
System.out.println(response.body() != null ? response.body().string() : "");
}
}
}
// GET https://api.avrinbai.cn/api/tools/phone-area
import okhttp3.*;
public class Demo {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
String payloadJson = {"number":"13888888888"};
HttpUrl.Builder urlBuilder = HttpUrl.parse("https://api.avrinbai.cn/api/tools/phone-area").newBuilder();
urlBuilder.addQueryParameter("payload", payloadJson);
String url = urlBuilder.build().toString();
RequestBody body = null;
Request request = new Request.Builder()
.url(url)
.method("GET", body)
.addHeader("Accept", "application/json")
.addHeader("Content-Type", "application/json")
// .addHeader("X-API-Key", "YOUR_API_KEY")
.build();
try (Response response = client.newCall(request).execute()) {
System.out.println(response.code());
System.out.println(response.body() != null ? response.body().string() : "");
}
}
}
// GET https://api.avrinbai.cn/api/tools/phone-area
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
var payloadJson = {"number":"13888888888"};
using var client = new HttpClient();
var query = string.Join("&", new[] { "number" + "=" + Uri.EscapeDataString("13888888888") });
var url = "https://api.avrinbai.cn/api/tools/phone-area" + "?" + query;
using var request = new HttpRequestMessage(new HttpMethod("GET"), url);
request.Headers.Add("Accept", "application/json");
// request.Headers.Add("X-API-Key", "YOUR_API_KEY");
// GET/HEAD 通常不发送 body。
using var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(body);
}
}
// GET https://api.avrinbai.cn/api/tools/phone-area
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
var payloadJson = {"number":"13888888888"};
using var client = new HttpClient();
var query = "payload=" + Uri.EscapeDataString(payloadJson);
var url = "https://api.avrinbai.cn/api/tools/phone-area" + "?" + query;
using var request = new HttpRequestMessage(new HttpMethod("GET"), url);
request.Headers.Add("Accept", "application/json");
// request.Headers.Add("X-API-Key", "YOUR_API_KEY");
// GET/HEAD 通常不发送 body。
using var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(body);
}
}
<?php
// GET https://api.avrinbai.cn/api/tools/phone-area
$payload = json_decode('{\"number\":\"13888888888\"}', true) ?: [];
// $apiKey = 'YOUR_API_KEY';
$ch = curl_init();
if (in_array('GET', ['GET', 'HEAD'], true)) {
$url = 'https://api.avrinbai.cn/api/tools/phone-area' . (count($payload) ? ('?' . http_build_query($payload)) : '');
} else {
$url = 'https://api.avrinbai.cn/api/tools/phone-area';
}
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => true,
CURLOPT_TIMEOUT => 25,
]);
$headers = [
'Accept: application/json',
];
// $headers[] = 'X-API-Key: ' . $apiKey;
if (! in_array('GET', ['GET', 'HEAD'], true)) {
$body = json_encode($payload, JSON_UNESCAPED_UNICODE);
$headers[] = 'Content-Type: application/json';
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
}
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$raw = curl_exec($ch);
if ($raw === false) {
throw new RuntimeException('cURL error: ' . curl_error($ch));
}
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$rawHeaders = substr($raw, 0, $headerSize);
$rawBody = substr($raw, $headerSize);
curl_close($ch);
echo "HTTP {$status}\n";
echo $rawHeaders . "\n";
echo $rawBody;
curl -sS -X GET \
"https://api.avrinbai.cn/api/tools/phone-area" \
--get \
--data-urlencode 'payload={"number":"13888888888"}'