Free mobile phone number attribution API interface to query mobile phone number attribution information

Phone number attribution interface: According to the phone number or the first 7 digits of the phone number, query the phone number attribution information, including province, city, area code, zip code, operator and card type.

Interface documentation: https://www.juhe.cn/docs/api/id/11

If you want to use it, you need to apply for APPKEY first, pass the review, and then you can use it for free unlimited times.

1.API

Interface address: http://apis.juhe.cn/mobile/get

Supported formats: json/xml

Request method: get

Request example: http://apis.juhe.cn/mobile/get?phone=13429667914&key=the KEY you applied for

Call samples and debugging tools: API testing tools

Request parameter description: Name type required description

	phone	int	Yes	The mobile phone number to be queried or the first 7 digits of the mobile phone number
	key	string	Yes	Application APPKEY (application detail page query)
	dtype	string	no	The format of the returned data, xml or json, default json

Return parameter description: Name type description

	error_code	int	return code
	reason	string	Back to Instructions
	result	string	return result set
	province	string	province
	city	string	City
	areacode	string	area code
	zip	string	post code
	company	string	operator
	card	string	card type

JSON return example:

{
"resultcode":"200",
"reason":"Return Successd!",
"result":{
    "province":"浙江",
    "city":"杭州",
    "areacode":"0571",
    "zip":"310000",
    "company":"China Mobile",
    "card":"Mobile M-Zone Card"
}
}

 

XML return example:

  <?xml version="1.0" encoding="utf-8" ?>
- <root>
      <resultcode>200</resultcode>
      <reason>Return Successd!</reason>
    - <result>
          <province>浙江</province>
          <city>Hangzhou</city>
          <areacode>0571</areacode>
          <zip>310000</zip>
          <company>China Mobile</company>
          <card>Mobile M-Zone Card</card>
      </result>
  </root>

 

2. Error code reference

Service-level error code reference (error_code): Error code description

	201101	Phone number can not be blank
	201102	wrong mobile number
	201103	query with no results

System-level error code reference: Error code description old version (resultcode)

	10001	Bad request KEY	101
	10002	The KEY does not request permission	102
	10003	KEY expired	103
	10004	wrong OPENID	104
	10005	The application has not been reviewed and timed out, please submit the certification	105
	10007	Unknown request source	107
	10008	Banned IPs	108
	10009	Forbidden KEY	109
	10011	The current IP request exceeds the limit	111
	10012	Request exceeds limit	112
	10013	Test KEY exceeds request limit	113
	10014	Internal abnormality of the system (when calling recharge services, please be sure to contact customer service or check the order through the order query interface to avoid losses)	114
	10020	interface maintenance	120
	10021	interface disabled	121

Error code format description (example: 200201): 2 002 01

	Service level error (1 is system level error)	Service Module Code (i.e. Data ID)	specific error code

3. Code example

 PHP: mobile phone number attribution query

Python: Example of calling the interface of mobile phone number attribution

C#: Example of calling the mobile phone number attribution interface

Go: Example of calling the API of the mobile phone number attribution

JAVA: Example of calling the mobile phone number attribution interface