Api reference

The following operation request are available through PWS.

Product data

CellularItemSearch Searches catalog of all cell phones currently sold within the United States using a variety of criteria
CellularItemAvailability Look up all phones currently sold in the U.S. Filter by manufacturer, carrier, and/or sale type
CellularItemLookup Look up a specific cell phone (including outdated or coming soon) using a PhoneDog CellularItemId
CellularItemExpertReviewsLookup Look up all in-depth expert reviews available for a specifici phone
CellularPlanSearch Searches catalog of all wireless calling plans currently available through providers in the United States
CellularPlanLookup Look up a specific wireless calling plan using a PhoneDog CellularPlanId

 

Making REST requests

REST allows you to make calls to PWS by passing parameter keys and values in a URL. PWS returns its reponse in XML format. To try it out simply enter the REST URL into the browser's address bar, and the browser will display the raw XML response.

The base URL
Every request to PWS begins with a base URL that must include some required parameters:

http://webservices.phonedog.com/xml.aspx?Operation=CellularItemSearch&AgentId=[your agentid here]&ApiKey=[your ApiKey here]

The parameters in the example above are:

Operation=CellularItemSearch
The Operation parameter is required in all PWS request. It tells PWS what action to perform. The CellularItemSearch operation in this example, tells PWS to search through the cell phones catalog using optional other criteria.

AgentId=[your agentid here]
Your agentid is a required parameter in all PWS requests. Along with your ApiKey it will authorize your use of PWS and all it's functionality. 

IMPORTANT! In order to properly track and assign commissions generated from sales you must append all clickthrough urls with your agent id using the following format: "&said=[your agentid here]" - Click here for more information 

ApiKey=[your apikey here]
Your apikey is a required parameter in all PWS requests. Along with your AgentId it will authorize your use of PWS and all it's functionality. You must be a registered PhoneDog affiliate to receive your Agentid and ApiKey before you can use PWS.