Tradera.com logotype

Tradera Developer Program

SearchService

Documentation Version 3 > SearchService > SearchAdvanced

SearchAdvanced |WebMethod|

Search for items with advanced parameters.
Possible errors:
"OrderByValidationError" - use of non-existing order by (OrderBy).
"ItemTypeValidationError" - use of non-existing item type (ItemType).
"SellerTypeValidationError" - use of non-existing seller type (SellerType).
"ModeValidationError" - use of non-existing mode (Mode).
"ItemStatusValidationError" - use of non-existing item status (ItemStatus).
"ItemConditionValidationError" - use of non-existing item condition (ItemCondition).
"SearchStringValidationError" - when searching for invalid search words.
"InternalError" - internal error.

Parameters
  1. request, The SearchAdvancedRequest with search parameters.
Returns

Filled SearchResult object

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /v3/searchservice.asmx HTTP/1.1
Host: api.tradera.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://api.tradera.com/SearchAdvanced"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <AuthenticationHeader xmlns="http://api.tradera.com">
      <AppId>int</AppId>
      <AppKey>string</AppKey>
    </AuthenticationHeader>
    <ConfigurationHeader xmlns="http://api.tradera.com">
      <Sandbox>int</Sandbox>
      <MaxResultAge>int</MaxResultAge>
    </ConfigurationHeader>
  </soap:Header>
  <soap:Body>
    <SearchAdvanced xmlns="http://api.tradera.com">
      <request>
        <SearchWords>string</SearchWords>
        <CategoryId>int</CategoryId>
        <SearchInDescription>boolean</SearchInDescription>
        <Mode>string</Mode>
        <PriceMinimum>int</PriceMinimum>
        <PriceMaximum>int</PriceMaximum>
        <BidsMinimum>int</BidsMinimum>
        <BidsMaximum>int</BidsMaximum>
        <ZipCode>string</ZipCode>
        <CountyId>int</CountyId>
        <Alias>string</Alias>
        <OrderBy>string</OrderBy>
        <ItemStatus>string</ItemStatus>
        <ItemType>string</ItemType>
        <OnlyAuctionsWithBuyNow>boolean</OnlyAuctionsWithBuyNow>
        <OnlyItemsWithThumbnail>boolean</OnlyItemsWithThumbnail>
        <ItemsPerPage>int</ItemsPerPage>
        <PageNumber>int</PageNumber>
        <ItemCondition>string</ItemCondition>
        <SellerType>string</SellerType>
        <Brands>
          <string>string</string>
          <string>string</string>
        </Brands>
      </request>
    </SearchAdvanced>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SearchAdvancedResponse xmlns="http://api.tradera.com">
      <SearchAdvancedResult>
        <TotalNumberOfItems>int</TotalNumberOfItems>
        <TotalNumberOfPages>int</TotalNumberOfPages>
        <Items>
          <Id>int</Id>
          <ShortDescription>string</ShortDescription>
          <BuyItNowPrice>int</BuyItNowPrice>
          <SellerId>int</SellerId>
          <SellerAlias>string</SellerAlias>
          <MaxBid>int</MaxBid>
          <ThumbnailLink>string</ThumbnailLink>
          <SellerDsrAverage>double</SellerDsrAverage>
          <EndDate>dateTime</EndDate>
          <NextBid>int</NextBid>
          <HasBids>boolean</HasBids>
          <IsEnded>boolean</IsEnded>
          <ItemType>string</ItemType>
        </Items>
        <Items>
          <Id>int</Id>
          <ShortDescription>string</ShortDescription>
          <BuyItNowPrice>int</BuyItNowPrice>
          <SellerId>int</SellerId>
          <SellerAlias>string</SellerAlias>
          <MaxBid>int</MaxBid>
          <ThumbnailLink>string</ThumbnailLink>
          <SellerDsrAverage>double</SellerDsrAverage>
          <EndDate>dateTime</EndDate>
          <NextBid>int</NextBid>
          <HasBids>boolean</HasBids>
          <IsEnded>boolean</IsEnded>
          <ItemType>string</ItemType>
        </Items>
        <Errors>
          <Code>string</Code>
          <Message>string</Message>
        </Errors>
        <Errors>
          <Code>string</Code>
          <Message>string</Message>
        </Errors>
      </SearchAdvancedResult>
    </SearchAdvancedResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /v3/searchservice.asmx HTTP/1.1
Host: api.tradera.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Header>
    <AuthenticationHeader xmlns="http://api.tradera.com">
      <AppId>int</AppId>
      <AppKey>string</AppKey>
    </AuthenticationHeader>
    <ConfigurationHeader xmlns="http://api.tradera.com">
      <Sandbox>int</Sandbox>
      <MaxResultAge>int</MaxResultAge>
    </ConfigurationHeader>
  </soap12:Header>
  <soap12:Body>
    <SearchAdvanced xmlns="http://api.tradera.com">
      <request>
        <SearchWords>string</SearchWords>
        <CategoryId>int</CategoryId>
        <SearchInDescription>boolean</SearchInDescription>
        <Mode>string</Mode>
        <PriceMinimum>int</PriceMinimum>
        <PriceMaximum>int</PriceMaximum>
        <BidsMinimum>int</BidsMinimum>
        <BidsMaximum>int</BidsMaximum>
        <ZipCode>string</ZipCode>
        <CountyId>int</CountyId>
        <Alias>string</Alias>
        <OrderBy>string</OrderBy>
        <ItemStatus>string</ItemStatus>
        <ItemType>string</ItemType>
        <OnlyAuctionsWithBuyNow>boolean</OnlyAuctionsWithBuyNow>
        <OnlyItemsWithThumbnail>boolean</OnlyItemsWithThumbnail>
        <ItemsPerPage>int</ItemsPerPage>
        <PageNumber>int</PageNumber>
        <ItemCondition>string</ItemCondition>
        <SellerType>string</SellerType>
        <Brands>
          <string>string</string>
          <string>string</string>
        </Brands>
      </request>
    </SearchAdvanced>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <SearchAdvancedResponse xmlns="http://api.tradera.com">
      <SearchAdvancedResult>
        <TotalNumberOfItems>int</TotalNumberOfItems>
        <TotalNumberOfPages>int</TotalNumberOfPages>
        <Items>
          <Id>int</Id>
          <ShortDescription>string</ShortDescription>
          <BuyItNowPrice>int</BuyItNowPrice>
          <SellerId>int</SellerId>
          <SellerAlias>string</SellerAlias>
          <MaxBid>int</MaxBid>
          <ThumbnailLink>string</ThumbnailLink>
          <SellerDsrAverage>double</SellerDsrAverage>
          <EndDate>dateTime</EndDate>
          <NextBid>int</NextBid>
          <HasBids>boolean</HasBids>
          <IsEnded>boolean</IsEnded>
          <ItemType>string</ItemType>
        </Items>
        <Items>
          <Id>int</Id>
          <ShortDescription>string</ShortDescription>
          <BuyItNowPrice>int</BuyItNowPrice>
          <SellerId>int</SellerId>
          <SellerAlias>string</SellerAlias>
          <MaxBid>int</MaxBid>
          <ThumbnailLink>string</ThumbnailLink>
          <SellerDsrAverage>double</SellerDsrAverage>
          <EndDate>dateTime</EndDate>
          <NextBid>int</NextBid>
          <HasBids>boolean</HasBids>
          <IsEnded>boolean</IsEnded>
          <ItemType>string</ItemType>
        </Items>
        <Errors>
          <Code>string</Code>
          <Message>string</Message>
        </Errors>
        <Errors>
          <Code>string</Code>
          <Message>string</Message>
        </Errors>
      </SearchAdvancedResult>
    </SearchAdvancedResponse>
  </soap12:Body>
</soap12:Envelope>

XHTML CSS