GetResearchResults Example Usage

Basic Example

This example input searches for "Dell Laptop" in the "Computers and Networking" category with a minimum price of $250.00 on the most recent day in the system. You can try this call out on your own in the Call Tester by copying the input and replacing the fake tokens with your account's tokens. Note: The output may not be identical, as the available date range is always moving.

<GetSearchResults>
  <Version>2</Version>
  <RequesterCredentials>
    <Token> your_token_here </Token>
    <UserToken> your_usertoken_here </UserToken>
    <DeveloperName> your_developer_name_here </DeveloperName>
  </RequesterCredentials>
  <SearchQuery>
    <Keywords><![CDATA[dell laptop]]></Keywords>
    <Pricing>
      <EndPriceFloor>250</EndPriceFloor>
    </Pricing>
    <CategoryLimit>
      <CategoryID>58058</CategoryID>
    </CategoryLimit>
    <Dates>
      <DateRange>Day</DateRange>
    </Dates>
    <ResultSet>
      <ReturnPricingInformation>1</ReturnPricingInformation>
      <ReturnFeatureInformation>1</ReturnFeatureInformation>
    </ResultSet>
  </SearchQuery>
</GetSearchResults>

The final statistics below show that the average price of "Dell Laptop" in the "Computers and Networking" category was $531.61 (for listings that ended equal to or higher then $250.00), and that a total of 522 items were sold on the date we searched. We can see in the Features section that 81 of the successful listings were sold with "Buy it Now!", with a sell-through rate of over 98%.

<?xml version="1.0" encoding="UTF-8"?>
<GetSearchResults>
	<Timestamp>2007-01-31 08:51:54</Timestamp>
	<ProcessingTime>3.285</ProcessingTime>
	<ImageURL><![CDATA[http://api.dataunison.com/images/dataunison_powered_by_114x36.gif]]></ImageURL>
	<LinkURL><![CDATA[http://www.dataunison.com/ebay_research/api.php]]></LinkURL>
	<CallsRemaining>499</CallsRemaining>
	<CallLimitResetTime>2007-02-01 00:00:00</CallLimitResetTime>
	<SearchResults>
		<Statistics>
			<Revenue>277502.77</Revenue>
			<Listings>503</Listings>
			<Successful>453</Successful>
			<Bids>7948</Bids>
			<ItemsOffered>739</ItemsOffered>
			<ItemsSold>522</ItemsSold>
			<AverageSellersPerDay>301</AverageSellersPerDay>
			<Pricing>
				<EndPrice>
					<Highest>5979.00</Highest>
					<Average>531.61</Average>
					<Median>493.03</Median>
					<FrequentPrice>
						<Price>305.00</Price>
						<Occurrences>17</Occurrences>
					</FrequentPrice>
					<Lowest>250.25</Lowest>
					<StandardDeviation>366.45</StandardDeviation>
				</EndPrice>
				<StartPrice>
					<Highest>999.00</Highest>
					<Average>81.85</Average>
					<Median>0.99</Median>
					<FrequentPrice>
						<Price>0.99</Price>
						<Occurrences>142</Occurrences>
					</FrequentPrice>
					<Lowest>0.01</Lowest>
					<StandardDeviation>168.27</StandardDeviation>
				</StartPrice>
			</Pricing>
			<Features>
				<Feature name = 'Category Featured'>
					<Listings>176</Listings>
					<Successful>171</Successful>
				</Feature>
				<Feature name = 'Gallery'>
					<Listings>251</Listings>
					<Successful>219</Successful>
				</Feature>
				<Feature name = 'Gallery Featured'>
					<Listings>11</Listings>
					<Successful>11</Successful>
				</Feature>
				<Feature name = 'Gift Listing'>
					<Listings>15</Listings>
					<Successful>11</Successful>
				</Feature>
				<Feature name = 'Highlighted'>
					<Listings>14</Listings>
					<Successful>13</Successful>
				</Feature>
				<Feature name = 'Multilisted'>
					<Listings>2</Listings>
					<Successful>1</Successful>
				</Feature>
				<Feature name = 'Picture Services'>
					<Listings>81</Listings>
					<Successful>76</Successful>
				</Feature>
				<Feature name = 'Bold'>
					<Listings>85</Listings>
					<Successful>78</Successful>
				</Feature>
				<Feature name = 'Reserve'>
					<Listings>28</Listings>
					<Successful>22</Successful>
				</Feature>
				<Feature name = 'Buy It Now'>
					<Listings>82</Listings>
					<Successful>81</Successful>
				</Feature>
				<Feature name = 'Scheduled'>
					<Listings>100</Listings>
					<Successful>97</Successful>
				</Feature>
				<Feature name = 'Subtitle'>
					<Listings>317</Listings>
					<Successful>285</Successful>
				</Feature>
				<Feature name = 'No Features'>
					<Listings>24</Listings>
					<Successful>21</Successful>
				</Feature>
			</Features>
		</Statistics>
	</SearchResults>
</GetSearchResults>