eBay Shopping API935

FindPopularSearches


Important:

   This call is deprecated as of November 2014 and there is no direct replacement.

   If you're building an application and want to incorporate item or product recommendations based on categories or keywords, start with the Finding API or the Merchandising API.

   If you have applications that use this call, please migrate your popular search functions to the Finding API or the Merchandising API.



Input

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<FindPopularSearchesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- (No call-specific Input fields) -->

  <!-- Standard Input Fields -->
  <MessageID> string </MessageID>
</FindPopularSearchesRequest>
Argument Type Occurrence Meaning
(No call-specific fields)
Standard Input Fields  
MessageID string Optional If you pass a value in MessageID in a request, we'll return the same value in CorrelationID in the response. If you're making a lot of calls, you can use this for tracking that a response is returned for every request and to match particular responses to particular requests. (In this case, specify a different value for each request.) You can specify any value that is useful to you.



Output

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<FindPopularSearchesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- (No call-specific Output fields) -->

  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</FindPopularSearchesResponse>
Return Value Type Occurrence Meaning
(No call-specific fields)
Standard Output Fields  
Ack AckCodeType Always Indicates whether the call was successfully processed by eBay.

Applicable values:

CustomCode
(out) Reserved for internal or future use.
Failure
(out) Request processing failed
Success
(out) Request processing succeeded
Warning
(out) Request processing completed with warning information being included in the response message

(Not all values in AckCodeType apply to this field.)
Build string Always This refers to the particular software build that eBay used when processing the request and generating the response. This includes the version number plus additional information. eBay Developer Support may request the build information when helping you resolve technical issues.
CorrelationID string Conditionally If you pass a value in MessageID in a request, we will return the same value in CorrelationID in the response. You can use this for tracking that a response is returned for every request and to match particular responses to particular requests. Only returned if MessageID was used.
Errors ErrorType Conditionally,
repeatable: [0..*]
A list of application-level errors or warnings (if any) that were raised when eBay processed the request.

Application-level errors occur due to problems with business-level data on the client side or on the eBay server side. For example, an error would occur if the request contains an invalid combination of fields, or it is missing a required field, or the value of the field is not recognized. An error could also occur if eBay encountered a problem in our internal business logic while processing the request.

Only returned if there were warnings or errors.
Errors.ErrorClassification ErrorClassificationCodeType Conditionally API errors are divided between two classes: system errors and request errors.

Applicable values:

CustomCode
(out) Reserved for internal or future use.
RequestError
(out) An error has occurred either as a result of a problem in the sending application or because the application's end-user has attempted to submit invalid data (or missing data). In these cases, do not retry the request. The problem must be corrected before the request can be made again. If the problem is due to something in the application (such as a missing required field), the application must be changed. If the problem is a result of end-user data, the application must alert the end-user to the problem and provide the means for the end-user to correct the data. Once the problem in the application or data is resolved, resend the request to eBay with the corrected data.
SystemError
(out) Indicates that an error has occurred on the eBay system side, such as a database or server down. An application can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form.

See Errors by Number.

Errors.ErrorCode token Conditionally A unique code that identifies the particular error condition that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms.

See Errors by Number.

Errors.ErrorParameters ErrorParameterType Conditionally,
repeatable: [0..*]
Some warning and error messages return one or more variables that contain contextual information about the error. This is often the field or value that triggered the error. You can usually predict where these will occur by looking at the "replaceable_value" indicators in our Errors by Number page.

See Errors by Number.

Errors.ErrorParameters
  [ attribute ParamID ]
string Conditionally Some warning and error messages return one or more variables that contain contextual information about the error. This is often the field or value that triggered the error. You can usually predict where these will occur by looking at the "replaceable_value" indicators in our Errors by Number page.
Errors.ErrorParameters.Value string Conditionally The value of the variable.
Errors.LongMessage string Conditionally A more detailed description of the condition that raised the error.

See Errors by Number.

Errors.SeverityCode SeverityCodeType Conditionally Indicates whether the error caused the request to fail.

If the request fails and the source of the problem is within the application (such as a missing required element), please change the application before you retry the request. If the problem is due to end-user input data, please alert the end-user to the problem and provide the means for them to correct the data. Once the problem in the application or data is resolved, you can attempt to re-send the request to eBay.

If the source of the problem is on eBay's side, you can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form.

When a warning occurs, the error is returned in addition to the business data. In this case, you do not need to retry the request (as the original request was successful). However, depending on the cause or nature of the warning, you might need to contact either the end user or eBay to effect a long term solution to the problem to prevent it from reoccurring in the future.

Applicable values:

CustomCode
(out) Reserved for internal or future use
Error
(out) The request that triggered the error was not processed successfully. When a serious application-level error occurs, the error is returned instead of the business data.
Warning
(out) The request was processed successfully, but something occurred that may affect your application or the user. For example, eBay may have changed a value the user sent in. In this case, eBay returns a normal, successful response and also returns the warning.

See:
    Errors by Number
    Checklist for Going Live for more information see the eBay Features Guide.

Errors.ShortMessage string Conditionally A brief description of the condition that raised the error.

See Errors by Number.

Timestamp dateTime Always This value represents the date and time when eBay processed the request. The time zone of this value is GMT and the format is the ISO 8601 date and time format (YYYY-MM-DDTHH:MM:SS.SSSZ). See the "dateTime" type for information about this time format and converting to and from the GMT time zone.
Version string Always The release version that eBay used to process the request.

Note: This is usually the latest release version, as specified in the release notes. (eBay releases the API to international sites about a week after we release it to the US site.)

If a field in the response returns the token "CustomCode", it usually means that the field is a code type (a token or enumeration), and that in your request URL (or HTTP header) you specified a version that is older than the version in which the token was added to the call.

See Schema Versioning Strategy.



Detail Controls


DetailLevel

This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request.

Samples

New to making API calls? Please see Making an API Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Available samples:

Sample: Basic Call

Retrieves alternate keywords and related searches associated with a keyword that you specify.

Input

This example uses a keyword to obtain an alternate set of keywords and a set of related seraches that you can use to expand your search range on a given topic.

URL format. See also the non-wrapped version of this URL. For results in a format other than XML, 
specify a different value for responseencoding.
http://open.api.ebay.com/shopping?
   callname=FindPopularSearches&
   responseencoding=XML&
   appid=YourAppIDHere&
   siteid=0&
   version=531&
   QueryKeywords=dell

   Here is the same input in XML format. Note that this does not include standard values.

XML format. Also available is the .txt version of this XML.

<?xml version="1.0" encoding="utf-8"?>
<FindPopularSearchesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <QueryKeywords>dell</QueryKeywords>
</FindPopularSearchesRequest>

Output

XML format.
<?xml version="1.0" encoding="UTF-8" ?> 
<FindPopularSearchesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2007-09-12T23:47:01.000Z</Timestamp> 
  <Ack>Success</Ack> 
  <Build>e531_intl_APILW2_5315915_R1</Build> 
  <Version>531</Version> 
  <PopularSearchResult>
    <QueryKeywords>dell</QueryKeywords> 
    <AlternativeSearches>latitude;inspiron;dimension;alienware;lcd;toshiba</AlternativeSearches> 
    <RelatedSearches>dell laptop;dell dimension;dell computer;dell desktop;dell notebook;dell pc;dell 4700;dell axim;dell monitor;dell inspiron;dell pda</RelatedSearches> 
  </PopularSearchResult>
</FindPopularSearchesResponse>

Back to list of samples

Sample: Searching for Popular Items in a Specific Category

Retrieves an alternate set of keywords and related search values that are associated with a keyword and a Category ID that you specify.

Input

This example uses a keyword and a CategoryID to find alternate sets of keywords and search phrases for your queries. The request restricts the keyword query for "dell" to the following categories: Computers & Networking, and PC Laptops & Notebooks.

URL format. See also the non-wrapped version of this URL. For results in a format other than XML, 
specify a different value for responseencoding.
http://open.api.ebay.com/shopping?
   callname=FindPopularSearches&
   responseencoding=XML&
   appid=YourAppIDHere&
   siteid=0&
   version=533&
   QueryKeywords=dell&
   CategoryID=58058,51148

   Here is the same input in XML format. Note that this does not include standard values.

XML format. Also available is the .txt version of this XML.

<?xml version="1.0" encoding="utf-8"?>
<FindPopularSearchesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <CategoryID>58058</CategoryID>
  <CategoryID>51148</CategoryID>
  <QueryKeywords>dell</QueryKeywords>
</FindPopularSearchesRequest>

Output

XML format.
</FindPopularSearchesResponse>
<?xml version="1.0" encoding="UTF-8" ?> 
<FindPopularSearchesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2007-10-03T01:22:39.218Z</Timestamp> 
  <Ack>Success</Ack> 
  <Build>e533_core_Bundled_5430035_R1</Build> 
  <Version>533</Version> 
  <PopularSearchResult>
    <CategoryID>58058</CategoryID> 
    <CategoryParentID>58058</CategoryParentID> 
    <QueryKeywords>dell</QueryKeywords> 
    <AlternativeSearches>laptop;hp;alienware</AlternativeSearches> 
    <RelatedSearches>dell laptop;dell dimension;dell inspiron;dell desktop;dell dimension xps</RelatedSearches> 
  </PopularSearchResult>
  <PopularSearchResult>
    <CategoryID>51148</CategoryID> 
    <CategoryParentID>58058</CategoryParentID> 
    <QueryKeywords>dell</QueryKeywords> 
    <AlternativeSearches>inspiron;toshiba;ibm;hp;compaq;laptop;new;sony;gateway;centrino;acer</AlternativeSearches> 
    <RelatedSearches>dell inspiron;dell xps;dell new;dell 700m;dell 6000;dell latitude;dell p4;dell inspiron 6000</RelatedSearches> 
  </PopularSearchResult>
</FindPopularSearchesResponse>

Back to list of samples



Change History

Change Date Description
899
2014-11-04
  • FindPopularSearches (deprecated): This call is deprecated and there is no direct replacement.
577
2008-08-06
  • CategoryParentName (added): Now included in the output for FindPopularSearches so that you don't have to make a secondary GetCategories call for this information.
  • CategoryName (added): Now included in the output for FindPopularSearches so that you don't have to make a secondary GetCategories call for this information.
531
2007-21-09
  • (added) New call.

User-Contributed Notes