Skip to main content
GET
Get Product

Authorizations

Authorization
string
header
required

Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.

Path Parameters

productId
string
required

Response

Success

variants
object[]
required

The product's non-deleted variants, oldest first, in the same row shape as GET /api/v1/products items. Empty for a simple product and when the requested product is itself a variant.

id
string
parentId
string | null
name
string
description
string
sku
string
brand
string | null
price
number | null
currency
string
status
string
statusFacets
object

Read-only product-wide state. Lifecycle status and derived quality/error signals are independent; this field is recalculated from current product, marketplace QC, and review flags.

images
object[]
excludedImages
object[]

Import image exclusions, with original source URLs, classification tags, matching filters, and reasons. Empty when no exclusion audit was saved.

highlights
string[] | null
marketplaces
object
inventory
object
weight
number | null
dimensions
object | null
seoTitle
string | null
seoDescription
string | null
tags
string[] | null
bundle
object | null
acoProfile
object | null

Current ACO/GEO profile metadata for the product. Null when no profile has been generated.

acoFaqs
object[]

Generated Agentic Commerce Optimization FAQs for the product, ordered by language then rank. Empty array when no ACO profile has been generated yet.

acoLocalizations
object[]

Localized ACO content by language, including intent descriptions, generated buyer intent queries, and cultural notes.

acoSignals
object[]

Normalized ACO retrieval and ranking signals extracted from the product profile.

acoIntentQueries
string[]

Deduplicated buyer intent queries aggregated from all ACO localizations.

acoCulturalNotes
object

Cultural notes keyed by language:country (example: en:sg). Uses global when no country scope is known.

acoSources
object[]

Citation/source records used by ACO trust enrichment.

acoClaims
object[]

Trust claims and citation URLs associated with the generated ACO profile.

createdAt
string

ISO 8601 timestamp

updatedAt
string

ISO 8601 timestamp