User Manual

Chapter 1: Using the REST API 19
Obtain Keywords with GetPopularKeywords
Version 3.7
by using an URL instead of XML and adding the necessary REST parameters (see “Basic REST Input
Parameters” on page 3):
https://ebay.custhelp.com/cgi-bin/ebay.cfg/php/enduser/std_adp.php?p_faqid=597
For a category, GetCategories returns the category name, its unique ID (within the site you specify),
and meta-data that helps you determine where the category fits in the category hierarchy.
Parameters for GetCategories are the same in the REST API as in the unified schema, except for the
basic REST input parameters. For the REST-specific input parameters, see “Basic REST Input
Parameters” on page 3. For more information about using GetCategories, including descriptions of
the call-specific input and output parameters, see the following document:
GetCategories
General information about the unified schema format is available at the following location:
http://developer.ebay.com/support/docs/
Obtain Keywords with GetPopularKeywords
Using GetPopularKeywords, you can obtain a list of keywords that users have frequently specified
when searching eBay. The list is regularly updated.
Optionally, you can specify a category ID for keywords relating to a specific category. Please note
that you cannot specify the
CategoryID parameter more than once per call.
To use the
CategoryID parameter to obtain frequently-used keywords, you could specify an URL
similar to the following:
http://rest.api.ebay.com/
restapi?CallName=GetPopularKeywords&RequestToken=UserToken&RequestUserId=UserName&Category
ID=20081&Version=491
The following sample shows how to obtain frequently-used keywords for a category and its
subcategories:
http://rest.api.ebay.com/
restapi?CallName=GetPopularKeywords&RequestToken=UserToken&RequestUserId=UserName&Category
ID=58058&IncludeChildCategories=true&Version=491
Parameters for GetPopularKeywords are the same in the REST API as in the unified schema, except
for the basic REST input parameters. For the REST-specific input parameters, see “Basic REST Input
Parameters” on page 3. For more information about using GetPopularKeywords, including
descriptions of the call-specific input and output parameters, see the following document:
GetPopularKeywords
General information about the unified schema format is available at the following location:
http://developer.ebay.com/support/docs/