/offers - Wherehouse API

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Query Params

_limit

integer

optional

Total number of items to return. Maximum 100.

_start

integer

optional

Offset to return items from, used for pagination.

_sort

string

optional

Field to sort by in the format field:asc or field:desc

competitiveness

string

optional

Example:

high

total_competitors_gte

string

optional

Example:

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

meta

object

required

total

integer

required

limit

integer

required

start

integer

required

offers

array [object {19}]

required

competitiveness

string

required

created_at

string

required

integer

required

last_seen_at

null

required

offer_id

string

required

offer_price

number

required

offer_status

string

required

product

object

required

rating_avg

number

required

rating_count

string

required

seller_id

string

required

seller_name

string

required

stock_status

string

required

total_competitors

integer

required

updated_at

string

required

url

string

required

winning

boolean

required

winning_delivery

boolean

required

winning_price

integer

required

Example

{
    "meta": {
        "total": 16,
        "limit": 3,
        "start": 0
    },
    "offers": [
        {
            "competitiveness": "high",
            "created_at": "2025-02-20T11:04:22.621Z",
            "id": 50644,
            "last_seen_at": null,
            "offer_id": "DEMO-580e5da2-9d4f-4ccd-8baa-c2b4a4d52962",
            "offer_price": 14399.2,
            "offer_status": "buyable",
            "product": {
                "barcode": "9373817819",
                "brand": "Apple",
                "code": "APL-IPH-33",
                "colour": "Gold",
                "created_at": "2024-07-18T11:34:45.435Z",
                "description": "Color Choices\n\nSilver\nGraphite\nGold\nSierra Blue\nBattery\n\nCurrent: 4,352mAh\nPower: ?Wh\nVoltage: ?V\nCameras\n\nFront: 12MP camera.\nRear: 12MP Wide camera.\nStorage Choices\n\n128GB\n256GB\n512GB\n1TB\nCPU Specs\n\nCPU: T8110 \"A15 Bionic\"\nClock rate: 3.23 GHz\nCore Design: Apple Avalanche x 2 and Apple Blizzard x 4\nInstruction Set: ?\nRAM: 6GB\nConnectivity and Wireless\n\nBluetooth 5.0\nNFC with reader mode\n802.11ax Wi-Fi 6 with 2x2 MIMO\nGigabit LTE with 4x4 MIMO and LAA\n5G (sub‑6 GHz)\nBaseband Device: SDX60M\nFirmwares\n\nInitial firmware(s): 15.0 (19A340, 19A341, 19A345 and 19A346)\nLatest public firmware: 15.5 (19F77)\nLatest beta firmware: 15.6 beta (19G5027e)\nFirmware Identifiers: iPhone14,3",
                "fee_estimates": null,
                "height_cm": 3.5,
                "id": 1776775,
                "images": null,
                "length_cm": 1,
                "main_image": "https://www.theiphonewiki.com/w/images/7/7d/IPhone_13_Pro_Max.png",
                "material": null,
                "parent_code": null,
                "retail_price": 17999,
                "soh": 16,
                "title": "iPhone 13 Pro Max",
                "type": null,
                "updated_at": "2024-07-18T11:34:45.435Z",
                "weight_g": 0.545,
                "width_cm": 1.5
            },
            "rating_avg": 3.73,
            "rating_count": "169",
            "seller_id": "demo-connected-takealot",
            "seller_name": "Rocketship Retail",
            "stock_status": "lead_time",
            "total_competitors": 6,
            "updated_at": "2025-02-20T11:04:22.623Z",
            "url": "https://www.takealot.com/x/PLID93936608",
            "winning": false,
            "winning_delivery": true,
            "winning_price": 14081
        },
        {
            "competitiveness": "high",
            "created_at": "2025-02-20T11:04:22.578Z",
            "id": 50640,
            "last_seen_at": null,
            "offer_id": "DEMO-856a0a13-a84e-4bc9-a47c-e0a09b0a2eb3",
            "offer_price": 12799.2,
            "offer_status": "buyable",
            "product": {
                "barcode": "9032816743",
                "brand": "Apple",
                "code": "APL-IPH-29",
                "colour": "Blue",
                "created_at": "2024-07-18T11:34:45.410Z",
                "description": "Color Choices\n\nSilver\nGraphite\nGold\nPacific Blue\nBattery\n\nCurrent: 3,687mAh\nPower: 14.13Wh\nVoltage: 3.83V\nCameras\n\nFront: 12MP camera.\nRear: 12MP Wide camera.\nStorage Choices\n\n128GB\n256GB\n512GB\nCPU Specs\n\nCPU: T8101 \"A14 Bionic\"\nClock rate: 2.99 GHz\nCore Design: Apple Firestorm x 2 and Apple Icestorm x 4\nInstruction Set: ARMv8.5-A\nRAM: 6GB\nConnectivity and Wireless\n\nBluetooth 5.0\nNFC with reader mode\n802.11ax Wi-Fi 6 with 2x2 MIMO\nGigabit-class LTE with 4x4 MIMO and LAA\n5G (sub‑6 GHz and mmWave)\nBaseband Device: SDX55M\nFirmwares\n\nInitial firmware: 14.1 (18A8395)\nLatest public firmware: 15.5 (19F77)\nLatest beta firmware: 15.6 beta (19G5027e)\nFirmware Identifiers: iPhone13,4",
                "fee_estimates": null,
                "height_cm": 3.5,
                "id": 1776771,
                "images": null,
                "length_cm": 1,
                "main_image": "https://www.theiphonewiki.com/w/images/6/60/IPhone_12_Pro_Max.jpg",
                "material": null,
                "parent_code": null,
                "retail_price": 15999,
                "soh": 28,
                "title": "iPhone 12 Pro Max",
                "type": null,
                "updated_at": "2024-07-18T11:34:45.410Z",
                "weight_g": 0.545,
                "width_cm": 1.5
            },
            "rating_avg": 3.74,
            "rating_count": "91",
            "seller_id": "demo-connected-takealot",
            "seller_name": "Rocketship Retail",
            "stock_status": "lead_time",
            "total_competitors": 4,
            "updated_at": "2025-02-20T11:04:22.581Z",
            "url": "https://www.takealot.com/x/PLID93936608",
            "winning": false,
            "winning_delivery": false,
            "winning_price": 11032
        },
        {
            "competitiveness": "high",
            "created_at": "2025-02-20T11:04:22.564Z",
            "id": 50639,
            "last_seen_at": null,
            "offer_id": "DEMO-454eea17-3757-4e10-97c4-bd4dcc0908c3",
            "offer_price": 12399.2,
            "offer_status": "buyable",
            "product": {
                "barcode": "9454582562",
                "brand": "Apple",
                "code": "APL-IPH-28",
                "colour": "Blue",
                "created_at": "2024-07-18T11:34:45.405Z",
                "description": "Color Choices\n\nSilver\nGraphite\nGold\nPacific Blue\nBattery\n\nCurrent: 2,815mAh\nPower: 10.78Wh\nVoltage: 3.83V\nCameras\n\nFront: 12MP camera.\nRear: 12MP Wide camera.\nStorage Choices\n\n128GB\n256GB\n512GB\nCPU Specs\n\nCPU: T8101 \"A14 Bionic\"\nClock rate: 2.99 GHz\nCore Design: Apple Firestorm x 2 and Apple Icestorm x 4\nInstruction Set: ARMv8.5-A\nRAM: 6GB\nConnectivity and Wireless\n\nBluetooth 5.0\nNFC with reader mode\n802.11ax Wi-Fi 6 with 2x2 MIMO\nGigabit-class LTE with 4x4 MIMO and LAA\n5G (sub‑6 GHz and mmWave)\nBaseband Device: SDX55M\nFirmwares\n\nInitial firmware: 14.1 (18A8395)\nLatest public firmware: 15.5 (19F77)\nLatest beta firmware: 15.6 beta (19G5027e)\nFirmware Identifiers: iPhone13,3",
                "fee_estimates": null,
                "height_cm": 3.5,
                "id": 1776770,
                "images": null,
                "length_cm": 1,
                "main_image": "https://www.theiphonewiki.com/w/images/c/c0/IPhone_12_Pro.jpg",
                "material": null,
                "parent_code": null,
                "retail_price": 15499,
                "soh": 58,
                "title": "iPhone 12 Pro",
                "type": null,
                "updated_at": "2024-07-18T11:34:45.405Z",
                "weight_g": 0.545,
                "width_cm": 1.5
            },
            "rating_avg": 3.23,
            "rating_count": "65",
            "seller_id": "demo-connected-takealot",
            "seller_name": "Rocketship Retail",
            "stock_status": "in_stock",
            "total_competitors": 7,
            "updated_at": "2025-02-20T11:04:22.567Z",
            "url": "https://www.takealot.com/x/PLID93936608",
            "winning": false,
            "winning_delivery": true,
            "winning_price": 9835
        }
    ]
}