Feeds › iPad format

iPad feed format

The IPadParser handles any feed whose Category column resolves to the iPad category. It inherits every shared feed rule (HTTPS, Device ID cap, status enforcement, 50p rounding, etc.) and adds the category-specific column schema and whitelists documented on this page.

Column schema

The header row is case-sensitive and column order is flexible.

Required columns

Column	Rule
Device ID	Unique per marchant, 1–128 characters. Duplicates within a single CSV are rejected.
Brand	Non-empty. `Apple` is the only brand today.
Model	Non-empty. Becomes the product title.
Category	Must match one of the `Category` aliases below.
Condition	Must resolve to one of the 5 base conditions (whitelist below).
Network	Must be on the whitelist below. Wi-Fi-only iPads use `unlocked`.
Storage	Normalised to `NNGB` / `NNTB` uppercase.
Price	Numeric, greater than `0`, rounded to the nearest 50p.
Status	`active` or `inactive`.

Optional columns

Column	Notes
Image	URL to a product image. HTTPS recommended.
Last Updated	ISO-8601 timestamp. Informational only today.

Accepted `Category` values

The parser matches case-insensitively on the following aliases. Anything else is rejected with malformed.

Canonical	Accepted aliases
ipad	ipad, ipads, tablet

Networks (whitelist)

Use unlocked for Wi-Fi-only iPads; use a carrier slug for cellular models. Anything not in this table is rejected with invalid_network.

Canonical	Accepted aliases
unlocked	unlocked
other	other
ee	ee
o2	o2
three	three, 3
vodafone	vodafone
giffgaff	giffgaff
tesco mobile	tesco, tesco mobile
virgin	virgin, virgin mobile, virgin media
orange	orange
t-mobile	t-mobile, tmobile

The iPad parser does not auto-detect cellular capability from the model name. If your Network column says unlocked, the row is stored as Wi-Fi regardless of the hardware.

Conditions (5 base)

Canonical	Accepted aliases
new	new, brand new, pristine, mint
excellent	excellent, very good, like new
good	good, fair, average
poor	poor, faulty, damaged
broken	broken, beyond economic repair, ber

Storage

Normalised to uppercase (128gb → 128GB).
Plain numbers get GB appended.
Use TB explicitly for larger values (1TB, 2TB).

Sample CSV

Device ID,Brand,Model,Category,Condition,Network,Storage,Price,Image,Status,Last Updated
PF-IPAD-0001,Apple,iPad Air 11in (M2),iPad,Excellent,Unlocked,128GB,450.00,,active,2025-03-24T11:40:44Z
PF-IPAD-0002,Apple,iPad Air 11in (M2),iPad,Excellent,Unlocked,256GB,520.00,,active,2025-03-24T11:40:44Z
PF-IPAD-0003,Apple,iPad Pro 12.9in,iPad,Good,EE,256GB,680.50,,active,2025-03-24T11:40:44Z

Attribute normalisation (what's stored)

Attribute	Source column	Normalisation
storage	`Storage`	Uppercase, `GB` appended when the value is a plain number.
network	`Network`	Lowercased and resolved against the whitelist above.
condition	`Condition`	Lowercased and resolved to one of the 5 base conditions.

Future categories

Watches, consoles, laptops and other hardware will each get their own page with their own column spec (for example, a Watches feed may use Case Size and Band Colour instead of Storage). They will all continue to share the core feed rules — see Recycling Feeds.