Index » Search Phone Numbers


Search Phone Numbers

Usage
Authorization
Query parameters
Examples


Description

Use this method to perform the search of phone numbers.
The endpoint provides you with rich browsing & searching functionality, for example you're able with this endpoint:
- to browse phone numbers (including vanity numbers) in selected US state
- to search vanity number by pattern
- to get all phone numbers matching custom smart pattern (like X0Y0)
- to search vanity phone numbers by industry
- to search by price range
- to use sorting & paging in the search results
- and much more:)



Usage

GET https://api.phonenumberexpert.net/numbers?query_parameters (see available query parameters below)


Authorization

Basic Authentication: username (Account Name) and password (API Key) can be obtained from PNE owner, please contact him at https://www.phonenumberexpert.com/contacts/


Query parameters



Please bear in mind, any request is limited by 10,000 records.


Examples

1. Get first 3 repeaters:
    https://api.phonenumberexpert.net/numbers?vip=X000000&size=3 (see response)

2. Get next 3 repeaters:
    https://api.phonenumberexpert.net/numbers?vip=X000000&size=3&from=4 (see response)

3. Show first 20 numbers, starting with "MAX" and ending with four same digits, in Texas, with area code 469, from $500 (inclusive):
    https://api.phonenumberexpert.net/numbers?size=20&q=MAX&vip=XXXX&sc=TX&ac=469&min=500 (see response)

4. Show 5 vanity numbers from Jersey City:
    https://api.phonenumberexpert.net/numbers?sc=NJ&rc=Jersey%20City&x=vanity&size=5 (see response)

5. Show 3 featured numbers:
    https://api.phonenumberexpert.net/numbers?size=3&x=feat (see response)


Response contains success flag, total count of filtered numbers (before paging by "from" and "size" parameters), paging (from/to), records array.
Each record contains the following fields:
    "n" - Display Name of the number. Can contain vanity words.
    "d" - 10-digits phone number. Just 10 digits in a row without spaces, dashes, letters or any other characters.
    "c" - Country Code ("US", "CA"; also we use "IS" for islands, including Puerto Rico)
    "s" - State Code
    "r" - City
    "p" - either Price (number), or string "CALL" when no price defined (means "Call for pricing")
    "po" - old price (might be displayed as crossed out)
    "abd" - activation business days, how long it takes to activate the number
    "note" - optional note


Result of the first query can be similar to the following:
{
  "success": true,
  "totalCount": 245,
  "from": 1,
  "to": 3,
  "records": [
    { "n": "(224) 400-0000", "d": "2244000000", "c": "US", "s": "IL", "r": "Arlington Heights", "p":"CALL" },
    { "n": "(248) 600-0000", "d": "2486000000", "c": "US", "s": "MI", "r": "Pontiac", "p": "CALL" },
    { "n": "(248) 900-0000", "d": "2489000000", "c": "US", "s": "MI", "r": "Ortonville", "p": "CALL" }
  ]
 }


Result of the second query looks similar to the following:
{
  "success": true,
  "totalCount": 245,
  "from": 4,
  "to": 6,
  "records": [
    { "n": "(260) 300-0000", "d": "2603000000", "c": "US", "s": "IN", "r": "Woodburn", "p": "CALL" },
    { "n": "(332) 300-0000", "d": "3323000000", "c": "US", "s": "NY", "p": "CALL" },
    { "n": "(332) 500-0000", "d": "3325000000", "c": "US", "s": "NY", "p": "CALL" }
  ]
 }


Result of the third query can be similar to the following:
{
  "success": true,
  "totalCount": 1,
  "from": 1,
  "to": 1,
  "records": [
    { "n": "(469) MAX-9999", "d": "4696299999", "c": "US", "s": "TX", "r": "Dallas Fort Worth Airport", "p": 799 },
    { "n": "(469) MAX-2222", "d": "4696292222", "c": "US", "s": "TX", "r": "Dallas Fort Worth Airport", "p": 1299.99 },
  ]
 }


Result of the fourth query (vanity Miami numbers) can be similar to the following:
{
  "success": true,
  "totalCount": 330,
  "from": 1,
  "to": 5,
  "records":  [
    { "n": "(201) 918-HIGH", "d": "2019184444", "c": "US", "s": "NJ", "r": "Jersey City", "p": 399.99 },
    { "n": "(201) 984-4444", "d": "2019844444", "c": "US", "s": "NJ", "r": "Jersey City", "p": 699.99 },
    { "n": "(201) 2041-BUT", "d": "2012041288", "c": "US", "s": "NJ", "r": "Jersey City", "p": 249.99 },
    { "n": "(201) 2041-MYR", "d": "2012041697", "c": "US", "s": "NJ", "r": "Jersey City", "p": 199.99 },
    { "n": "(201) 2041-OZU", "d": "2012041698", "c": "US", "s": "NJ", "r": "Jersey City", "p": 199.99 }
  ]
}


Result of the fifth query (featured vanity numbers) can be similar to the following:
{
  "success": true,
  "totalCount": 56,
  "from": 1,
  "to": 3,
  "records":  [
    {"n": "(212) 222-2221", "d": "2122222221", "c": "US", "s": "NY", "r": "New York City Zone 01", "x": ["feat"] },
    {"n": "(212) 344-4444", "d": "2123444444", "c": "US", "s": "NY", "r": "New York City Zone 01", "p": 29999, "x": ["feat"] },
    {"n": "(310) 928-2437", "d": "3109282437", "c": "US", "s": "CA", "r": "Compton:  Compton DA", "p": 49999, "x": ["feat"] }
  ]
 }