Response fields
Every field a listing object can return from the Eebz API, including trade-in and contract fields.
Each listing object returned by retailer listings can hold the fields below. Use fields in the request to return only the ones you need.
Listing fields
| Field | Type | Description |
|---|---|---|
country | string | Country code of the listing |
reseller.name | string | Retailer name |
reseller.url | string | Retailer URL |
sku.gtin | string | GTIN |
sku.alt_gtin | string | Alternative GTIN |
sku.full_name | string | Full SKU name |
sku.mpn | string | Manufacturer part number |
sku.alt_mpn | string | Alternative MPN |
sku.packaging | string | Packaging type, such as dvd, bundle or two_pack |
sku.attribute_id | Attribute ID | |
sku.product_name | Product name | |
sku.platform | Platform | |
sku.edition | Edition | |
sku.release_date | Release date | |
sku.importance | string | Importance rating, AAA to C |
sku.lifecycle | integer | Lifecycle stage |
sku.market_name | string | Market name |
sku.publisher_name | string | Brand name |
sku.industry_name | Industry name | |
sku.prices | array | Prices by territory (average, minimum, mode) |
sku.sku_attributes | SKU attributes | |
sku.product_attributes | Product attributes | |
link | string | URL of the listing |
price | string | Current price in local currency |
price_in_org_currency | string | Current price in your organisation's currency |
original_price | string | Original price or RRP |
original_price_in_org_currency | string | Original price in your organisation's currency |
timestamp | string | When the data was collected |
availability | string | Availability status |
country_currency | string | Currency code of the listing |
condition | string | Product condition |
lifecycle | string | Listing lifecycle stage |
gtin | string | GTIN shown on the listing |
canonical_url | string | Canonical URL |
mpn | string | MPN shown on the listing |
supplier_name | string | Supplier name |
retailer_category | string | Retailer's category |
retailer_category_parent | string | Parent category |
retailer_category_grandparent | string | Grandparent category |
rank | integer | Category rank |
review_no | string | Number of reviews |
review_score | string | Review score |
grade_a_price | string | Trade-in grade A price (trade-in extracts only) |
grade_b_price | string | Trade-in grade B price (trade-in extracts only) |
grade_c_price | string | Trade-in grade C price (trade-in extracts only) |
grade_d_price | string | Trade-in grade D price (trade-in extracts only) |
extract_types | string | Extract types behind this result |
contracts | array | Contract tariffs (contracts product only) |
Contract fields
contracts holds one object per tariff when the contracts product is switched on for your organisation.
| Field | Type | Description |
|---|---|---|
provider | string | Airtime provider |
type | Contract type | |
data_size | string | Data allowance |
minutes | string | Call minutes |
texts | string | Texts |
length | integer | Contract length in months |
device_price | string | Device price |
deposit_price | string | Upfront deposit |
monthly_price | string | Monthly price |
timestamp | string | When the contract was checked |
Last updated October 2026