Catalog reads

List the account's connected Shopify stores: id (the channel_id every other tool takes), name and merchant display name, shop domain, the source language and the published locales (translation targets are the published locales minus the primary one), plus the account capabilities that gate some entity types (online_store_content: blogs, articles, pages; discounts: the Discounts tools). Read this first to address stores by id.

No arguments.

List items of one type (products, collections, variants, blogs, articles, pages) as lean browse rows with the full browse filter vocabulary: search, sort, store presence (store_ids/store_mode), pending-publish and publish-failed flags, a parent (a product's variants, a blog's articles), structured filter conditions, and optional per-store field values (field_keys + field_channel_ids). Use list_masters_v1 for full-detail rows or the other entity types.

Search variants with the browse filter vocabulary and get the matches grouped under their parent product, paginated over the matched products. Each group carries the product row and only the variants that matched.

Search the whole catalog at once — products, variants, collections, files, content, markets, catalogs, metaobject entries and definitions — and get the top matches grouped per type (at most 5 per group, with the group's matched count). Each item matches on its OWN fields: a SKU hit surfaces the variant, not its product. Queries under 2 characters return no groups.

List the authored relationship links between per-store versions: media attachments (entity → file), catalog → market attachments, and catalog → product memberships. Filter by the source and/or target per-store version id. Each link carries its position and whether Shopify has confirmed it yet (pending_publish). Collection membership is never a link — read it with read_collection_membership_v1.

List the media attached to one per-store version of a product, variant, collection, or article, in gallery order: each attachment's link id and position, the file's identity and facts (filename, type, dimensions, readiness), its per-store alt text and Shopify media id, a preview URL, and whether the attachment is still awaiting publish.

List the entities whose metafields reference one metaobject entry, per store: the referencing entity, its type and parent, the field key that holds the reference, and its title. Capped at 200 rows per store (truncated_channel_ids names the stores that hit the cap).

Read Shopify-computed collection membership on one store, in either direction: the products a collection holds (direction products_of_collection) or the collections holding a product (collections_of_product). Pass master_id for one entity with the full member list, or master_ids (at most 20) for a bounded batch that names each entity's leading members and totals. Membership is computed by Shopify from the collection's sources — it is never stored here — so a cold read reaches Shopify live; a hand-picked membership still awaiting publish is reported with pending_publish.

• Extended timeout. 120 s per call — the operation runs server-side orchestration or a live Shopify read.
• Live Shopify read. Slower than PIM reads and can fail when Shopify is unavailable.

Get one metafield definition in full: identity (namespace.key, owner type), type and validations, category constraints, capability options, origin (custom or Shopify standard template), per-store presence, and per-store capability eligibility (read live from Shopify, so slower than the list).

• Live Shopify read. Slower than PIM reads and can fail when Shopify is unavailable.

Get one metaobject definition in full: type key, name, its field definitions (key, name, type, required, validations), per-store presence, entry count, capability flags (publishable, translatable, renderable, online store), any structure conflict between stores, and same-type duplicates.

List the account's own custom fields — PIM-only fields that never publish to Shopify — with their slug, the entity kind they apply to, type, options, formula, and optional metafield target. Values live on per-store versions under the key custom:<slug> and are written with update_projection_attributes_v1 or bulk_patch_v1. Pass id to read exactly one definition.

For one store and one Shopify taxonomy category, list the metafield definitions already enabled for that category on the store and Shopify's standard templates that could still be enabled. Paged with limit/cursor; when Shopify cannot be reached the enabled list still answers with available_error set.

• Live Shopify read. Slower than PIM reads and can fail when Shopify is unavailable.

Read the Shopify product taxonomy: pass category_id to get a category's attributes with their selectable values (for metafield values and collection conditions), or value_gids (1–100 gid://shopify/TaxonomyValue/… ids) to resolve value names. A shared public vocabulary, cached server-side; an unreachable Shopify answers degraded rather than failing.

• Live Shopify read. Slower than PIM reads and can fail when Shopify is unavailable.

Get the values already in use for autocomplete-style fields, keyed by field: for products the vendors and tags in use, for files the tags. Reuse these before inventing new spellings.

List the theme template suffixes one store's live theme offers for a resource kind (product, collection, page, blog, article) — the values a Template Suffix field may take; the empty suffix is the theme's default template. Reaches Shopify live.

• Live Shopify read. Slower than PIM reads and can fail when Shopify is unavailable.

Resolve stored reference values (metafield reference GIDs on one store, or PIM item ids from custom-field references) into the entities they name — name, type, thumbnail, and the identity behind each value. With target_channel_ids, instead translate the source store's GIDs into each target store's own GIDs for the same entities, so a reference can be copied to another store: a store absent from a value's map cannot reference it there. At most 200 values per call; a value that names nothing is simply omitted.

Search one store for entities a reference field can point at (products, variants, collections, files, metaobject entries) and get picker rows: the store-local GID the field stores, name, thumbnail, PIM identity, and the kind's detail facts (a product's status/vendor/type and leading SKUs, a collection's member count or automated flag, a file's kind). raw_count above the returned count means matches exist that are not published on this store. At most 50 rows.