FAQ

When you need to make updates, using PATCH makes things easier because you can make a partial update instead of sending the entire payload. Let's say you need to update the price for your listing. You can just send the price update with PATCH in the payload instead of sending a PUT call with an entire payload.

 

When you make too many calls to a particular product line, you'll get a "too many requests" 429 error. The number of calls you can make per day depends on your plan. Check your plan for the call limits per product. In some cases, the limit is applied on an hourly basis, so for example, a limit of 500,000 calls/day becomes 21,000 calls/hour. If you think you're ready for an upgrade, submit an upgrade request by going to your Account section. Our governance team will review it and get back to you with a decision.

 

The access tokens you generate using the generateToken API are valid for 6 months. When they expire, you can use the refreshToken API to get a new access token. The refreshToken API requires a "refresh token" that was given to you in the original generateToken API call. If you don't have that refresh token, you should use the generateToken API to get a new access token.

Note: We recommend you use the refreshToken API to get new access tokens when they expire. You DO NOT need to generate a new access token before 6 months.

If you get a "resource forbidden" 403 error, it means you aren't subscribed to this API. You can edit your app to start subscribing to (or request to start subscribing to) the API.

Market Intel (Event Listings) API now returns the number of events you've used in the current calendar month. You'll find this response header in each API response: X-SH-Events-Limit-Used. The number of events counter resets at the beginning of the next calendar month. For example, if you subscribed to a 1000 events/month Market Intel rate plan, and X-SH-Events-Limit-Used is 750, it indicates that you can fetch data for 250 new events in the current calendar month.

If you just signed up for a new developer account, you can create an app by selecting one or more product lines. This will give you limited access to our APIs, so you can test & integrate them into your application. No approval is required.

Once you are satisfied with your integration and need higher call limits, you will need to submit an upgrade request. Our governance team will review it and get back to you with a decision. If you have any questions, please contact us.

All the APIs now return usage information to help you monitor your usage. You'll find these 3 response headers in each API response:
  1. X-SH-Quota-Limit. This is the call volume limit for this API (and other APIs in the product). The Products page shows you which product each API belongs to.
  2. X-SH-Quota-Limit-Used. This is the call volume you've used up for this API (and other APIs in the product).
  3. X-SH-Quota-Limit-Expiry. This is when the quota limit resets. For APIs that have a hourly quota, this will be the time represented by Unix timestamp (milliseconds from January 1, 1970 00:00:00 UTC). 
For example, if X-SH-Quota-Limit=500, X-SH-Quota-Limit-Used=100, X-SH-Quota-Limit-Expiry=1568505600000, it indicates that the call volume limit for the API is 500 calls, out of which 100 are used up, and the limit resets at 12am on 9/15/2019 (UTC)

Each of our APIs falls under a product line: Event Catalog, Inventory Management, Order Management, Sales Management, or Market Intel. You can review our APIs to learn more about what they offer. After you create your StubHub developer account and subscribe to our APIs, you can play around with the APIs to see how they work and figure out what you need.