Embed Size (px)
Citation preview
Commerce Life Cycle
Inspiration
Investigation
Research
SearchTransaction
Use
End of Life
eBay Inc. Commerce Offerings
Payments PayPal & Zong & Card.io
Marketplace eBay
Code Scanning RedLaser
Local Inventory Milo
Location Based Offers Where
Storefront Magento
Recommendations Hunch
Identity PayPal Access
Classifieds eBay Classifieds
MILO OPEN API
What is Milo’s Open API?
• Millions of products from 50,000+ stores
• Real time information
• API allows both mobile and web developers
HOW TO GET STARTED?
STEP 1: GET YOUR API KEY
Go to: https://devportal.x.com
You will need API KEY for every query
STEP 2: VERIFY YOUR API KEY
https://api.x.com/milo/v3/products?key=YOUR-API-KEY
You should see a JSON responseYour API key will limit your use of the Milo API to 5000 queries per hour
STEP 3: PICK YOUR ENDPOINTThere are 3 endpoints:• Store Addresses Endpoint (Merchant
Locations)• Products Endpoint (Product Info and
Search)• Availability Endpoint
Store_address Endpoint
The request endpoint and search query
• https://api.x.com/milo/v3/store_addresses?key=YOUR-API-KEY• https://api.x.com/milo/v3/store_addresses?key=YOUR-API-KEY&show=LocHours• https://api.x.com/milo/v3/store_addresses?key=YOUR-API-KEY&show_defaults=false&
show=PhoneSCRP• https://api.x.com/milo/v3/store_addresses?key=YOUR-API-KEY&show_defaults=false&
show=PhoneSCRP&postal_code=94301&radius=5
The response object has one key (store_addresses) whose value is a list of stores
Store_address Endpoint: Example
The request endpoint and search query
https://api.x.com/milo/v3/store_addresses?key=d67e6ca8aae824cf09e3ea97112117f2&postal_code=94301&radius=5
The response object has one key (store_addresses) whose value is a list of stores
{"store_addresses": [{"phone": "6503261899", "street": "855 El Camino Real #120", "postal_code": "94301", "city": "Palo Alto", "region": "CA", "merchant_name": "Honeys and Heroes"}, {"phone": "6503261899", "street": "855 El Camino Real #120", "postal_code": "94301", "city": "Palo Alto", "region": "CA", "merchant_name": "Honeys and Heroes"}, {"phone": "6503211850", "street": "396 University Avenue", "postal_code": "94301", "city": "Palo Alto", "region": "CA", "merchant_name": "Chico's"}, {"phone": "6509493378", "street": "303 2nd St", "postal_code": "94022", "city": "Los Altos", "region": "CA", "merchant_name": "Walgreens"}……………………………….……………………………….………………………………]}
product Endpoint
The request endpoint and search query
https://api.x.com/milo/v3/product?key=YOUR-API-KEY https://api.x.com/milo/v3/products?key=YOUR-API-KEY&postal_code=94301&show_def
aults=false&show=PidPnameMidsPminPmaxDescPurlImg200Rate
https://api.x.com/milo/v3/products?key=YOUR-API-KEY&postal_code=94301&show_defaults=false&show=PidPnameMidsPminPmaxDescPurlImg200Rate&min_price=10000&q=ipad
The response object has one key (products) whose value is a list of products
product Endpoint: Example
The request endpoint and search query
https://api.x.com/milo/v3/products?key=d67e6ca8aae824cf09e3ea97112117f2&postal_code=94301&show_defaults=false&show=PidPnameMidsPminPmaxDescPurlImg200Rate
The response object has one key (products) whose value is a list of products
{"products": [{"product_url": "http://milo.com/product/9459564", "average_rating": null, "merchants": [4483], "min_price": null, "name": "MOEN Rothbury Moentrol Vertical Spa in Oil Rubbed Bronze", "description": "<div><p>The Rothbury(TM) line offers a relaxed blend of vintage design and traditional elements that coordinates perfectly with both casual and luxurious decorating styles. This oil rubbed bronze moentrol(r) vertical spa was built to last by Moen.</p> <ul class=\"osh_bulleted-list\"><li>Oil rubbed bronze finish delivers a rich, dark brown, old world finish with striking light and dark accents</li> <li>Lever design for ease of use</li> <li>Moentrol(r) pressure-balancing valves deliver perfect water coverage, force and flow and have temperature memory to prevent hot and cold surges.</li> <li>Four body sprays</li> <li>MFG Brand Name : MOEN</li> <li>MFG Model # : TS203ORB</li> <li>MFG Part # : TS203ORB</li> </ul></div>", "max_price": null, "image_200": "http://imagethumbnails.milo.com/010/894/955/200/10894107_14446955_200.jpg", "product_id": 9459564},………………….………………….]}
Availability Endpoint
The request endpoint and search query
https://api.x.com/milo/v3/availability?key=YOUR-API-KEY&product_id=YOUR-CHOSEN-PRODUCT-ID&postal_code=94301
The response object has a number of newline-separated JSON objects First one will be a merchant Second will be a store owned by that merchant Third will tell you if the product is available at that store
Availability Endpoint: Example
The request endpoint and search query
https://api.x.com/milo/v3/availability?key=d67e6ca8aae824cf09e3ea97112117f2&product_id=24484795&postal_code=94301
The response has a number of newline-separated JSON objects
{"merchant": {"image_url": "http://static.milo.com/20120306232853/images/store_icons/flat_by_id/13980.png", "name": "Bloomingdale's", "id": 13980}} {"location": {"city": "San Francisco", "descriptor": "Bloomingdale's", "region": "CA", "longitude": -122.406176, "formatted_hours": {"Wed": [["10:00", "21:00"]], "Sun": [["11:00", "20:00"]], "Fri": [["10:00", "21:00"]], "Tue": [["10:00", "21:00"]], "Mon": [["10:00", "21:00"]], "Thu": [["10:00", "21:00"]], "Sat": [["10:00", "21:00"]]}, "phone": "4158565300", "street": "845 Market Street", "latitude": 37.784219, "merchant_id": 13980, "id": 350159, "zip_code": "94103"}} {"result": {"product_id": 24484795, "attributes": {}, "price": 15250, "merchant_id": 13980, "location_id": 350159, "availability": "in_stock", "as_of": 1342846580.6739609}} {"location": {"city": "Palo Alto", "descriptor": "Bloomingdale's", "region": "CA", "longitude": -122.1702123, "formatted_hours": {"Wed": [], "Sun": [["12:00", "19:00"]], "Fri": [["10:00", "21:00"]], "Tue": [], "Mon": [], "Thu": [["10:00", "21:00"]], "Sat": [["10:00", "20:00"]]}, "phone": "6504632000", "street": "1 Stanford Shopping Center", "latitude": 37.4428962, "merchant_id": 13980, "id": 350167, "zip_code": "94304"}} {"result": {"product_id": 24484795, "attributes": {}, "price": 15250, "merchant_id": 13980, "location_id": 350167, "availability": "out_of_stock", "as_of": 1342846580.6754379}}
