Ticket Listings

This section provides some tips on listing in event ticket categories. This information is mostly relevant to applications that list items.

Note: If you want to search for ticket listings, use the Finding API and use aspect filters to refine your search.)

Basic Ticket Listing Requirements

Listing Tickets with Product Details

Filling in All Ticket Item Specifics Manually

Basic Ticket Listing Requirements

Here are the basic requirements for listing tickets on the eBay US and Canada sites:

On the US and CA sites, tickets are listed the Sports, Concerts, Theater, and Other categories. Call GetCategories to determine the category IDs.

Listing Tickets with Product Details

eBay offers a tickets catalog that provides stock information, including a venue map, for most tickets available in the eBay US and Canada marketplaces.

Allow eBay to Find and Add Ticket Details from the Catalog For You

Find Ticket Details by Searching the Catalog Yourself

Allow eBay to Find and Add Ticket Details from the Catalog For You

The easiest way to list a ticket is to specify the event title, venue, date, and time in ProductListingDetails.TicketListingDetails in AddItem.

This approach is useful when you do not want to first search the ticket catalog to determine the product ID for a stock product. This approach helps sellers list tickets quickly, and it requires fewer API calls than the search-to-sell flow (i.e., finding ticket details by searching the catalog).

For ticket listings, the catalog-enabled event tickets category must be the primary category.

When you list a ticket in this manner, eBay searches the ticket catalog and (assuming a unique match is found) pre-fills certain Item Specifics and other data based on the catalog data. If a single matching product is found, eBay lists the item with that product's details, including a stock venue map (if available) and other stock information. The stock venue map will be used as the listing's picture and Gallery image. Typically, the venue map shows the venue's seating chart relative to the stage, screen, or field.

If no matches are found, the call returns an error and the item is not listed. If this occurs, use one of these approaches to correct the problem:

If more than one match is found, the call returns an error (indicating that too many products were found) and a list of product IDs for the products that matched the keywords you passed in. If this occurs, try using more keywords (such as the event time, if you did not specify it), or search for a specific EPID (see Find Ticket Details by Searching the Catalog Yourself).

If you pass in an old product ID (instead of ticket keywords) and only one match is found, eBay will list the item with the latest version of the product and the latest product ID, and the call will return a warning indicating that the data has changed.

If you pre-fill most Item Specifics from the ticket catalog, you need to also pass in custom item specifics that provide the Venue State/Province and Number of Tickets. Other required item specifics will be pre-filled from the catalog.

It is also a good idea to pass optional Item Specifics that are not in the catalog (such as the section and row), to help buyers more quickly discern which ticket they are purchasing.

Call GetCategorySpecifics for a list of the custom Item Specifics that are supported and required in the category you're listing in.

Find Ticket Details by Searching the Catalog Yourself

If the seller wants to search for and preview event details in the catalog before including them in a listing, you can search for the event, view matching products, select one, and pass its eBay product ID (EPID) in ProductListingDetails in AddItem.

This approach involves more steps than using TicketListingDetails (described above), but it enables previewing an event before including it in your listing. It also may serve as a workaround if eBay can't find a matching product when you use TicketListingDetails.

Use FindProducts in the Shopping API (see the FindProducts documentation). Pass keywords describing the ticket in QueryKeywords, and then choose a product from the results. Pass the product ID you found in ProductListingDetails.ProductReferenceID in AddItem.

As stated in the prior section, if you pre-fill most Item Specifics from the ticket catalog, you need to also pass in custom item specifics that provide the Venue State/Province and Number of Tickets. Other required item specifics will be pre-filled from the catalog.

It is also a good idea to pass optional Item Specifics that are not in the catalog (such as the section and row), to help buyers more quickly discern which ticket they are purchasing.

Call GetCategorySpecifics for a list of the custom Item Specifics that are supported and required in the category you're listing in..

Filling in All Ticket Item Specifics Manually

If there is no product available that matches your ticket, use item specifics to specify the details.

Ticket listings have certain required Item Specifics. It is also a good idea to pass optional Item Specifics that are not in the catalog (such as the section and row).

Call GetCategorySpecifics for a list of the custom Item Specifics that are supported and required in the category you're listing in.

For example, you must manually include item specifics for "Number of Tickets" and "Venue State/Province" yourself (because they're required). In addition, we strongly recommend that you specify "Event Date" when you fill in your own item specifics. Use the listing title for the event name.

Regardless of whether you pre-fill required item specifics based on a catalog product or fill them in yourself, we also strongly recommend that you always add the optional "Section" and "Row" item specifics. Most ticket buyers filter and sort tickets based on these item specifics. This means listings that are missing these item specifics typically appear after all other listings in search results. Also, eBay's venue map functionality leverages the Section item specific that the seller specifies.

GetCategoryFeatures and GetCategorySpecifics return details about custom item specifics for tickets. For example:

Copyright © 2005–2016 eBay Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.