GetResearchResults Output Field Reference
Other Versions: 1 | Printable Version
Last updated: 2006-11-06 11:29:46
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.Datesmeta tagThe dates actually searched, if the ones your requested were invalid.no
...Dates.EndDatedateThis is the last day of the range that was searched.no
...Dates.StartDatedateThis is the first day of the range that was searched.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
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.StartPricemeta tagThis section contains pricing information about the Start Prices of all successful bid listings.no
...StartPrice.StandardDeviationfloatThe standard deviation of the start prices of successful bid listings.no
...StartPrice.LowestfloatThe lowest start price that occured in successful bid listings in the result set.no
...StartPrice.FrequentPricemeta tagThe starting price that occured most frequently in the result set.no
...FrequentPrice.OccurrencesintegerThe number of times the most frequent price occured.no
...FrequentPrice.PricefloatThe most frequent dollar amount.no
...StartPrice.MedianfloatThis is the median start price for all auctions.no
...StartPrice.AveragefloatThis is the average starting price of the successful big listings in the result set.no
...StartPrice.HighestfloatThis is the highest price that a successful bid listing in the result set opened for.no
...Pricing.EndPricemeta tagThis section contains pricing information about the End Prices of all successful listings.no
...EndPrice.MedianfloatThis is the median end price for all auctions.no
...EndPrice.StandardDeviationfloatThis is the standard deviation of the end prices.no
...EndPrice.LowestfloatThis is the lowest end price that occured in successful items in the result set.no
...EndPrice.FrequentPricemeta tagThis is the closing price that occured most frequently in the result set.no
...FrequentPrice.OccurrencesintegerThe number of times the most frequent price occured.no
...FrequentPrice.PricefloatThe most frequent dollar amount.no
...EndPrice.AveragefloatThis is the average closing price of the successful item in the result set.no
...EndPrice.HighestfloatThis is the highest price that a successful item in the result set closed for.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.ItemsOfferedintegerNumber of items offered in listings that closed.no
...Hour.BidsintegerTotal number of Bids placed on listings that closed during this hour.no
...Hour.ItemsSoldintegerNumber of items sold in listings that closed.no
...Hour.SuccessfulintegerNumber of successful listings that closed during this hour.no
...Hour.ListingsintegerNumber of listings that closed during this hour.no
...Hour.RevenuefloatRevenue generated by listings that closed during this hour.no
...Statistics.Featuresmeta tagThe features tag contains feature usage statisticts.no
...Features.Featuremeta tagContains statistics for a single feature.no
...Feature.SuccessfulintegerThe total number of successful listings that used the specified feature.no
...Feature.ListingsintegerThis is the total number of 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.ItemsSoldintegerThe total number of items sold in 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.BidsintegerThe total number of bids on 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.SuccessfulintegerThe total amount of successful listings that closed after the specified number of days.no
...ListingDuration.ListingsintegerThe total amount of 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.ItemsSoldintegerItems sold in listings that used the specific listing type.no
...ListingType.ItemsOfferedintegerItems offered in listings that used the specific listing type.no
...ListingType.RevenuefloatRevenue generated by listings that used the specific listing type.no
...ListingType.SuccessfulintegerNNumber of successful listings that used the specific listing type.no
...ListingType.ListingsintegerNumber of 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.DayCountintegerThis is the number of days that were aggregated together into the totals in this node.no
...WeekDay.AverageSellersintegerThis is the total number of unique sellers on this day of the week for days.no
...WeekDay.ItemsOfferedintegerThis is the total number of items offered on this dayno
...WeekDay.ItemsSoldintegerThis is the total number of items sold on this day.no
...WeekDay.BidsintegerThis is the total number of bids to all listings that closed on this day.no
...WeekDay.SuccessfulintegerThis is the total number of successful listings that closed on this day.no
...WeekDay.ListingsintegerThis is the total number of listings that closed on this day.no
...WeekDay.RevenuefloatThis is the total amount of revenue generated for this day.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.Statisticsmeta tagThis node contains statistics about the specific category.no
...Statistics.ItemsSoldintegerThe total number of items sold in listings in the categoryno
...Statistics.SuccessfulintegerThe total number of successful listings in the categoryno
...Statistics.ListingsintegerThe total number of listings from the result set that were found in this category.no
...Category.FullNamestringThe full name of the category starting from the root.no
...Category.NamestringThe name of this category.no
...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.TitlestringThe title of the listing in question.no
...Item.SubtitlestringSome listings contain a second title called the subtitle. This can also be up to 55 characters.no
...Item.ListingDetailsmeta tagContain data about when a listing opened, closed, and more.no
...ListingDetails.ViewItemURLstringA link directly to the listing on eBay.no
...ListingDetails.EndDatedateThe date that the listing closed.no
...ListingDetails.EndTimetimeThe time that the listing closed.no
...ListingDetails.StartDatedateThe date that the listing opened.no
...ListingDetails.StartTimetimeThe time that the listing opened.no
...Item.SitestringThe eBay site on which the listing was placed.no
...Item.SellerIDintegerThe eBay User ID of the seller.no
...Item.AuctionTypestringThe type of auction the listing used.no
...Item.Flagsmeta tagThe flags node contains various important flags regarding the listing.no
...Flags.GalleryintegerThis flag represents whether the auction used gallery or not.no
...Flags.SuccessfulintegerThis flag represents whether the auction closed successfully or not.no
...Item.ItemStatisticsmeta tagThis node contains information regarding the pricing, bids, and items within the listing.no
...ItemStatistics.ItemsSoldintegerThe number of items that acutally sold successfully in the auction.no
...ItemStatistics.ItemsOfferedintegerThe number of items offered in the auction.no
...ItemStatistics.BidsintegerThe number of bids that the listing recieved.no
...ItemStatistics.EndPricefloatThe price at which the listing closed.no
...ItemStatistics.StartPricefloatThe price at which the listing opened.no
...Item.CategoryintegerThe category ID that an item sold inno
...SearchResults.PopularKeywordsmeta tagContains all the popular keywords for the search.no
...PopularKeywords.Keywordmeta tagA single popular keyword node.no
...Keyword.AvgStartPricefloatThe average start price for the keyword combination.no
...Keyword.ItemsOfferedintegerThe number of items offered for the keyword combination.no
...Keyword.ItemsSoldintegerThe number of items sold for the keyword combination.no
...Keyword.BidsintegerThe number of bids for the keyword combination.no
...Keyword.SuccessfulintegerThe number of successful listings for the keyword combination.no
...Keyword.ListingsintegerThe number of listings for the keyword combination.no
...Keyword.RevenuefloatThe total revenue for the keyword combination.no
See Also: Output Schema, Input Schema, Input Field Reference.
No Comments FoundPost A Comment 
Use of this Web site constitutes acceptance of the
DataUnison Terms and Privacy Policy.
Copyright © 2005-2008 DataUnison. All Rights Reserved.
eBay and the eBay Logo are Trademarks of eBay Inc.