Drop Ship Access Catalog API Documentation

Our API is a way for you to integrate our product catalog directly onto your website without the need to import data feeds. The advantage is that your website will always be current with the latest pricing and availability and any price markup adjustments you make will take effect immediately. You will need to have the ability to modify your website’s programming to make this work.

Overview

The catalog API has 3 parts to it: listing categories, listing products, and product details.

You will make 2 calls to our API for each page. One call to display the categories and one call to display the products in the category selected.

The output is JSON encoded, so after you decode it, the results are returned in multidimensional array.

Get an API access token

1. Create a Drop Ship Access account by going to www.dropshipaccess.com and filling out the form on the page. When you get to the payment page you can stop.

2. Send us an email and we will discuss your needs and set up payment arrangements.

3. We will activate your account and assign you an API token.

Configure product settings

1.Go to http://www.dropshipaccess.com/account_feed_settings.php

2. Configure your price markups and filters. Do not choose a format (it is only used for downloading files)

Listing Categories

Request URL: http://www.dropshipaccess.com/api/cats.php?key=XXXXXXXXXXXX&catid=0

Details: Replace the XXXXXXXXXX with your API token and the catid will be the selected category with 0 being the root.

Response:

{

"cpath":[],

"list":[

        {"id":"550","name":"Art"},

        {"id":"2984","name":"Baby"},

        {"id":"267","name":"Books"}

        }]

}

Details: The cpath will contain the category path to the current category listing (breadcrumbs). In this example it’s empty because we the request was for catid=0 which is the root category. The list will contain key:value pairs for the subcategories of the catid requested.

If a visitor clicked on the Books category then you would make a call with the 267 as the catid to list the subcategories of Books.

Listing Products

Request URL: http://www.dropshipaccess.com/api/items.php?key=XXXXXXXXXXXX&catid=625&start=0&count=100

Details: Replace the XXXXXXXXXX with your API token and the catid will be the selected category with 0 being the root. Start and count are used to control paging and the number of results you want per page.

Response:

[

{"id":"683307",

"model":"0060873167",

"upc":"0060873167",

"name":"Next (Harper Fiction)",

"qty":"2",

"price":7.2,

"price_prepay":6.99,

"cost_ship":5.18,

"manuf":"",

"thumb":"http:\/\/p2.ath.cx\/phpThumb\/phpThumb.php?src=\/images\/1051\/0060873167.jpg&w=150&h=150"},

{"id":"683314",

"model":"0060873493",

"upc":"0060873493",

"name":"Destination Moon (Smithsonian)",

"qty":"5",

"price":17.04,

"price_prepay":16.47,

"cost_ship":5.18,

"manuf":"",

"thumb":"http:\/\/p2.ath.cx\/phpThumb\/phpThumb.php?src=\/images\/1051\/0060873493.jpg&w=150&h=150"}

]

Details: The id is the unique identifier that you’ll need to make other API calls. If you need more details in this call, such as MSRP, do not make an additional call for each item, but instead contact us and let us know your needs.

Product Details

Request URL: http://www.dropshipaccess.com/api/item.php?key=XXXXXXXXXXXX&itemid=653660

Details: Replace the XXXXXXXXXX with your API token and the itemid is the id of the product.

Response:

[

{"id":"798315",

"model":"0415043298",

"upc":"0415043298",

"name":"Subpersonalities: The People Inside Us",

"qty":"3",

"price":34.56,

"price_prepay":33.4,

"cost":31.42,

"cost_prepay":30.36,

"cost_ship":5.18,

"msrp":37.95,

"map":0,

"weight":0.75,

"date_added":"2008-04-05 00:00:00",

"manuf":"",

"image":"http:\/\/p2.ath.cx\/images\/1051\/0415043298.jpg",

"thumb":"http:\/\/p2.ath.cx\/phpThumb\/phpThumb.php?src=\/images\/1051\/0415043298.jpg&w=150&h=150",

"description":"<ul><li><b>paperback:<\/b> 242 pages<\/li><li><b>publisher:<\/b> routledge; 1 edition (january 12, 1990)<\/li><li><b>language:<\/b> english<\/li><li><b>isbn-10:<\/b> 0415043298<\/li><li><b>isbn-13:<\/b> 978-0415043298<\/li>                                                                                                                                                                <li><b>product dimensions: <\/b>8.4 x 5.4 x 0.9 inches<\/li><li><b>shipping weight:<\/b> 12 ounces <\/li><\/ul>"}

]

Details: The description can contain html. The cost is the original price of the product before any markup has been applied and price is after your markup has been applied. The _prepay versions of each should  be used if you plan on pre-funding your Drop Ship Access account with a check. Map is the manufacturers minimum advertised price.