Working with data

Performance flags

Product reads enrich each item with media, pricing, related content, and more. On large catalogs you can skip the parts you don't need with opt-in hide_* flags.

Where they apply

These flags apply to GET/products/ and product search. They are opt-in: send nothing and the default (fully enriched) response is unchanged.

The aggregate flag

hide_extras=true turns off most expensive enrichments at once - ideal for admin grids, sync jobs, and bulk exports:

curl -s "https://api.readycms.io/products/?namespace=<tenant>&hide_extras=true&limit=500" \
  -H "Authorization: Bearer <app_id>:<app_secret>"

Granular flags

Flag	Skips
`hide_media=true`	Resolving poster / gallery / files into media objects (`poster_url` stays)
`hide_prices=true`	The price calculator (discounts + multicurrency); raw DB price columns remain
`hide_fields=true`	Headless fields (alias `hide_headless`)
`hide_linked=true`	Linked content enrichment
`hide_related=true`	Related products
`hide_meta_data`, `hide_author`, `hide_reviews`, `hide_stats`	The named enrichment
`hide_categories`, `hide_tags`, `hide_manufacturer`, `hide_attributes`, `hide_variations`, `hide_locations`, `hide_seo`	The named relation

Tip

Syncing thousands of products? Send hide_extras=true and page through the catalog. You get the core fields fast, without the per-row enrichment cost.

Reviews, stats, and related products are also gated by their own switches (reviews=true, stats=true, related=true) - the enrichment only runs when you ask for it.