Ontology for the product and promotion vocabulary a merchant feed carries, across the flat-file attribute set and the named object contracts the feed API states.
This generated publication specification records the reviewed service-local TypeSpec declarations, source field names, types, constraints, and enum wire values represented by the published RDF and SHACL artifacts.
This is an independently reviewed generated API ontology publication. It is regenerated from a clean Relay source commit; do not edit the imported specification or RDF artifacts by hand.
Service: chatgptcommerce; TypeSpec namespace: Chatgptcommerce; source revision: ada4be7cf8aae611e6709c4df8e975f06b19b557; versions: 1.
The TypeSpec source defines the API declaration. The RDFS/OWL graphs publish vocabulary semantics, SHACL publishes validation constraints, and the JSON-LD context publishes JSON term mappings. The source introspection is retained as independent replay evidence.
The service-local namespace contains 24 models with 158 declared fields, 8 enums with 23 wire values, 0 scalar aliases, and 0 named unions in compiler introspection. Shared framework declarations are available in the RDF artifacts but are excluded from these service-local counts.
These are deliberate limits of the RDF representation, not silently inferred semantics:
AmountOffBenefitTypeSpec name: Chatgptcommerce.AmountOffBenefit
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
amount_off |
Chatgptcommerce.Price |
required in source | — | Amount discounted. |
type |
Chatgptcommerce.AmountOffBenefitType |
required in source | — | Must be amount_off. |
AvailabilityTypeSpec name: Chatgptcommerce.Availability
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
available |
boolean |
optional | — | Indicates whether the variant is currently purchasable. |
status |
string |
optional | — | Fulfillment state when availability is reported, for example in_stock, backorder, preorder, out_of_stock, or discontinued. |
BarcodeTypeSpec name: Chatgptcommerce.Barcode
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
type |
string |
required in source | — | Barcode type. |
value |
string |
required in source | — | Barcode value. |
CategoryTypeSpec name: Chatgptcommerce.Category
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
taxonomy |
string |
optional | — | Taxonomy system used for the category value, such as google_product_category, shopify, or merchant. |
value |
string |
required in source | — | Category label or hierarchical path. |
ChatgptcommerceAuthAgentic Commerce Protocol bearer authentication. Feed endpoints are called with a bearer credential issued to the merchant integration. The flat-file path carries no request credential of its own: the feed is delivered over SFTP against separately issued access details. Neither is declared as an operation in this ontology-only contract.
TypeSpec name: Chatgptcommerce.ChatgptcommerceAuth
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
scheme |
"Bearer" |
required in source | — | bearer auth scheme |
type |
unknown |
required in source | — | Http authentication |
DateTimeRangeTypeSpec name: Chatgptcommerce.DateTimeRange
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
end_time |
string |
required in source | — | End timestamp. |
start_time |
string |
required in source | — | Start timestamp. |
DescriptionTypeSpec name: Chatgptcommerce.Description
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
html |
string |
optional | — | HTML description. |
markdown |
string |
optional | — | Markdown description. |
plain |
string |
optional | — | Plain-text description. |
FeedProductTypeSpec name: Chatgptcommerce.FeedProduct
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
accepts_exchanges |
boolean |
optional | — | Accepts exchanges |
accepts_returns |
boolean |
optional | — | Accepts returns |
additional_image_urls |
string |
optional | — | Extra images |
ads_metadata |
Record<string, string> |
optional | — | Ad metadata values |
age_group |
Chatgptcommerce.FeedProductAgeGroup |
optional | — | Target demographic |
age_restriction |
float64 |
optional | — | Minimum purchase age |
availability |
Chatgptcommerce.FeedProductAvailability |
required in source | — | Product availability |
availability_date |
plainDate |
optional | — | Availability date if pre-order |
base_measure |
string |
optional | — | Unit price and base measure |
brand |
string |
required in source | — | Product brand |
color |
string |
optional | — | Variant color |
condition |
string |
optional | — | Condition of product |
Custom_variant1_category |
string |
optional | — | Custom variant dimension 1 |
Custom_variant1_option |
string |
optional | — | Custom variant 1 option |
Custom_variant2_category |
string |
optional | — | Custom variant dimension 2 |
Custom_variant2_option |
string |
optional | — | Custom variant 2 option |
Custom_variant3_category |
string |
optional | — | Custom variant dimension 3 |
Custom_variant3_option |
string |
optional | — | Custom variant 3 option |
description |
string |
required in source | — | Full product description |
dimensions |
string |
optional | — | Overall dimensions |
dimensions_unit |
string |
optional | — | Dimensions unit |
expiration_date |
plainDate |
optional | — | Remove product after date |
gender |
string |
optional | — | Gender target |
geo_availability |
string |
optional | — | Availability per region |
geo_price |
string |
optional | — | Price by region |
group_id |
string |
optional | — | Shared group identifier |
gtin |
string |
optional | — | Universal product identifier |
height |
string |
optional | — | Individual dimension |
image_url |
url |
required in source | — | Main product image URL |
is_ads_eligible |
boolean |
optional | — | Controls whether the product can be processed for ChatGPT ads. Use is_eligible_ads only as a legacy alias. |
is_digital |
boolean |
optional | — | Indicates if the product is digital |
is_eligible_checkout |
boolean |
required in source | — | Allows direct purchase inside ChatGPT. is_eligible_search must be true for is_eligible_checkout to be enabled for the product. |
is_eligible_search |
boolean |
required in source | — | Controls whether the product can be surfaced in ChatGPT search results. |
item_group_title |
string |
optional | — | Group product title |
item_id |
string |
required in source | — | Merchant product ID (unique per variant) |
item_weight_unit |
string |
optional | — | Product weight unit |
length |
string |
optional | — | Individual dimension |
listing_has_variations |
boolean |
optional | — | Indicates whether listing has variants |
marketplace_seller |
string |
optional | — | Marketplace seller of record |
material |
string |
optional | — | Primary material(s) |
model_3d_url |
url |
optional | — | 3D model |
mpn |
string |
optional | — | Manufacturer part number |
offer_id |
string |
optional | — | Offer ID (SKU+seller+price) |
pickup_method |
Chatgptcommerce.FeedProductPickupMethod |
optional | — | Pickup options |
pickup_sla |
string |
optional | — | Pickup SLA |
popularity_score |
float64 |
optional | — | Popularity indicator |
price |
string |
required in source | — | Regular price |
pricing_trend |
string |
optional | — | Lowest price in N months |
product_category |
string |
optional | — | Category path |
q_and_a |
Array<Chatgptcommerce.QuestionAnswer> |
optional | — | FAQ content |
related_product_id |
string |
optional | — | Associated product IDs |
relationship_type |
Chatgptcommerce.FeedProductRelationshipType |
optional | — | Relationship type |
return_deadline_in_days |
int64 |
optional | — | Days allowed for return |
return_policy |
url |
optional | — | Return policy URL |
return_rate |
float64 |
optional | — | Return rate |
review_count |
int64 |
optional | — | Number of product reviews |
reviews |
Array<Chatgptcommerce.ProductReview> |
optional | — | Review entries |
sale_price |
string |
optional | — | Discounted price |
sale_price_end_date |
plainDate |
optional | — | Sale end date |
sale_price_start_date |
plainDate |
optional | — | Sale start date |
seller_name |
string |
optional | — | Seller name |
seller_privacy_policy |
url |
optional | — | Seller-specific policies |
seller_tos |
url |
optional | — | Seller-specific terms of service |
seller_url |
url |
optional | — | Seller page |
shipping |
string |
optional | — | Shipping information |
size |
string |
optional | — | Variant size |
size_system |
string |
optional | — | Size system |
star_rating |
string |
optional | — | Average review score |
store_country |
string |
optional | — | Store country of the item |
store_review_count |
int64 |
optional | — | Number of brand or store reviews |
store_star_rating |
string |
optional | — | Average store rating |
target_countries |
Array<string> |
required in source | — | Target countries of the item (first entry used) |
title |
string |
required in source | — | Product title |
unit_pricing_measure |
string |
optional | — | Unit price and base measure |
url |
url |
required in source | — | Product detail page URL |
variant_dict |
Record<string, string> |
optional | — | Variant attributes map |
video_url |
url |
optional | — | Product video |
warning |
url |
optional | — | Product disclaimers |
warning_url |
url |
optional | — | Product disclaimers |
weight |
string |
optional | — | Product weight |
width |
string |
optional | — | Individual dimension |
FreeShippingBenefitTypeSpec name: Chatgptcommerce.FreeShippingBenefit
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
type |
Chatgptcommerce.FreeShippingBenefitType |
required in source | — | Must be free_shipping. |
LinkTypeSpec name: Chatgptcommerce.Link
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
title |
string |
optional | — | Link title. |
type |
string |
required in source | — | Kind of destination, such as privacy_policy, terms_of_service, refund_policy, shipping_policy, or faq. |
url |
string |
required in source | — | Link destination URL. |
MeasureTypeSpec name: Chatgptcommerce.Measure
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
unit |
string |
required in source | — | Measure unit. |
value |
float64 |
required in source | — | Measure value. |
MediaTypeSpec name: Chatgptcommerce.Media
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
alt_text |
string |
optional | — | Alternate text. |
height |
int64 |
optional | — | Media height. |
type |
string |
required in source | — | Media type. |
url |
url |
required in source | — | Media URL. |
width |
int64 |
optional | — | Media width. |
PercentOffBenefitTypeSpec name: Chatgptcommerce.PercentOffBenefit
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
percent_off |
float64 |
required in source | — | Percentage discounted. |
type |
Chatgptcommerce.PercentOffBenefitType |
required in source | — | Must be percent_off. |
PriceTypeSpec name: Chatgptcommerce.Price
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
amount |
int64 |
required in source | — | Monetary amount expressed in ISO 4217 minor units. |
currency |
string |
required in source | — | Currency identifier. |
ProductTypeSpec name: Chatgptcommerce.Product
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
description |
Chatgptcommerce.Description |
optional | — | Product description content. |
id |
string |
required in source | — | Stable global identifier for this product. |
media |
Array<Chatgptcommerce.Media> |
optional | — | Product-level media assets. |
title |
string |
optional | — | Product title. |
url |
url |
optional | — | Canonical product URL. |
variants |
Array<Chatgptcommerce.Variant> |
required in source | — | Variants associated with the product. |
ProductReviewTypeSpec name: Chatgptcommerce.ProductReview
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
content |
unknown |
required in source | — | No source description. |
maxRating |
unknown |
required in source | — | No source description. |
minRating |
unknown |
required in source | — | No source description. |
rating |
unknown |
required in source | — | No source description. |
title |
unknown |
required in source | — | No source description. |
ProductTargetTypeSpec name: Chatgptcommerce.ProductTarget
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
product_id |
string |
required in source | — | Product targeted by the promotion. |
variant_ids |
Array<string> |
optional | — | Variants targeted within the product. |
PromotionTypeSpec name: Chatgptcommerce.Promotion
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
active_period |
Chatgptcommerce.DateTimeRange |
required in source | — | Start and end time for the promotion. |
applies_to |
Array<Chatgptcommerce.ProductTarget> |
optional | — | Products or variants targeted by the promotion. |
benefits |
Array<Chatgptcommerce.AmountOffBenefit | Chatgptcommerce.PercentOffBenefit | Chatgptcommerce.FreeShippingBenefit> |
required in source | — | Benefits applied by the promotion. |
description |
Chatgptcommerce.Description |
optional | — | Promotion description content. |
id |
string |
required in source | — | Promotion identifier. |
status |
string |
optional | — | Promotion status. |
title |
string |
required in source | — | Promotion title. |
url |
url |
optional | — | Canonical promotion URL. |
QuestionAnswerTypeSpec name: Chatgptcommerce.QuestionAnswer
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
a |
string |
required in source | — | No source description. |
q |
string |
required in source | — | No source description. |
ReferenceMeasureTypeSpec name: Chatgptcommerce.ReferenceMeasure
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
unit |
string |
required in source | — | Reference unit. |
value |
int64 |
required in source | — | Reference value. |
SellerTypeSpec name: Chatgptcommerce.Seller
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
links |
Array<Chatgptcommerce.Link> |
optional | — | Seller-related links. |
name |
string |
optional | — | Seller name. |
UnitPriceTypeSpec name: Chatgptcommerce.UnitPrice
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
amount |
int64 |
required in source | — | Unit price amount. |
currency |
string |
required in source | — | Currency code. |
measure |
Chatgptcommerce.Measure |
required in source | — | Measured quantity. |
reference |
Chatgptcommerce.ReferenceMeasure |
required in source | — | Reference quantity. |
VariantTypeSpec name: Chatgptcommerce.Variant
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
availability |
Chatgptcommerce.Availability |
optional | — | Availability state for the variant. |
barcodes |
Array<Chatgptcommerce.Barcode> |
optional | — | Variant barcode values. |
categories |
Array<Chatgptcommerce.Category> |
optional | — | Categories associated with the variant. |
condition |
Array<string> |
optional | — | Applicable item conditions. |
description |
Chatgptcommerce.Description |
optional | — | Variant description content. |
id |
string |
required in source | — | Stable global identifier for this variant. |
list_price |
Chatgptcommerce.Price |
optional | — | Reference price before any discount is applied. |
media |
Array<Chatgptcommerce.Media> |
optional | — | Variant media assets. The first entry is treated as primary. |
price |
Chatgptcommerce.Price |
optional | — | Active sale price for this variant. |
seller |
Chatgptcommerce.Seller |
optional | — | Seller metadata for the variant. |
title |
string |
required in source | — | Variant title. |
unit_price |
Chatgptcommerce.UnitPrice |
optional | — | Unit pricing metadata. |
url |
url |
optional | — | Variant URL. |
variant_options |
Array<Chatgptcommerce.VariantOption> |
optional | — | Set of option selections for the variant, such as color or size. |
VariantOptionTypeSpec name: Chatgptcommerce.VariantOption
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
name |
string |
required in source | — | Option name, such as color or size. |
value |
string |
required in source | — | Selected option value. |
AmountOffBenefitTypeValues AmountOffBenefit.type accepts.
TypeSpec name: Chatgptcommerce.AmountOffBenefitType
| Member | Wire value | Description |
|---|---|---|
amountOff |
amount_off |
No source description. |
FeedProductAgeGroupValues FeedProduct.age_group accepts.
TypeSpec name: Chatgptcommerce.FeedProductAgeGroup
| Member | Wire value | Description |
|---|---|---|
adult |
adult |
No source description. |
infant |
infant |
No source description. |
kids |
kids |
No source description. |
newborn |
newborn |
No source description. |
toddler |
toddler |
No source description. |
FeedProductAvailabilityValues FeedProduct.availability accepts.
TypeSpec name: Chatgptcommerce.FeedProductAvailability
| Member | Wire value | Description |
|---|---|---|
backorder |
backorder |
No source description. |
inStock |
in_stock |
No source description. |
outOfStock |
out_of_stock |
No source description. |
preOrder |
pre_order |
No source description. |
unknown |
unknown |
No source description. |
FeedProductPickupMethodValues FeedProduct.pickup_method accepts.
TypeSpec name: Chatgptcommerce.FeedProductPickupMethod
| Member | Wire value | Description |
|---|---|---|
inStore |
in_store |
No source description. |
notSupported |
not_supported |
No source description. |
reserve |
reserve |
No source description. |
FeedProductRelationshipTypeValues FeedProduct.relationship_type accepts.
TypeSpec name: Chatgptcommerce.FeedProductRelationshipType
| Member | Wire value | Description |
|---|---|---|
accessory |
accessory |
No source description. |
differentBrand |
different_brand |
No source description. |
oftenBoughtWith |
often_bought_with |
No source description. |
partOfSet |
part_of_set |
No source description. |
requiredPart |
required_part |
No source description. |
substitute |
substitute |
No source description. |
FreeShippingBenefitTypeValues FreeShippingBenefit.type accepts.
TypeSpec name: Chatgptcommerce.FreeShippingBenefitType
| Member | Wire value | Description |
|---|---|---|
freeShipping |
free_shipping |
No source description. |
PercentOffBenefitTypeValues PercentOffBenefit.type accepts.
TypeSpec name: Chatgptcommerce.PercentOffBenefitType
| Member | Wire value | Description |
|---|---|---|
percentOff |
percent_off |
No source description. |
VersionsTypeSpec name: Chatgptcommerce.Versions
| Member | Wire value | Description |
|---|---|---|
v1 |
v1 |
v1 baseline |
No service-local scalar aliases are declared.
No named service-local unions are declared.