GetResearchResults Output Field Reference

Click on the field names for detailed descriptions and example usage.

Common Fields
Field	Type	Summary	Req.
GetResearchResults.Timestamp	timestamp	The date and time that the results were tabulated.	yes
GetResearchResults.ProcessingTime	float	The amount of time (in seconds) it took to execute the search.	yes
GetResearchResults.ImageURL	string	The image used to link back to the source of your API data.	yes
GetResearchResults.LinkURL	string	The link used to link back to the source of your API data.	yes
GetResearchResults.Errors	meta tag	Contains errors that occured during the query process.	no
...Errors.Error	string	Contains the error message string for the particular error.	no
GetResearchResults.ModifiedQuery	meta tag	Contain elements describing changes made to the query by the server.	no
...ModifiedQuery.RemovedWords	meta tag	Contains words removed from the query by the server.	no
...RemovedWords.RemovedWord	string	Contains a single word which was removed from the query.	no
...SearchResults.Items	meta tag	Includes information about some of the specific items found within the result set.	no
...Items.Item	meta tag	This node contains data about a single item from the result set.	no
...Item.ItemStatistics	meta tag	This node contains information regarding the pricing, bids, and items within the listing.	no
...ItemStatistics.ItemsSold	integer	The number of items that acutally sold successfully in the auction.	no
...ItemStatistics.ItemsOffered	integer	The number of items offered in the auction.	no
...ItemStatistics.Bids	integer	The number of bids that the listing recieved.	no
...ItemStatistics.EndPrice	float	The price at which the listing closed.	no
...ItemStatistics.StartPrice	float	The price at which the listing opened.	no
...Item.Flags	meta tag	The flags node contains various important flags regarding the listing.	no
...Flags.Gallery	integer	This flag represents whether the auction used gallery or not.	no
...Flags.Successful	integer	This flag represents whether the auction closed successfully or not.	no
...Item.AuctionType	string	The type of auction the listing used.	no
...Item.SellerID	integer	The eBay User ID of the seller.	no
...Item.Site	string	The eBay site on which the listing was placed.	no
...Item.ListingDetails	meta tag	Contain data about when a listing opened, closed, and more.	no
...ListingDetails.ViewItemURL	string	A link directly to the listing on eBay.	no
...ListingDetails.EndDate	date	The date that the listing closed.	no
...ListingDetails.EndTime	time	The time that the listing closed.	no
...ListingDetails.StartDate	date	The date that the listing opened.	no
...ListingDetails.StartTime	time	The time that the listing opened.	no
...Item.Subtitle	string	Some listings contain a second title called the subtitle. This can also be up to 55 characters.	no
...Item.Title	string	The title of the listing in question.	no
Call Specific Fields
Field	Type	Summary	Req.
...ModifiedQuery.Dates	meta tag	The dates actually searched, if the ones your requested were invalid.	no
...Dates.EndDate	date	This is the last day of the range that was searched.	no
...Dates.StartDate	date	This is the first day of the range that was searched.	no
GetResearchResults.SearchResults	meta tag	Contains the results of the search you performed with the API.	no
...Item.Category	integer	The category ID that an item sold in	no
...SearchResults.Categories	meta tag	Contains information about the categories on eBay in which the items were listed.	no
...Categories.Category	meta tag	Contains information regarding a single child category.	no
...Category.Statistics	meta tag	This node contains statistics about the specific category.	no
...Statistics.Listings	integer	The total number of listings from the result set that were found in this category.	no
...Category.FullName	string	The full name of the category starting from the root.	no
...Category.Name	string	The name of this category.	no
...SearchResults.Statistics	meta tag	Contains various aggregate totals for the items that matched your search.	no
...Statistics.Revenue	float	The total dollar revenue of all successful auctions in the result set.	yes
...Statistics.Listings	integer	The total number of closed listings, regardless of success or not, in the result set.	yes
...Statistics.Successful	integer	The total number of closed listings that closed successfully in the result set.	yes
...Statistics.Bids	integer	The total number of bids for all listings in the result set, regardless of whether they were successful or not.	yes
...Statistics.ItemsSold	integer	The total number of items sold from successful listings.	yes
...Statistics.ItemsOffered	integer	The total number of items offered from the successful auctions.	yes
...Statistics.Sellers	integer	This is the number of unique sellers that sold products matching the search.	yes
...Statistics.Pricing	meta tag	The pricing subsection contains statistics about high, low, average and frequent prices, as well as standard deviation, for listings in the result set.	no
...Pricing.StartPrice	meta tag	This section contains pricing information about the Start Prices of all successful bid listings.	no
...StartPrice.StandardDeviation	float	The standard deviation of the start prices of successful bid listings.	no
...StartPrice.Lowest	float	The lowest start price that occured in successful bid listings in the result set.	no
...StartPrice.FrequentPrice	meta tag	The starting price that occured most frequently in the result set.	no
...FrequentPrice.Occurrences	integer	The number of times the most frequent price occured.	no
...FrequentPrice.Price	float	The most frequent dollar amount.	no
...StartPrice.Median	float	This is the median start price for all auctions.	no
...StartPrice.Average	float	This is the average starting price of the successful big listings in the result set.	no
...StartPrice.Highest	float	This is the highest price that a successful bid listing in the result set opened for.	no
...Pricing.EndPrice	meta tag	This section contains pricing information about the End Prices of all successful listings.	no
...EndPrice.StandardDeviation	float	This is the standard deviation of the end prices.	no
...EndPrice.Lowest	float	This is the lowest end price that occured in successful items in the result set.	no
...EndPrice.FrequentPrice	meta tag	This is the closing price that occured most frequently in the result set.	no
...FrequentPrice.Occurrences	integer	The number of times the most frequent price occured.	no
...FrequentPrice.Price	float	The most frequent dollar amount.	no
...EndPrice.Average	float	This is the average closing price of the successful item in the result set.	no
...EndPrice.Highest	float	This is the highest price that a successful item in the result set closed for.	no
...Statistics.HourlyData	meta tag	The hourly data breaks down some of the overall totals into hourly totals.	no
...HourlyData.Hour	meta tag	The hour tag contains data for a single hour of the day.	no
...Hour.ItemsSold	integer	Number of items sold in listings that closed.	no
...Hour.Successful	integer	Number of successful listings that closed during this hour.	no
...Hour.Listings	integer	Number of listings that closed during this hour.	no
...Hour.Revenue	float	Revenue generated by listings that closed during this hour.	no
...Statistics.Features	meta tag	The features tag contains feature usage statisticts.	no
...Features.Feature	meta tag	Contains statistics for a single feature.	no
...Feature.Successful	integer	The total number of successful listings that used the specified feature.	no
...Feature.Listings	integer	This is the total number of listings that used the specified feature.	no
...Statistics.ListingDurations	meta tag	Contains values relating to the volume of listings that close after a specific number of days.	no
...ListingDurations.ListingDuration	meta tag	Contains analytics for a specific listing duration.	no
...ListingDuration.Successful	integer	The total amount of successful listings that closed after the specified number of days.	no
...ListingDuration.Listings	integer	The total amount of listings that closed after the specified number of days.	no
...Statistics.PriceBuckets	meta tag	Price buckets are a range of prices into which listings end prices fall.	no
...PriceBuckets.PriceBucket	meta tag	A single price bucket.	no
...PriceBucket.Successful	integer	The total number of successful listings in the bucket.	no
...Statistics.ListingTypes	meta tag	Returns analysis on what kind of listing types were used for items.	no
...ListingTypes.ListingType	meta tag	Contains total and successful listings information regarding the specified auction type.	no
...ListingType.Successful	integer	NNumber of successful listings that used the specific listing type.	no
...ListingType.Listings	integer	Number of listings that used the specific listing type.	no
...Statistics.DailyData	meta tag	This node contains data for the days of the week.	no
...DailyData.WeekDay	meta tag	This node contains data for a single day of the week.	no
...WeekDay.DayCount	integer	This is the number of days that were aggregated together into the totals in this node.	no
...WeekDay.Sellers	integer	This is the total number of unique sellers on this day of the week for days.	no
...WeekDay.ItemsOffered	integer	This is the total number of items offered on this day	no
...WeekDay.ItemsSold	integer	This is the total number of items sold on this day.	no
...WeekDay.Bids	integer	This is the total number of bids to all listings that closed on this day.	no
...WeekDay.Successful	integer	This is the total number of successful listings that closed on this day.	no
...WeekDay.Listings	integer	This is the total number of listings that closed on this day.	no
...WeekDay.Revenue	float	This is the total amount of revenue generated for this day.	no

See Also: Output Schema, Input Schema and Input Field Reference.