DEVELOPERS AREA > EBAY RESEARCH API > API CALL REFERENCE > GETRESEARCHRESULTS > OUTPUT >
GETRESEARCHRESULTS OUTPUT FIELD REFERENCE
Click on a field name to view a detailed explanation for that field.
Common Fields
FieldTypeSummaryReq.
...Statistics.RevenueintegerThe total revenue generated by listings in the categoryno
Call Specific Fields
FieldTypeSummaryReq.
GetResearchResults.TimestamptimestampThe date and time that the results were tabulated.yes
GetResearchResults.ProcessingTimefloatThe amount of time (in seconds) it took to execute the search.yes
GetResearchResults.ImageURLstringThe image used to link back to the source of your API data.yes
GetResearchResults.LinkURLstringThe link used to link back to the source of your API data.yes
GetResearchResults.Errorsmeta tagContains errors that occured during the query process.no
...Errors.ErrorstringContains the error message string for the particular error.no
GetResearchResults.ModifiedQuerymeta tagContain elements describing changes made to the query by the server.no
...ModifiedQuery.RemovedWordsmeta tagContains words removed from the query by the server.no
...RemovedWords.RemovedWordstringContains a single word which was removed from the query.no
...ModifiedQuery.Datesmeta tagThe dates actually searched, if the ones your requested were invalid.no
...Dates.StartDatedateThis is the first day of the range that was searched.no
...Dates.EndDatedateThis is the last day of the range that was searched.no
GetResearchResults.SearchResultsmeta tagContains the results of the search you performed with the API.no
...SearchResults.Statisticsmeta tagContains various aggregate totals for the items that matched your search.no
...Statistics.RevenuefloatThe total dollar revenue of all successful auctions in the result set.yes
...Statistics.ListingsintegerThe total number of closed listings, regardless of success or not, in the result set.yes
...Statistics.SuccessfulintegerThe total number of closed listings that closed successfully in the result set.yes
...Statistics.BidsintegerThe total number of bids for all listings in the result set, regardless of whether they were successful or not.yes
...Statistics.ItemsSoldintegerThe total number of items sold from successful listings.yes
...Statistics.ItemsOfferedintegerThe total number of items offered from the successful auctions.yes
...Statistics.AverageSellersPerDayintegerThis is the number of unique sellers that sold products matching the search.yes
...Statistics.Pricingmeta tagThe pricing subsection contains statistics about high, low, average and frequent prices, as well as standard deviation, for listings in the result set.no
...Pricing.EndPricemeta tagThis section contains pricing information about the End Prices of all successful listings.no
...EndPrice.HighestfloatThis is the highest price that a successful item in the result set closed for.no
...EndPrice.AveragefloatThis is the average closing price of the successful item in the result set.no
...EndPrice.FrequentPricemeta tagThis is the closing price that occured most frequently in the result set.no
...FrequentPrice.PricefloatThe most frequent dollar amount.no
...FrequentPrice.OccurrencesintegerThe number of times the most frequent price occured.no
...EndPrice.LowestfloatThis is the lowest end price that occured in successful items in the result set.no
...EndPrice.StandardDeviationfloatThis is the standard deviation of the end prices.no
...EndPrice.MedianfloatThis is the median end price for all auctions.no
...Pricing.StartPricemeta tagThis section contains pricing information about the Start Prices of all successful bid listings.no
...StartPrice.HighestfloatThis is the highest price that a successful bid listing in the result set opened for.no
...StartPrice.AveragefloatThis is the average starting price of the successful big listings in the result set.no
...StartPrice.MedianfloatThis is the median start price for all auctions.no
...StartPrice.FrequentPricemeta tagThe starting price that occured most frequently in the result set.no
...FrequentPrice.PricefloatThe most frequent dollar amount.no
...FrequentPrice.OccurrencesintegerThe number of times the most frequent price occured.no
...StartPrice.LowestfloatThe lowest start price that occured in successful bid listings in the result set.no
...StartPrice.StandardDeviationfloatThe standard deviation of the start prices of successful bid listings.no
...Statistics.HourlyDatameta tagThe hourly data breaks down some of the overall totals into hourly totals.no
...HourlyData.Hourmeta tagThe hour tag contains data for a single hour of the day.no
...Hour.RevenuefloatRevenue generated by listings that closed during this hour.no
...Hour.ListingsintegerNumber of listings that closed during this hour.no
...Hour.SuccessfulintegerNumber of successful listings that closed during this hour.no
...Hour.ItemsSoldintegerNumber of items sold in listings that closed.no
...Hour.BidsintegerTotal number of Bids placed on listings that closed during this hour.no
...Hour.ItemsOfferedintegerNumber of items offered in listings that closed.no
...Statistics.Featuresmeta tagThe features tag contains feature usage statisticts.no
...Features.Featuremeta tagContains statistics for a single feature.no
...Feature.ListingsintegerThis is the total number of listings that used the specified feature.no
...Feature.SuccessfulintegerThe total number of successful listings that used the specified feature.no
...Statistics.ListingDurationsmeta tagContains values relating to the volume of listings that close after a specific number of days.no
...ListingDurations.ListingDurationmeta tagContains analytics for a specific listing duration.no
...ListingDuration.ListingsintegerThe total amount of listings that closed after the specified number of days.no
...ListingDuration.SuccessfulintegerThe total amount of successful listings that closed after the specified number of days.no
...ListingDuration.RevenuefloatThe total amount of revenue generated by listings that closed after the specified number of days.no
...ListingDuration.BidsintegerThe total number of bids on listings that closed after the specified number of days.no
...ListingDuration.ItemsOfferedintegerThe total number of items offered in listings that closed after the specified number of days.no
...ListingDuration.ItemsSoldintegerThe total number of items sold in listings that closed after the specified number of days.no
...Statistics.PriceBucketsmeta tagPrice buckets are a range of prices into which listings end prices fall.no
...PriceBuckets.PriceBucketmeta tagA single price bucket.no
...PriceBucket.SuccessfulintegerThe total number of successful listings in the bucket.no
...Statistics.ListingTypesmeta tagReturns analysis on what kind of listing types were used for items.no
...ListingTypes.ListingTypemeta tagContains total and successful listings information regarding the specified auction type.no
...ListingType.ListingsintegerNumber of listings that used the specific listing type.no
...ListingType.SuccessfulintegerNNumber of successful listings that used the specific listing type.no
...ListingType.RevenuefloatRevenue generated by listings that used the specific listing type.no
...ListingType.ItemsOfferedintegerItems offered in listings that used the specific listing type.no
...ListingType.ItemsSoldintegerItems sold in listings that used the specific listing type.no
...Statistics.DailyDatameta tagThis node contains data for the days of the week.no
...DailyData.WeekDaymeta tagThis node contains data for a single day of the week.no
...WeekDay.RevenuefloatThis is the total amount of revenue generated for this day.no
...WeekDay.ListingsintegerThis is the total number of listings that closed on this day.no
...WeekDay.SuccessfulintegerThis is the total number of successful listings that closed on this day.no
...WeekDay.BidsintegerThis is the total number of bids to all listings that closed on this day.no
...WeekDay.ItemsSoldintegerThis is the total number of items sold on this day.no
...WeekDay.ItemsOfferedintegerThis is the total number of items offered on this dayno
...WeekDay.AverageSellersintegerThis is the total number of unique sellers on this day of the week for days.no
...WeekDay.DayCountintegerThis is the number of days that were aggregated together into the totals in this node.no
...SearchResults.Categoriesmeta tagContains information about the categories on eBay in which the items were listed.no
...Categories.Categorymeta tagContains information regarding a single child category.no
...Category.NamestringThe name of this category.no
...Category.FullNamestringThe full name of the category starting from the root.no
...Category.Statisticsmeta tagThis node contains statistics about the specific category.no
...Statistics.ListingsintegerThe total number of listings from the result set that were found in this category.no
...Statistics.SuccessfulintegerThe total number of successful listings in the categoryno
...Statistics.ItemsSoldintegerThe total number of items sold in listings in the categoryno
...SearchResults.Itemsmeta tagIncludes information about some of the specific items found within the result set.no
...Items.Itemmeta tagThis node contains data about a single item from the result set.no
...Item.CategoryintegerThe category ID that an item sold inno
...Item.ItemStatisticsmeta tagThis node contains information regarding the pricing, bids, and items within the listing.no
...ItemStatistics.StartPricefloatThe price at which the listing opened.no
...ItemStatistics.EndPricefloatThe price at which the listing closed.no
...ItemStatistics.BidsintegerThe number of bids that the listing recieved.no
...ItemStatistics.ItemsOfferedintegerThe number of items offered in the auction.no
...ItemStatistics.ItemsSoldintegerThe number of items that acutally sold successfully in the auction.no
...Item.Flagsmeta tagThe flags node contains various important flags regarding the listing.no
...Flags.SuccessfulintegerThis flag represents whether the auction closed successfully or not.no
...Flags.GalleryintegerThis flag represents whether the auction used gallery or not.no
...Item.AuctionTypestringThe type of auction the listing used.no
...Item.SellerIDintegerThe eBay User ID of the seller.no
...Item.SitestringThe eBay site on which the listing was placed.no
...Item.ListingDetailsmeta tagContain data about when a listing opened, closed, and more.no
...ListingDetails.StartTimetimeThe time that the listing opened.no
...ListingDetails.StartDatedateThe date that the listing opened.no
...ListingDetails.EndTimetimeThe time that the listing closed.no
...ListingDetails.EndDatedateThe date that the listing closed.no
...ListingDetails.ViewItemURLstringA link directly to the listing on eBay.no
...Item.SubtitlestringSome listings contain a second title called the subtitle. This can also be up to 55 characters.no
...Item.TitlestringThe title of the listing in question.no
...SearchResults.PopularKeywordsmeta tagContains all the popular keywords for the search.no
...PopularKeywords.Keywordmeta tagA single popular keyword node.no
...Keyword.RevenuefloatThe total revenue for the keyword combination.no
...Keyword.ListingsintegerThe number of listings for the keyword combination.no
...Keyword.SuccessfulintegerThe number of successful listings for the keyword combination.no
...Keyword.BidsintegerThe number of bids for the keyword combination.no
...Keyword.ItemsSoldintegerThe number of items sold for the keyword combination.no
...Keyword.ItemsOfferedintegerThe number of items offered for the keyword combination.no
...Keyword.AvgStartPricefloatThe average start price for the keyword combination.no
See Also: Output Schema, Input Schema, Input Field Reference.
Learn more by calling us at:
1.888.483.DATA (3282)

or by emailing us at: