Query Marketplace Item Offers – PlayerAuctions Help Center

Gethttps://seller-api.playerauctions.com/api/v1/olp/item

Query the paged list of published item offers for a game. Offers are returned in descending order of offer ID (newest first).

i. Request Example

https://seller-api.playerauctions.com/api/v1/olp/item?gameId=9479&pageIndex=1&pageSize=20&serverId=

ii. Request Parameters

Query Parameters

Parameter	Type	Required	Description
gameId	int	Yes	Game ID.
pageIndex	int	No	Page number. Default: 1. Values less than 1 are treated as 1.
pageSize	int	No	Number of items per page. Default: 20. Maximum: 100.
serverId	int	No	Server ID to filter by. You can get the server's tree-structured data from the api/v1/games/{id}/{type}/servers endpoint. Transferable item offers are always included.

iii. Response Example

Success Response

{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "count": 56,
    "items": [
      {
        "offerId": 71394133,
        "offerTitle": "Rare Mount - Instant Delivery",
        "sellerName": "BestSeller02",
        "sellerLevel": 4,
        "sellerRating": 4.76,
        "price": 8.99,
        "deliveryTime": "24 Hours",
        "categoryServer": "EU",
        "categoryFaction": "Horde",
        "itemName": "Rare Mount",
        "discounts": [
          {
            "startPrice": 100,
            "endPrice": 499,
            "discountRate": 5
          }
        ]
      }
    ]
  }
}

Error Response

{
  "code": 10002,
  "message": "Invalid parameter.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

iv. Response Parameters

Parameter	Type	Description
code	int	Response code. 10000 indicates success; other values indicate an error.
message	string	Response message. Contains error details on failure.
requestId	string	Unique identifier for the request, used for tracking.
data	object	Response payload. Returned only when the request succeeds.
data.count	int	Total number of offers that match the filters.
data.items	array	Offer list of the current page.
data.items[].offerId	int	Offer ID.
data.items[].offerTitle	string	Offer title.
data.items[].sellerName	string	Seller name.
data.items[].sellerLevel	int	Seller level.
data.items[].sellerRating	decimal	Weighted feedback rating of the seller.
data.items[].price	decimal	Offer price in USD.
data.items[].deliveryTime	string	Committed delivery time of the offer, for example `24 Hours`.
data.items[].categoryServer	string	Server name of the offer. Null when the offer has no server.
data.items[].categoryFaction	string	Faction name of the offer. Null when the offer has no faction.
data.items[].itemName	string	Item name. Null when the offer has no item.
data.items[].discounts	array	Volume discount rules of the offer, sorted by start price in ascending order. Empty when the offer has no discounts.
data.items[].discounts[].startPrice	decimal	Start price of the discount tier.
data.items[].discounts[].endPrice	decimal	End price of the discount tier.
data.items[].discounts[].discountRate	decimal	Discount rate of the discount tier, in percentage.