Aukro WebAPI

doGetMyWatchedItems

This method provides all functions of “Watched: Ended” tabs available in My Allegro. Additionally it allows for sorting and searching offers by name.

  1. sessionId | String | required
    A user’s session identifier received using the method doLogin(Enc).
  2. sortOptions | SortOptionsStruct
    A structure containing information about the method of sorting offers.
    1. sortType | Integer
      A parameter which allows for indicating the type of sort (1 - by end time (default value for the tab), 2 - by current price, 3 - by offer name, 4 - by number of bids, 5 - by the highest bid, 6 - by seller’s username, 8 - by my maximum price, 12 - by number of bid items).
    2. sortOrder | Integer
      A parameter which allows for indicating the sort order (1 - ascending (default value for the tab), 2 - descending).
  3. searchValue | String
    A phrase searched in offers (relates to searching by the offer title). It allows for searching using characters such as *, -, () and “”.
  4. categoryId | Integer
    A parameter which allows for indicating a category of displayed offers.
  5. itemIds | Long[]
    Array of offer identifiers (max.: 100).
  6. pageSize | Integer
    A parameter which allows for indicating the number of displayed offers (min.: 1, max.: 1,000, default value: 100).
  7. pageNumber | Integer
    A parameter which allows for indicating data portions to be displayed (default value: 0).
  1. watchedItemsCounter | Integer
    Number of ended watched offers (reflecting filters provided on method input).
  2. watchedItemsList | WatchedItemStruct[]
    Array of structures with exact information about ended watched offers.
    1. itemId | Long
      Offer identifier.
    2. itemTitle | String | required
      Offer title.
    3. itemThumbnailUrl | String | required
      Link to offer thumbnail.
    4. itemPrice | ItemPriceStruct[]
      Array of structures containing information about the item price.
      1. priceType | Integer
        Price type (1 - Buy it Now!, 6 - Final bidding.
      2. priceValue | BigDecimal | required
        Item price.
    5. itemLeftQuantity | Integer
    6. itemQuantityType | Integer
    7. itemEndTime | Long
      End time (Unix time).
    8. itemSeller | UserInfoStruct | required
      A structure containing information about seller.
      1. userId | Integer
        User identifier.
      2. userLogin | String | required
        Username.
      3. userRating | Integer
        User’s score.
      4. userIcons | Integer
        Additional information about a user. A bitmask: 1 - not activated account, 2 - Junior account, 4 - not registered user, 8 - “About me” page, 16 - Company account, 32 - shop, 64 - Super Seller (only in molotok.ru).
      5. userCountry | Integer
        Identifier of a user’s country.
    9. itemBiddersCounter | Integer
      A counter of placed bids.
    10. itemHighestBidder | UserInfoStruct | required
      A structure containing information about a user who has placed the highest bid. Only for single-item bidding.
      1. userId | Integer
        User identifier.
      2. userLogin | String | required
        Username.
      3. userRating | Integer
        User’s score.
      4. userIcons | Integer
        Additional information about a user. A bitmask: 1 - not activated account, 2 - Junior account, 4 - not registered user, 8 - “About me” page, 16 - Company account, 32 - shop, 64 - Super Seller (only in molotok.ru).
      5. userCountry | Integer
        Identifier of a user’s country.
    11. itemCategoryId | Integer
      An identifier of the category where the offer is listed.
    12. itemViewsCounter | Integer
      Number of offer views.
    13. itemNote | String | required
      Content of a memo added to the offer.
    14. itemSpecialInfo | Integer
      Information whether an offer is marked as Standard Allegro [PL], Aukro Plus [CZ] or Super Offer [UA/KZ] (0 - no, 1 - yes).
    15. itemShopInfo | Integer
      Information on whether it is a shop offer (0 - no, 1 - yes).
    16. itemProductInfo | Long
      Outdated field (will always return 0).
    17. itemPayuInfo | Integer
      Information on whether the offer enables payment via PayU (0 - no, 1 - yes).
  • ERR_INCORRECT_CATEGORY_ID
    Incorrect category identifier.
  • ERR_INCORRECT_PAGE_NUMBER
    Incorrect value of page-number parameter (lesser than 0).
  • ERR_INCORRECT_PAGE_SIZE
    Incorrect value of page-size parameter (lesser than 0 or greater than 1,000).
  • ERR_INCORRECT_SEARCH_VALUE
    Searched phrase contains unacceptable characters.
  • ERR_INCORRECT_SORT_ORDER
    Incorrect value of sort-order parameter.
  • ERR_INCORRECT_SORT_TYPE
    Incorrect value of sort-type parameter.
  • ERR_NO_SESSION / ERR_SESSION_EXPIRED
    Invalid session identifier or the session has expired.
  • ERR_TOO_MANY_ITEM_IDS
    Over 100 auction identifiers have been passed.
  • ERR_WEBAPI_KEY_INACTIVE
    WebAPI key used to generate the session has been deactivated (the key owner has not accepted WebAPI User Agreement).