Guides

The Guides take an in-depth look at a variety of development tasks, such as Getting Started, how to create a login session, and how to form and send an API call. Before you start using the StubHub API, you should become familiar with the material in these guides.

Getting Started

Step 1: Create a StubHub account

Before you can use the StubHub APIs, you have to have a StubHub account. If you already have an account that you use as a StubHub customer, that will work just fine...there's no need to create an additional account as a developer.

Step 2: Register your application

The first thing you do as a developer is come up with a name for your application and register it with StubHub. You don't have to have any code for your app, yet, or even any information about what it will do--you just need to tell StubHub what it will be called.

To register your app, follow the Register your application link above, type your app's name in the Application name field, and click Add. If the registration was successful, you'll see an "Application <yourNameHere> was successfully added!" message.

Step 3: Subscribe to the API

After you've registered your app, you need to subscribe to the APIs that you're going to use. Here's what you'll do:

  1. Click the Subscribe to the API link. This will take you to the APIs page.
  2. Along the left side of the page you'll see a list of categories that contain links to the StubHub APIs. The first selection is All APIs. Pull down the Applications list and select your app's name, then click Subscribe to All.
  3. When the dialog message appears, click Go to Manage API Access.

Step 4: Generate your access keys

Next, you'll generate your app's access keys, tokens that you need to include in your HTTP requests so StubHub can recognize your app. To generate the keys, simply follow the link above to the Manage API Access page and click the Generate button for the Sandbox environment.

After the page refreshes, you'll see three keys: Application Token, Consumer Key, and Consumer Secret. Make a note of these keys, you're going to need them later when you test your app in the sandbox. How you use them is explained in the StubHub API Developers Guide. When you're ready to deploy your app, you'll return to Manage API Access and generate the keys that you need to access the StubHub production environment.

You'll also see an Allow Domains field which will be set to ALL. Leave it alone for now.

Step 5: Build your app

Now comes the fun part: actually building and deploying your application, and seeing it in action. To begin coding, you'll need an explanation of how to form your HTTP requests, and detailed descriptions of the API interfaces.

First, you should read through the StubHub API Developers Guide. It will explain how to use your access keys in your HTTP requests.

You'll also need to become familiar with the StubHub API Reference Technical Documentation, which lists and describes all of the StubHub APIs.