This projec is to
- Show historical sale price for watch items so we can get overall sold price historgram that can help us to place a resonable bid.
- Auto bid (may called sniper technique)
- Study Ebay API for get sold information
- Study Ebay API to bid by program
- Nice to have: Mobile App to show item sold historgram and auto bid functionality
- Home page: https://developer.ebay.com
- Tutorial: https://developer.ebay.com/tools/quick-start
- Visit Application Keys web page: https://developer.ebay.com/my/keys
- Click Crate a Keyset in Production keyset section if none exists
- In Production Toker section, click User Tokens in App ID section
- Click Get OAtuh Application Token
- Then make http request by using application token:
HTTP component | value |
---|---|
method | GET |
URL (Production) | https://api.ebay.com/buy/browse/v1/item_summary/search?category_ids=108765&q=Beatles&filter=price:[200..500]&filter=priceCurrency:USD&limit=10 |
headers | Authorization: Bearer <Application-token-value> |
Has two kinds of flow to get token
- Client credentials grant - If call API with read-only resources
- Authorization code grant - If call API related to user data
API signature:
HTTP method: POST
URL (Sandbox): https://api.sandbox.ebay.com/identity/v1/oauth2/token
URL (Production): https://api.ebay.com/identity/v1/oauth2/token
HTTP headers:
Content-Type = application/x-www-form-urlencoded
Authorization = Basic <B64 encoded of client_id:client_secret>
Request body:
grant_type=client_credentials&scope=https://api.ebay.com/oauth/api_scope%20https://api.ebay.com/oauth/api_scope/buy.guest.order
* scope can be a list of API scopes combined by %20
API scopes examples
https://api.ebay.com/oauth/api_scope
https://api.ebay.com/oauth/api_scope/buy.guest.order
https://api.ebay.com/oauth/api_scope/buy.item.feedS
https://api.ebay.com/oauth/api_scope/buy.marketing
Category ID | Category Name |
---|---|
215 | Football Cards |
213 | Baseball Cards |
214 | Basketball Cards |
212 | (Sports Trading Cards) |
-
Find sold items for 2018 panini contenders football for the past 3 months with catelog = football trading cards
-
Find 10 listed items for cody bellinger
GET https://api.ebay.com/buy/browse/v1/item_summary/search?q=cody%20bellingers&limit=10
Authorization: Bearer <token>
# example
jq '.itemSummaries[]| {title: .title, buyingOptions:.buyingOptions}'
# find title and list type from finding API response
jq '.findCompletedItemsResponse[0].searchResult[0].item[]| {title: .title, buyingOptions:.listingInfo[0].listingType}'
aspectName | aspectValueName |
---|---|
Player | Not Specified |
Product | Box |
Query example |
GET http://svcs.ebay.com/services/search/FindingService/v1
?OPERATION-NAME=findCompletedItems
&SERVICE-VERSION=1.7.0
&SECURITY-APPNAME=<Cient ID>
&RESPONSE-DATA-FORMAT=JSON
&REST-PAYLOAD
&keywords=hobby%20box%20-break
&categoryId=212
&itemFilter(0).name=SoldItemsOnly
&itemFilter(0).value=true
&itemFilter(1).name=EndTimeFrom
&itemFilter(1).value=2019-04-01T00:00:00.000Z
&itemFilter(2).name=EndTimeTo
&itemFilter(2).value=2019-04-02T00:00:00.000Z
&sortOrder=EndTimeSoonest
&paginationInput.pageNumber=1
&aspectFilter(0).aspectName=Product
&aspectFilter(0).aspectValueName=Box
Authorization: Bearer <accessToken>
Environment | URL |
---|---|
Sandbox | https://api.ebay.com |
Production | https://api.sandbox.ebay.com |
Environment | URL |
---|---|
Sandbox | http://svcs.sandbox.ebay.com/services/search/FindingService/v1 |
Production | http://svcs.ebay.com/services/search/FindingService/v1 |
Environment | URL |
---|---|
Sandbox | https://sandbox.ebay.com |
Production | https://ebay.com |