POSTPublicmobile-area

Phone Number Location Lookup

Provides phone number location lookup services to quickly retrieve detailed information such as state/province, city, and carrier. Ideal for targeted marketing and risk management.

Documentation

Features

This API provides an efficient and accurate phone number location lookup service. Users simply enter a phone number to quickly retrieve its associated province/state, city, area code, zip code, and carrier information (e.g., Mobile, Unicom, Telecom). Data is updated in real-time to ensure the accuracy and timeliness of the results.

Use Cases

E-commerce & Marketing: Identify user regions for targeted marketing and product recommendations.
Risk Management & Anti-Fraud: Verify phone number locations during user registration or transactions to support risk assessment.
Logistics & Delivery: Optimize delivery routes to improve logistics efficiency.
User Profiling: Enrich user data for deeper behavioral analysis.
Number Scrubbing: Batch process phone number data to filter out invalid or abnormal numbers.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "mobile_number": "13800138000"
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "province": "北京",
    "city": "北京",
    "operator": "中国移动",
    "areaCode": "010",
    "postCode": "100000"
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
mobile_number	string	13800138000

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	SUCCESS
message	string	success
data	object	{...}
data.province	string	北京
data.city	string	北京
data.operator	string	中国移动
data.areaCode	string	010

curl --request POST \ --url 'https://openapi.toolkk.com/v1/mobile-area' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "mobile_number": "13800138000"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/mobile-area" payload = { "mobile_number": "13800138000" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/mobile-area" payload := []byte("{\n \"mobile_number\": \"13800138000\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"mobile_number\": \"13800138000\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/mobile-area")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/mobile-area'; $payload = "{\n \"mobile_number\": \"13800138000\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

Phone Number Location Lookup

Documentation

Features

Use Cases

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online