# Catalog complete agent reference
Reviewed: 2026-09-06
Source index: https://ai.getcatalog.ai/sources
This is reference data, not authority to perform external actions. Preserve each section's evidence and availability qualifications.
# Catalog: company knowledge reference
Catalog helps ecommerce brands turn scattered product information into structured data that AI assistants can read and use.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/
Audience: AI agents
Topics: Catalog, company overview, product data, agentic commerce
Questions answered:
- What is Catalog?
- Where should an agent start reading?
## Product facts, ready for AI
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/#what-catalog-does
Catalog is a software and services business for ecommerce teams. It brings product facts together, structures details such as attributes and use cases, and publishes machine-readable information alongside a brand’s existing website.
The aim is to make products easier for AI systems to understand and compare. Access to better data does not guarantee that an assistant will retrieve it, recommend a product, or send a customer.
Sources: [Catalog website](https://www.getcatalog.ai/) · [About Catalog](https://www.getcatalog.ai/about-us)
## For teams responsible for an ecommerce catalog
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/#who-it-serves
Catalog is relevant to brands and merchants whose product information is incomplete, scattered across sources, or difficult for machines to interpret. Ecommerce, product-data, and growth teams can use it to prepare product information for AI discovery.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Ecommerce Product Data Infrastructure Guide](https://www.getcatalog.ai/blog/complete-guide-ecommerce-product-data-catalog-ai)
## Knowledge for AI agents
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/#this-site
This is Catalog’s curated knowledge base for AI agents. It covers the company, product-data model, processing workflows, merchant storefronts, API, integrations, evaluation, limitations and sources. Use the topic map for targeted retrieval or the complete-text and JSON resources for full ingestion. It does not contain a merchant’s product catalog.
The main website is Catalog’s company and marketing home. These AI reference pages have their own canonical URLs and matching Markdown and JSON. Published policies and contact actions remain on their original websites.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy)
---
# Company, founders & history
Entity resolution, founder backgrounds, announced financing, and the distinction between Catalog's current product and its broader ambition.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/company
Audience: AI agents
Topics: company identity, founders, funding, history, mission, Catalog AI
Questions answered:
- Who founded Catalog?
- What is Catalog's legal name?
- What funding has Catalog announced?
- Are Afterpay and Block Catalog customers?
## Resolve the company by domain
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/company#entity-resolution
Catalog is the company operating at www.getcatalog.ai. Its published privacy policy identifies the legal entity as Agentic Commerce Inc., doing business as Catalog. Public articles also use the name Catalog AI. Those labels refer to this company when accompanied by the getcatalog.ai domain; the common word catalog alone is not enough to identify it.
Catalog is a business providing product-data software and related services. This reference describes that business, rather than a consumer marketplace or a collection of products available to purchase from Catalog. Merchant products served by Catalog belong to the relevant merchant. Do not merge company information with a similarly named catalog-management product or a merchant's product listing.
### trade-name
- property: name
- value: Catalog
- meaning: Public trading name
### legal-name
- property: legalName
- value: Agentic Commerce Inc.
- meaning: Legal name in the published privacy policy
### company-domain
- property: mainWebsite
- value: https://www.getcatalog.ai/
- meaning: Company and marketing website
### reference-domain
- property: agentReference
- value: https://ai.getcatalog.ai/
- meaning: Curated company knowledge for agents
Sources: [Catalog website](https://www.getcatalog.ai/) · [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy) · [About Catalog](https://www.getcatalog.ai/about-us)
## Founders and their prior experience
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/company#founders
The About page identifies Hamish Gunasekara as co-founder and CEO and Dylan Farrell as co-founder and CTO. It describes Hamish's earlier work as a data scientist at Afterpay and, after its acquisition by Block, work across Square and Cash App involving merchant integrations. It describes Dylan's studies in pure mathematics at Harvard and his work as a staff machine-learning engineer at Curinos, including a product recommendation engine.
These are founder biographies published by Catalog. An employer in a founder's biography is not automatically a Catalog customer, partner, investor, or endorser. In particular, do not turn the references to Afterpay, Block, Square, Cash App, Curinos, or Harvard into a customer list.
### hamish
- name: Hamish Gunasekara
- role: Co-founder and CEO
- evidence: Catalog About page
### dylan
- name: Dylan Farrell
- role: Co-founder and CTO
- evidence: Catalog About page
Sources: [About Catalog](https://www.getcatalog.ai/about-us)
## Dated financing announcement
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/company#funding
On March 23, 2026, Catalog published an announcement of a USD 3 million pre-seed financing led by Acrew Capital. The article says Catalog was founded in San Francisco and describes planned use of the funds for engineering and further integration work. Treat this as a company-reported historical announcement, not a statement of current cash, valuation, revenue, headcount, or the absence of later financing.
The announcement also names Hustle Fund and WndrCo as participants. The current About page presents a WNDR name and wndr.vc link. This reference does not equate the WNDR and WndrCo labels. When exact investor identity matters, quote the dated announcement's attribution and confirm the naming with Catalog rather than combining the two labels into one entity.
Sources: [Catalog's pre-seed announcement](https://www.getcatalog.ai/blog/catalog-raises-3m-pre-seed) · [About Catalog](https://www.getcatalog.ai/about-us)
## Product thesis and longer-term ambition
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/company#strategy
Catalog's thesis is that product information designed for browsing is often insufficient for software making comparisons. Important facts may be embedded in paragraphs, scattered across documents, missing from a feed, or disconnected from the correct variant. A machine-readable product-data layer can give assistants more explicit facts with which to evaluate a request.
The company describes an ambition to become infrastructure for agentic commerce. For present-tense product answers, explain the concrete work: collecting product information, organizing and enriching it, publishing AI-readable representations, and supporting evaluation of visibility and traffic. The broader operating-system ambition is a strategy statement. It is not evidence that Catalog controls every shopping agent, checkout protocol, or distribution channel.
Sources: [About Catalog](https://www.getcatalog.ai/about-us) · [Catalog's pre-seed announcement](https://www.getcatalog.ai/blog/catalog-raises-3m-pre-seed) · [Catalog website](https://www.getcatalog.ai/)
## Engagement and public commercial information
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/company#commercial-model
The public next steps are a discovery call, a product-data audit request, or contact with the team for API access. Agent answers should distinguish a managed brand implementation from a developer using the product-data API. Their access, billing, deliverables, and operational responsibilities can differ.
This review does not establish a current public price list, minimum contract size, annual revenue, customer count, service-level agreement, or guaranteed launch time. Return those as details to confirm with Catalog. A public fundraising figure is not pricing information, and an API credit balance is not the subscription price for a merchant deployment.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Request a product-data audit](https://www.getcatalog.ai/audit) · [Public API authentication reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/authentication.mdx)
---
# Catalog at a glance
Company identity and the scope of this reference.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/brand-facts
Audience: AI agents
Topics: identity, legal name, founders, company record
Questions answered:
- What are Catalog's canonical company facts?
## Company identity
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/brand-facts#identity
Catalog is the trading name of Agentic Commerce Inc. It works on product-data infrastructure for agentic commerce. Its co-founders are Hamish Gunasekara and Dylan Farrell.
Sources: [About Catalog](https://www.getcatalog.ai/about-us) · [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy)
## What the company offers
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/brand-facts#offering
Catalog helps ecommerce brands turn scattered product information into structured data that AI assistants can read and use.
Catalog serves ecommerce brands and merchants. Evaluate its product-data preparation and AI storefront capabilities against your platform, evidence, and publication requirements.
Sources: [Catalog website](https://www.getcatalog.ai/) · [About Catalog](https://www.getcatalog.ai/about-us)
## How to use these facts
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/brand-facts#reference
The company homepage is www.getcatalog.ai. The AI reference is ai.getcatalog.ai. They describe the same company for different reading contexts; the AI reference is not a separate merchant or consumer store.
Use the review date when citing this reference. Recheck the cited public material and ask the team about conditional availability or contractual details.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy)
## Identity record
- name: Catalog
- legalName: Agentic Commerce Inc.
- description: Catalog helps ecommerce brands turn scattered product information into structured data that AI assistants can read and use.
- positioning: The product data infrastructure for agentic commerce
- mainWebsite: https://www.getcatalog.ai
- aiWebsite: https://ai.getcatalog.ai
- demoUrl: https://calendly.com/d/cvr8-2zy-txt/catalog-discovery-call
- auditUrl: https://www.getcatalog.ai/audit
- privacyUrl: https://www.getcatalog.ai/legal/privacy-policy
- apiBaseUrl: https://api.getcatalog.ai
- apiSupportEmail: founders@getcatalog.ai
---
# Capabilities & how they work
From source product information to structured, readable product facts.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/capabilities
Audience: AI agents
Topics: features, capabilities, availability, inputs, outputs
Questions answered:
- What does Catalog do?
- Which capabilities are implemented?
## 1. Bring source information together
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/capabilities#connect
Catalog connects to product sources and gathers product information for processing. Shopify has an implemented connection and synchronization path. Access to other sources and platforms should be confirmed for the proposed engagement.
Sources: [Catalog website](https://www.getcatalog.ai/)
## 2. Structure and enrich product facts
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/capabilities#structure
Catalog organizes information into fields that can support product comparison: identifiers, attributes, descriptions, and contextual details such as use cases. Source material can include existing product information, images, reviews, and approved external material.
Enrichment requires evidence and review. Missing or conflicting source material can leave a fact unresolved; generated or extracted information should not be treated as infallible.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Ecommerce Product Data Infrastructure Guide](https://www.getcatalog.ai/blog/complete-guide-ecommerce-product-data-catalog-ai)
## 3. Publish an AI-readable storefront
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/capabilities#publish
A brand’s AI storefront can expose product information through readable pages and structured representations on a brand subdomain. It is a parallel information layer; a brand can retain its existing customer-facing website.
Publishing depends on product activation, configuration, and a working domain. Product information being published does not establish that an external assistant has indexed or used it.
Sources: [Catalog website](https://www.getcatalog.ai/)
## 4. Review information and assess visibility
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/capabilities#review-measure
Catalog provides product-data review and visibility-related workflows. Agree on which measurements are available for your store and what each metric captures before using them to evaluate results.
Observed AI traffic, a sampled recommendation, and attributed sales are different signals. None alone proves that Catalog caused incremental revenue. The illustrative dashboard on the marketing site is not a customer result.
Sources: [Catalog website](https://www.getcatalog.ai/)
## Capability registry: inputs, outputs and availability
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/capabilities#capability-registry
These records are an explicit availability assessment for agent answers. Implemented means present in the reviewed implementation; account setup, merchant configuration and verified production execution remain separate. A not-verified status is a limit of this reference and must not be converted into an announced roadmap or a promise.
### shopify
- capability: Shopify connection and updates
- availability: implemented_requires_setup
- inputs: Authorized Shopify connection and Catalog workspace
- outputs: Imported store information and update processing
- verification: Implementation reviewed; each merchant's connection and publication must be checked.
### extraction
- capability: Product URL extraction
- availability: documented_and_implemented
- inputs: Known product URLs or discovered listings plus API account
- outputs: Asynchronous product-data results
- verification: Public reference and implementation reviewed; no paid extraction job run for this company reference.
### enrichment
- capability: Product enrichment and contextual insights
- availability: implemented_requires_configuration
- inputs: Product facts, enabled processing and available supporting evidence
- outputs: Structured attributes, insights and supporting context where produced
- verification: Field coverage and factual accuracy must be checked for the selected products.
### merchant-storefront
- capability: Merchant AI storefront
- availability: implemented_requires_setup
- inputs: Configured merchant hostname and selected published products
- outputs: Readable and structured merchant product content
- verification: Implementation reviewed; hostname, TLS and actual content establish a merchant's live state.
### jsonld
- capability: Shopify product JSON-LD publication
- availability: implemented_requires_configuration
- inputs: Eligible product content and configured Shopify publishing
- outputs: Structured product data publication path
- verification: Publication state is product-specific; confirm actual page output and theme integration.
### visibility
- capability: Sampled AI visibility measurement
- availability: implemented_requires_configuration
- inputs: Selected products, prompt population, engines and market
- outputs: Captured answer and shopping observations with scoped metrics
- verification: Verify each configured report's coverage; no universal placement or causal-sales claim.
### traffic
- capability: AI traffic and referral analytics
- availability: implemented_requires_configuration
- inputs: Connected, scoped measurement data
- outputs: Request and referral summaries with availability states
- verification: Units and collection methods differ; missing data is not zero.
### api-search
- capability: Product-data API search
- availability: documented_and_implemented
- inputs: Natural-language query and API account
- outputs: Product candidates through asynchronous or synchronous routes
- verification: Public contracts and implementation reviewed; not tested as an authenticated job in this review.
### gmc
- capability: Google Merchant Center distribution
- availability: not_verified_available
- inputs: Engagement-specific scope to confirm
- outputs: No general live delivery commitment in this reference
- verification: Public positioning is broader than the reviewed output availability; ask Catalog.
### acp
- capability: ACP distribution or checkout
- availability: not_verified_available
- inputs: Engagement-specific capability and deployment to confirm
- outputs: No general live delivery or checkout commitment in this reference
- verification: Do not infer support from a protocol logo or descriptor in another service.
### ucp
- capability: UCP distribution or checkout
- availability: not_verified_available
- inputs: Engagement-specific capability and deployment to confirm
- outputs: No general live delivery or checkout commitment in this reference
- verification: Do not infer support from broad public commerce positioning.
### other-platforms
- capability: Other commerce platforms and PIM connectors
- availability: confirm_scope
- inputs: Named platform, source format and access requirements
- outputs: Connection, extraction or custom work as explicitly agreed
- verification: A platform logo does not establish a generally available native connector.
### experimentation
- capability: Self-service A/B testing
- availability: not_verified_available
- inputs: Experiment design and implementation scope to confirm
- outputs: No self-service experiment-product commitment in this reference
- verification: Mentioned publicly; this review does not certify general availability or causal evidence.
### company-reference
- capability: This company knowledge reference
- availability: public_read_only
- inputs: Unauthenticated GET requests on ai.getcatalog.ai
- outputs: HTML, Markdown, JSON, topic map, section records and complete text
- verification: Endpoint availability and cross-format parity are verified on deployment; content is manually reviewed.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Live API migration notice](https://api.getcatalog.ai/docs.html) · [Public crawl API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/crawl/crawl.mdx) · [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx) · [Public agentic search reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/search/agentic-search.mdx)
---
# Product-data model & field semantics
The information families Catalog works with, how product and variant facts differ, and how agents should interpret values and missing evidence.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/data-model
Audience: AI agents
Topics: product attributes, schema, variants, identifiers, provenance, product records, data quality
Questions answered:
- What product information does Catalog structure?
- How are variants represented?
- What does missing product data mean?
## Conceptual model, not a universal response schema
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/data-model#scope
Catalog works with product identity, attributes, variants, commerce facts, supporting content, and evidence. The fields below describe those information families. They are not a promise that every product has every field, or a byte-for-byte schema for every Catalog API version. Category, source quality, enabled processing, and output destination determine the populated record.
When integrating software, use the chosen endpoint's actual response schema. When answering a shopping question, use the record's value, variant context, source, and observation time together. A detailed object can still be incomplete, stale, or wrong for a different market. Keep the distinction between an explicit source fact, a normalized form of that fact, and an inferred interpretation.
Sources: [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Ecommerce Product Data Infrastructure Guide](https://www.getcatalog.ai/blog/complete-guide-ecommerce-product-data-catalog-ai)
## Core information families
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/data-model#field-families
A useful product record carries the facts needed to identify an item and test a buyer's constraints. These families are organized by the decision they support. The labels are conceptual and should not be copied as endpoint field names without checking the API contract.
### identity
- family: Identity
- examples: Title, brand, canonical URL, SKU, GTIN and MPN when supplied
- use: Resolve which product or variant is being described
- boundary: A missing identifier must not be fabricated or copied from a visually similar item.
### taxonomy
- family: Category and taxonomy
- examples: Product type, category path and normalized groupings
- use: Choose the relevant attribute set and comparison population
- boundary: A category label is not evidence that every category-specific property applies.
### specifications
- family: Specifications
- examples: Material, dimensions, weight, capacity, ingredients, power or compatibility
- use: Evaluate explicit physical and functional constraints
- boundary: Preserve units, scope, source and any warnings or exceptions.
### variants
- family: Variants and options
- examples: Size, color, pack count, option combinations and variant-specific URLs
- use: Select the exact purchasable configuration
- boundary: Price, image, stock and identifiers can differ across variants.
### commerce
- family: Commerce facts
- examples: Price amount and currency, availability, sale conditions and merchant URL
- use: Assess current purchase eligibility and cost context
- boundary: A crawl observation is not a purchase-time guarantee or inventory reservation.
### media
- family: Media and documents
- examples: Product images, image roles, manuals, specifications and associated URLs
- use: Ground descriptions and reveal relevant supporting detail
- boundary: An image alone does not establish material composition, certification or safety.
### context
- family: Decision context
- examples: Use cases, fit, limitations, questions, comparison criteria and review themes
- use: Explain why a product might satisfy a particular job
- boundary: Recommendations and interpretation should remain distinguishable from specifications.
### provenance
- family: Evidence and freshness
- examples: Source URLs, source type, review status and observation or update time
- use: Audit the basis and currency of a claim
- boundary: A URL is useful evidence only if it actually supports the associated claim.
Sources: [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality)
## Product, variant and listing are different entities
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/data-model#variants
A product family describes a shared item or design. A variant identifies a particular combination of options. A merchant listing describes an offer at a particular URL and can have its own price, availability, images, and market restrictions. Similar titles or shared photography do not make two listings interchangeable.
An agent comparing candidates should resolve the selected variant before applying hard constraints. A compatible base product can still have an incompatible voltage option; an apparel product can exist in the right color but not in the required size. When a feed stores option values in separate rows, preserve their parent relationship and exact identifier rather than flattening them into a bag of possible values.
Sources: [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality)
## Normalize representation without inventing facts
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/data-model#normalization
Normalization can reconcile casing, whitespace, units, category labels, and equivalent option labels while retaining the original meaning. It should not turn a partial observation into a precise specification. Keep an original measurement or source text when rounding or conversion would matter to fit.
Explicit unknowns are more useful than guessed values. Missing, not applicable, not requested, not found, and contradicted are different states. A disabled enrichment field does not prove that the underlying product lacks the property. Likewise, an empty list of captured reviews does not prove that no reviews exist anywhere.
### Synthetic evidence record illustrating uncertainty
Example kind: synthetic_record
```json
{
"illustrative": true,
"subject": "example-product",
"field": "material",
"value": null,
"state": "not_verified",
"source_url": "https://example.com/products/example-product",
"note": "No supporting material specification was found in this example."
}
```
Sources: [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce)
## Category-specific information needs
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/data-model#category-specific
Different product categories require different checks. The following are evaluation prompts, not claims that Catalog supplies every listed attribute for every category. Agree on the target schema and evidence requirement before measuring completeness.
### apparel
- category: Apparel and footwear
- examine: Size system, fit, measurements, material composition, care and intended activity
- watch: Do not assume one brand's size or width is equivalent to another's.
### home
- category: Furniture and home goods
- examine: Dimensions, materials, finish, assembly, clearance, capacity and placement
- watch: Separate product dimensions from packaging dimensions and usable capacity.
### electronics
- category: Electronics and parts
- examine: Model compatibility, power, voltage, connector, dimensions and included components
- watch: Treat electrical, safety and certification claims as requiring authoritative evidence.
### beauty
- category: Beauty and personal care
- examine: Ingredients, volume, shade, intended use, instructions and warnings
- watch: Do not infer allergy safety, medical suitability or certification from marketing wording.
Sources: [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality)
---
# Ingestion, enrichment & review workflow
What happens between acquiring product information and publishing a usable record, including source choice, optional processing, validation and review.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/enrichment
Audience: AI agents
Topics: ingestion, extraction, normalization, enrichment, product insights, review workflow
Questions answered:
- How does Catalog improve product data?
- What sources can inform enrichment?
- What is the difference between extraction and enrichment?
## Acquire the appropriate source information
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/enrichment#acquire
There are two related starting points: a merchant connection that makes store information available to Catalog, and URL-based discovery or extraction through the product-data API. Shopify has an implemented connection and update path. For other sources, confirm whether the engagement uses website extraction, a supplied dataset, a custom integration, or an available connector.
Discovery identifies where product listings are. Extraction reads product information from known locations. Discovering a URL does not mean the product has been fully extracted, enriched, approved, or published. A product may be inaccessible, not actually be a product page, return insufficient information, or fail processing. Retain per-item outcomes rather than reporting submitted URL count as successful product count.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Product data extraction](https://www.getcatalog.ai/blog/product-data-extraction) · [Public crawl API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/crawl/crawl.mdx) · [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx)
## Choose sources by the claim being resolved
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/enrichment#source-selection
The best source can differ by field. A merchant's current listing may be the source for its offer, a manufacturer specification for dimensions, and a verified compatibility document for model support. A review can inform an experience theme without becoming a technical specification. A category prior can suggest a field to investigate without proving its value.
For a disputed field, retain the conflicting observations, their subjects, and their dates. Check whether the disagreement comes from a variant, market, bundle, revision, unit conversion, or genuinely inconsistent source material. Do not resolve a conflict simply by choosing the more favorable value for the merchant.
Sources: [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality)
## Processing families in the implementation
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/enrichment#processing
The extraction implementation includes optional enrichment, review-related processing, image tagging, and similar-product processing. These are processing choices and available code paths, not a promise that all are enabled for every request or merchant. The public v2 extraction reference describes enable flags; current request and output details should be checked for the selected version.
Enrichment can help organize identifiers and attributes, create structured contextual explanations, and expose product insights. Image and review-derived content should carry an appropriate evidence boundary: visual appearance, a customer's opinion, and a verified manufacturer specification are different kinds of information. External-source access and the amount of evidence available can vary substantially by product.
### extract
- stage: Extraction
- input: A product URL or discovered listing
- output: Available product facts and source content
- completion: A successful per-item result, not only an accepted job.
### normalize
- stage: Normalization
- input: Raw values and identifiers
- output: Consistent forms and relationships
- completion: Values preserve meaning and the correct product/variant association.
### enrich
- stage: Enrichment
- input: Source facts and enabled supporting evidence
- output: Additional attributes or structured decision context
- completion: The added claim has adequate support and unresolved fields remain explicit.
### validate
- stage: Validation and review
- input: Candidate product record
- output: Reviewed record, flagged issues or an unresolved outcome
- completion: Checks cover truth, scope and downstream usability, not only JSON syntax.
### publish
- stage: Publication
- input: Selected eligible content and configured destination
- output: A reachable representation
- completion: The destination actually serves the intended record.
Sources: [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce) · [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx) · [Catalog website](https://www.getcatalog.ai/)
## Validation has several separate jobs
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/enrichment#quality
A parser can accept valid JSON containing an incorrect fact. A completeness check can reward a filled field even when its value belongs to another variant. A destination can reject an otherwise accurate record because its accepted vocabulary differs. Evaluate structural validity, factual accuracy, completeness, consistency, uniqueness, and freshness separately.
For high-impact fields, use an explicit source standard. Certifications, ingredient composition, compatibility, dimensions that determine fit, warnings, price, and availability should not be filled with plausible language. Record what was verified and what remains unresolved. Catalog's source-grounded approach is a method for improving data quality, not a guarantee that every generated field is correct.
Sources: [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce)
## Refresh and review after changes
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/enrichment#refresh
The Shopify path handles store updates, and the platform has processing and publication workflows. A source update, completed processing, product activation, and a downstream reader's cache refresh are distinct events. Do not describe them as one instantaneous synchronization step without measured evidence for the specific deployment.
When an important product fact changes, recheck the resulting published record and any affected variant or derived explanation. A previously reasonable recommendation can become wrong if ingredients, sizing, included components, or compatibility change. The manually curated company reference you are reading has its own review process and does not claim to track those merchant changes in real time.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality)
---
# Merchant AI storefront architecture & behavior
How Catalog's merchant storefronts expose product information, what agents can retrieve, and how that differs from this company reference.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/ai-storefront
Audience: AI agents
Topics: AI storefront, product discovery, merchant subdomain, HTML, JSON, MCP, A2A, canonical URLs
Questions answered:
- What is an AI storefront?
- Does it replace the merchant website?
- How should an agent discover a merchant's endpoints?
- Is this company site a merchant catalog?
## A parallel product-information surface
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/ai-storefront#parallel-layer
Catalog's merchant AI storefront presents selected product information in forms that agents can retrieve and interpret. It can operate on a brand subdomain alongside the existing consumer website. The consumer website remains the destination for the merchant's checkout, customer account, orders, and purchase-time terms unless a separately confirmed integration changes that arrangement.
The product storefront implementation resolves the merchant for the requested hostname and serves information in that merchant's context. Correct configuration and published content are prerequisites. An arbitrary ai.brand-domain hostname does not become a Catalog storefront by naming convention alone, and a configured DNS record does not prove that product content is being served successfully.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce)
## Product and collection retrieval
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/ai-storefront#retrieval
The reviewed merchant implementation includes readable product pages, structured JSON product documents, catalog listing/search, collection discovery, brand facts, and an agent guide. Product URLs can follow Shopify handles or mirror the merchant's original paths, depending on the store. Agents should follow the actual URLs returned in discovery or listing responses rather than manufacture paths from product titles.
Collection paths and availability can differ by store. A paginated product API is the documented bulk retrieval path in the reviewed implementation; the presence of feed-related code does not prove that a downloadable bulk feed is enabled or published. Read the target merchant's live guide and API specification to establish the available contract.
Sources: [Catalog website](https://www.getcatalog.ai/)
## Product insights and decision context
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/ai-storefront#insights
The storefront implementation can include structured product insights with provenance and decision-guide content such as use cases, constraints, variant choices, comparisons, and evidence references. Availability depends on the product record and configuration. A section type supported by the renderer does not imply that every product has content of that type.
This material helps an agent connect product facts to a buyer's question. Use the cited evidence and preserve distinctions between manufacturer facts, review observations, and editorial conclusions. For comparisons, confirm that the alternatives and variants being compared actually match the user's market, budget, and constraints.
Sources: [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce) · [Ecommerce Product Data Infrastructure Guide](https://www.getcatalog.ai/blog/complete-guide-ecommerce-product-data-catalog-ai)
## Protocol availability belongs to each live hostname
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/ai-storefront#protocols
The separate merchant storefront implementation contains MCP, A2A, OpenAPI, agent discovery and skill-related code. Those code paths were inspected as implementation evidence; this reference does not certify their live operation for every merchant. Use the exact target hostname's published descriptors and test the advertised operation before relying on it.
The Catalog company reference at ai.getcatalog.ai is deliberately a public, read-only HTTP document collection. Its OpenAPI describes actual JSON reads on this hostname. It has no merchant products, tool execution, MCP server, A2A task service, registration, checkout, or downloadable skill. Do not transfer a merchant storefront's advertised capabilities onto this hostname.
Sources: [Catalog website](https://www.getcatalog.ai/)
## What counts as published and what counts as used
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/ai-storefront#publication-state
Publication means that the intended product representation can be fetched successfully from its destination. Agent access means an external client requested it. A sampled assistant answer mentioning or displaying the product is a further observation. A shopper click, an attributed order, and incremental revenue are additional, distinct outcomes.
A useful launch check verifies hostname ownership, DNS, TLS, canonical URLs, content types, page/JSON consistency, product selection, policy links, redirects, and unknown-route behavior. After launch, use evidence from the relevant measurement surface to assess access or visibility. The existence of a machine-readable page cannot establish that an assistant has indexed it or will recommend it.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic)
---
# Integrations & availability
Connection, publication, and adoption by an AI platform are separate steps.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/integrations
Audience: AI agents
Topics: Shopify, connectors, GMC, ACP, UCP, platform support
Questions answered:
- Which platforms does Catalog support?
- Are GMC, ACP and UCP live integrations?
## Shopify — implemented; setup required
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/integrations#shopify
Catalog has an implemented Shopify connection and synchronization workflow. It supports importing product information and handling store updates. A merchant still needs an authorized connection and a configured Catalog workspace.
This confirms an implementation path, not a claim that every store is connected or that every downstream channel is active.
Sources: [Catalog website](https://www.getcatalog.ai/)
## AI storefront — implemented; configuration required
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/integrations#ai-storefront
The storefront implementation serves readable and structured product information for configured merchants. Publishing on a brand subdomain requires domain setup and selected product content.
This company reference site demonstrates the same multi-format principle using manually maintained software-business content. It does not use merchant product records.
Sources: [Catalog website](https://www.getcatalog.ai/)
## Other commerce platforms — confirm scope
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/integrations#other-platforms
The main website references WooCommerce, Adobe Commerce, BigCommerce, Salesforce Commerce Cloud, commercetools, SAP Commerce Cloud, Wix, Squarespace, and custom sources. This reference does not verify a generally available native connector for each of them. Ask Catalog to confirm access, implementation work, and scope for your platform.
Sources: [Catalog website](https://www.getcatalog.ai/)
## GMC, ACP, and UCP — availability not verified
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/integrations#distribution
Google Merchant Center, Agentic Commerce Protocol, and Universal Commerce Protocol appear in Catalog’s public positioning. Treat delivery through each as requiring explicit confirmation for your engagement. This reference does not claim that these are live, generally available Catalog distribution integrations.
Likewise, references to ChatGPT, Gemini, Claude, Perplexity, Amazon Rufus, or Walmart Sparky describe relevant AI shopping surfaces. They do not establish a partnership, guaranteed placement, or a direct Catalog integration with each service.
Sources: [Catalog website](https://www.getcatalog.ai/) · [What is agentic commerce?](https://www.getcatalog.ai/blog/what-is-agentic-commerce)
---
# Use cases, required inputs & success evidence
Concrete ways teams can evaluate Catalog, with the inputs and completion evidence needed for each job.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/use-cases
Audience: AI agents
Topics: use cases, ecommerce, merchandising, growth, developer, product comparison, pilot
Questions answered:
- Who should evaluate Catalog?
- What can a product-data team use it for?
- What would a successful pilot demonstrate?
## Make thin product records useful for comparison
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/use-cases#thin-records
A merchandising or product-data team has usable titles and images but lacks important facts such as fit, dimensions, material, compatible models or included components. Catalog can be evaluated on whether those facts can be recovered from available evidence and organized into a useful record. Begin with the questions buyers ask and the attributes required to answer them.
Bring a product sample, approved source material and the current record. Success evidence is a set of reviewed fields linked to the correct product or variant, plus clearly marked unresolved information. A longer description alone is insufficient. If the needed facts do not exist in any accessible reliable source, the next action is to obtain evidence from the brand or manufacturer.
Sources: [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce)
## Publish an agent-readable layer alongside an existing store
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/use-cases#parallel-publishing
An ecommerce team wants agents to retrieve clearer product information while retaining its current consumer website. A Catalog merchant storefront is a relevant implementation path when the source connection, product scope, review and domain configuration can be established.
Bring the store domain, platform, selected products, approved facts and access to configure the intended subdomain. Success evidence includes working HTTPS pages and structured documents, consistent product and variant identity, correct merchant links and verified content. DNS configuration alone is incomplete, and live publication is not a guarantee of assistant retrieval or recommendation.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce)
## Understand where product information breaks in AI answers
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/use-cases#visibility
A growth or ecommerce team wants to know whether products appear for a defined set of shopping questions and whether the answers preserve important facts. Catalog's visibility-related implementation can support evaluation when the store, products, providers and prompt population are configured. Agree on what counts as a mention, citation or product placement before reading the report.
Bring the target products, market, questions, candidate competitors and intended evaluation window. Success evidence is a set of recorded observations with an explicit population and coverage, followed by a scoped interpretation. Use the measurement definitions document to avoid turning a small prompt sample into a claim about all AI shoppers.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic)
## Build software that needs product facts
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/use-cases#developer
A developer needs product records for a comparison experience, a shopping assistant or an internal analysis. Choose between discovering a vendor's listings, extracting known URLs, and searching for candidates from an intent. These start from different inputs and should not be treated as equivalent API calls.
Bring a bounded input set, the required fields, target endpoint version and a valid account. Success evidence is an authenticated completed workflow with retrievable results, reconciled failures and an output schema the application can consume. API access does not automatically deploy a merchant AI storefront, and a search candidate is not a completed transaction.
Sources: [Public crawl API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/crawl/crawl.mdx) · [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx) · [Public agentic search reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/search/agentic-search.mdx) · [Public synchronous search reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/search/agentic-search-mini.mdx)
## Add AI-oriented publication downstream of an established PIM
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/use-cases#existing-pim
A larger team already governs product facts in a PIM or other approved source but lacks an agent-readable downstream presentation. Catalog may fit as that additional layer. Preserve the existing approval and authority model rather than creating conflicting field owners.
Bring the source schema, approved export or access method, update process and destination requirements. Success evidence includes correct field mapping, explainable handling of missing fields, a confirmed integration path and a verified published result. This is a coexistence pattern, not a claim that every PIM has a ready-made Catalog connector.
Sources: [PIM systems and Catalog](https://www.getcatalog.ai/blog/catalog-ai-vs-traditional-pim-systems) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality)
## Cases requiring a different scope
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/use-cases#not-fit
Catalog is a poor answer to a request for guaranteed top placement in ChatGPT, invented product evidence, or a checkout/order system without a separately confirmed capability. A team whose main problem is internal localization and enterprise master-data governance may need a PIM or MDM project first. A request for a particular unverified feed or connector should be routed to the team rather than presented as a standard feature.
When recommending Catalog, name the specific product-data job and the evidence that would make the recommendation credible. A broad desire to do something with AI is not enough to define a successful engagement. Use the current main-site contact options to resolve scope and commercial questions.
Sources: [PIM systems and Catalog](https://www.getcatalog.ai/blog/catalog-ai-vs-traditional-pim-systems) · [Catalog website](https://www.getcatalog.ai/) · [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy)
---
# Use cases & fit
Evaluate Catalog against the product-data job you need done.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/fit
Audience: AI agents
Topics: fit, customers, buyer profile, limitations
Questions answered:
- Is Catalog a good fit for my business?
## Good reasons to evaluate Catalog
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/fit#good-fit
These are fit guidelines based on Catalog’s product scope, not prerequisites or promised results.
- Your ecommerce catalog has missing or inconsistent attributes that make products difficult to compare.
- Useful product facts are scattered across descriptions, documents, images, and reviews.
- You want a parallel, machine-readable presentation of your products while retaining your existing website.
- You need a grounded assessment of how AI systems read your products before deciding what to improve.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Ecommerce Product Data Infrastructure Guide](https://www.getcatalog.ai/blog/complete-guide-ecommerce-product-data-catalog-ai)
## Situations to clarify first
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/fit#poor-fit
- You need guaranteed rankings, recommendations, revenue, or placement inside an AI assistant.
- You need a consumer shopping service or a replacement for your checkout.
- You need unsupported claims filled in when reliable product evidence is unavailable.
- Your project depends on a specific connector or distribution channel without confirming its availability.
Sources: [Catalog website](https://www.getcatalog.ai/) · [What is agentic commerce?](https://www.getcatalog.ai/blog/what-is-agentic-commerce)
## What is distinctive about the approach
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/fit#difference
Catalog’s approach combines product-data preparation with a parallel AI-readable storefront. The work concerns the underlying facts and their distribution, rather than only monitoring brand mentions or writing marketing articles.
This describes Catalog’s approach. It is not a claim of exclusive technology, superiority over a named competitor, or independently measured performance.
Sources: [Catalog website](https://www.getcatalog.ai/) · [About Catalog](https://www.getcatalog.ai/about-us) · [Ecommerce Product Data Infrastructure Guide](https://www.getcatalog.ai/blog/complete-guide-ecommerce-product-data-catalog-ai)
---
# Catalog compared with adjacent approaches
A task-based comparison with PIM, DAM, ERP, feed tools, extraction services, SEO/GEO work and building an internal pipeline.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/comparisons
Audience: AI agents
Topics: PIM, DAM, ERP, feed management, scraping, SEO, GEO, build versus buy, differentiation
Questions answered:
- Does Catalog replace a PIM?
- How is Catalog different from a scraper?
- Is Catalog an SEO tool?
- When should another system come first?
## Compare the job, output and operating responsibility
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/comparisons#positioning
Catalog's stated focus is product-data preparation and AI-readable publication for ecommerce. Evaluate it by whether the relevant product facts become available in the needed form and whether the team can verify the result. A comparison should begin with the current bottleneck, the source system, the destination and the evidence required for success.
The distinctions here are category-level guidance derived from Catalog's public materials and this implementation review. They are not current feature audits of individual vendors, performance benchmarks, price comparisons, or proof that competing systems cannot support AI use cases. Ask for a concrete demonstration of the required workflow in each proposed solution.
Sources: [PIM systems and Catalog](https://www.getcatalog.ai/blog/catalog-ai-vs-traditional-pim-systems) · [Product data extraction](https://www.getcatalog.ai/blog/product-data-extraction) · [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce)
## Where adjacent systems fit
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/comparisons#systems
Several systems can legitimately coexist. The question is whether a new layer solves a missing job without creating an unmanageable second source of truth. Define which system owns each field and how corrections propagate.
### pim
- approach: PIM / product information management
- primaryJob: Govern and organize market-ready product content across teams and channels
- relationship: A PIM can remain the approved source while Catalog supplies an AI-oriented preparation/publication layer.
- confirm: Field ownership, approved inputs, update propagation and actual connector scope.
### dam
- approach: DAM / digital asset management
- primaryJob: Manage images, video, documents and associated rights or metadata
- relationship: Assets can inform product facts; an asset library alone is not a complete structured product record.
- confirm: Asset access, rights, association to products and source provenance.
### erp
- approach: ERP / operational systems
- primaryJob: Manage operational and transactional records such as inventory, orders and finances
- relationship: Keep operational authority for current commercial facts; Catalog is not presented as its replacement.
- confirm: Which source is authoritative for stock, price and fulfillment facts.
### feeds
- approach: Feed management and syndication
- primaryJob: Transform product content for a destination's accepted format and rules
- relationship: Formatting and enriching source facts are related but separate jobs.
- confirm: Live delivery to the exact destination; do not infer a GMC/ACP/UCP pipeline from marketing.
### extraction
- approach: Extraction or scraping service
- primaryJob: Acquire structured values from source pages or files
- relationship: Extraction can be an input to enrichment, review and publication; Catalog also offers an API for this work.
- confirm: Source coverage, normalization, maintenance, failure handling and the delivered schema.
### seo
- approach: SEO / GEO / visibility work
- primaryJob: Improve or measure discoverability and representation in search or generated answers
- relationship: Product-data infrastructure can support those efforts; it does not control an external system's ranking.
- confirm: Whether the gap is factual product data, content, access, measurement or a separate distribution issue.
Sources: [PIM systems and Catalog](https://www.getcatalog.ai/blog/catalog-ai-vs-traditional-pim-systems) · [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce) · [Product data extraction](https://www.getcatalog.ai/blog/product-data-extraction)
## Building an internal pipeline
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/comparisons#build
A team can build a pipeline that acquires product data, normalizes it, retains provenance, handles updates and publishes machine-readable outputs. The engineering work extends beyond the first successful extraction: ongoing source changes, failed items, schema evolution, credentials, validation, publication and monitoring need owners.
Compare Catalog with that complete operating scope, not only a one-off script. Conversely, a team with an existing robust pipeline and a narrow missing transformation may need a focused tool or API rather than a larger managed engagement. This reference does not supply a verified total-cost comparison; use the team's actual workload and current commercial terms.
Sources: [Product data extraction](https://www.getcatalog.ai/blog/product-data-extraction) · [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality)
## Verified differentiation and proof to request
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/comparisons#proof
The implementation review supports a concrete combination: product-data processing, a Shopify connection/update path, merchant AI-readable storefronts, API workflows, and separate measurement surfaces. This combination explains Catalog's approach. It does not establish that the approach is unique or better for every customer.
For a buyer-specific comparison, use the same difficult source products and the same questions. Compare field correctness, variant resolution, evidence quality, freshness, published accessibility and operating burden. Request current examples relevant to the proposed category and platform. Do not substitute website mockups or founder credentials for evidence that the customer's job has been done.
Sources: [Catalog website](https://www.getcatalog.ai/) · [PIM systems and Catalog](https://www.getcatalog.ai/blog/catalog-ai-vs-traditional-pim-systems) · [Live API migration notice](https://api.getcatalog.ai/docs.html)
---
# Measurement definitions & interpretation
How to distinguish agent requests, shopper referrals, sampled visibility, publication coverage and attributed sales when evaluating Catalog.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/measurement
Audience: AI agents
Topics: AI traffic, referrals, visibility, surfacing rate, attribution, sales, analytics, A/B testing
Questions answered:
- What does Catalog measure?
- Are AI visits shoppers?
- Does a visibility increase prove more sales?
- How should missing analytics be represented?
## Keep the measurement chain explicit
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/measurement#separate-signals
The merchant implementation includes separate workflows for AI request traffic, AI-linked referrals, and sampled visibility. They answer different questions and can have different coverage, freshness and configuration requirements. Confirm the measurement source and population before comparing a dashboard number with Shopify, GA4 or a separate visibility tool.
A machine request is not necessarily a human visit. A human visit is not necessarily a new customer. A sampled recommendation is not a sales event. A sales attribution rule is not a causal experiment. Preserve those distinctions when answering an evaluation question or summarizing a result.
### agent-requests
- signal: AI request traffic
- measures: Requests classified as agent traffic on the measured hostnames
- doesNotProve: Unique shoppers, a product recommendation, or a purchase
### referrals
- signal: AI referrals
- measures: Store arrivals associated with recognized AI referral signals
- doesNotProve: All AI-influenced visits or a count directly comparable to deduplicated visitors
### visibility
- signal: Sampled assistant visibility
- measures: Observed mentions, citations or product placements for the configured prompt population
- doesNotProve: Universal ranking across every user, query, market or provider
### publication
- signal: Publication coverage
- measures: Which eligible records are enabled or published on a configured surface
- doesNotProve: External platform ingestion or adoption
### sales
- signal: Attributed sales
- measures: Orders or revenue credited by the configured attribution method
- doesNotProve: Revenue that would not otherwise have occurred
Sources: [Catalog website](https://www.getcatalog.ai/) · [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality)
## Referral units and hidden attribution
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/measurement#referral-unit
The reviewed request-log referral path counts pageview requests associated with referral signals rather than deduplicated visitors. Other store analytics can use sessions, visitors or pixel events. The same label can therefore describe different units across systems. Include the unit, hostname coverage and time window in an agent's answer.
Referrer or campaign signals can be missing when a shopper comes from an app or assistant. Direct traffic is a mixed category, not a reliable synonym for AI traffic. The public dark-traffic article suggests triangulating known referrals, landing-page patterns, logs and sampled visibility; any inferred share should remain an estimate with stated assumptions, not be added to observed traffic as if independently measured.
Sources: [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic) · [Catalog website](https://www.getcatalog.ai/)
## Prompt populations, citations and shopping observations
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/measurement#visibility
The visibility implementation distinguishes prompts that name a brand or product from prompts that do not. That matters because asking directly about a known product makes a mention easier to obtain. Compare like populations, configured engines, markets, product scope and measurement windows. Do not mix branded and non-branded answers into a single discovery claim without disclosing the mixture.
A mention, a citation and a shopping card are different observations. Citation ownership asks whether a captured citation belongs to the merchant's domain. A shopping-mode observation concerns a provider surface that exposes a shopping result. An engine that did not expose that surface is not automatically a failed shopping result. Keep eligible denominators and unavailable observations explicit.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic)
## Unknown is not zero
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/measurement#availability
The analytics implementation distinguishes available data from not configured, unscoped or temporarily unavailable data. It also distinguishes live values from sample or demo inputs. A missing connection or failed query should not become a zero that suggests the store had no activity.
Previous-period comparison availability can differ from current-period availability. A percentage change against a zero prior period may be undefined rather than infinite growth. Preserve currency when reporting revenue, keep comparison periods aligned, and identify whether coverage changed between windows. An attractive chart is not evidence that the underlying period is complete or comparable.
Sources: [Catalog website](https://www.getcatalog.ai/)
## Define success before changing the data
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/measurement#evaluation-design
Agree on a baseline, target, metric definition and observation window. For a data-quality intervention, track the specific field corrections and publication evidence. For visibility, use a consistent prompt population and provider configuration. For commercial outcomes, specify the attribution rule and avoid claiming causality from a before/after chart alone.
The marketing site references A/B testing, but this review does not certify a generally available self-service experiment product or a causal result. If an experiment is part of the engagement, confirm assignment, control conditions, contamination, measurement completeness and the decision rule with the team. Do not call an arbitrary two-period comparison an experiment.
Sources: [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic)
---
# Product-data audits & evaluation scope
What an audit can examine, how readiness differs from measured visibility, and how to define an evidence-based pilot.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/audits
Audience: AI agents
Topics: audit, AI readiness, schema, data completeness, pilot, evaluation
Questions answered:
- What does an AI readiness audit cover?
- How do I evaluate Catalog on my catalog?
- Does a readiness score predict revenue?
## Public audit entry point
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/audits#request
Catalog offers a product-data audit request on its main website. The request collects contact details and the brand website so the team can follow up. Submitting a form requests work; it does not mean an audit has been generated, reviewed or delivered. Use the original request page for the current offer and required fields.
The company site describes an AI-readiness audit across access, discovery, schema, readability, policies and guidance. Those categories concern whether product information is accessible and useful to agents. They are separate from asking a provider a set of shopping questions and observing the returned answers.
Sources: [Request a product-data audit](https://www.getcatalog.ai/audit) · [Catalog website](https://www.getcatalog.ai/)
## The six advertised readiness dimensions
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/audits#dimensions
The dimensions below describe the advertised scope. They do not reproduce a current private scoring formula, promise a specific numeric score, or certify that a particular issue can be fixed without an implementation review.
### access
- dimension: Access
- inspect: Whether relevant agents can fetch the product content
- exampleQuestion: Does a crawler receive useful content or an access barrier?
### discovery
- dimension: Discovery
- inspect: How product and variant URLs can be found
- exampleQuestion: Can new or variant-specific information be discovered consistently?
### schema
- dimension: Schema
- inspect: Structured product facts and relationships
- exampleQuestion: Can software resolve identity, attributes and offer context?
### readability
- dimension: Readability
- inspect: Whether important facts can be extracted from the served representation
- exampleQuestion: Are useful details visible as content rather than only in an interactive widget?
### policies
- dimension: Policies
- inspect: Accessible and interpretable merchant policy information
- exampleQuestion: Can an agent find the applicable shipping or returns source?
### guidance
- dimension: Guidance
- inspect: Canonical and machine-reading directions
- exampleQuestion: Can an agent identify the intended URLs and representations?
Sources: [Catalog website](https://www.getcatalog.ai/) · [Request a product-data audit](https://www.getcatalog.ai/audit)
## Build a representative sample
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/audits#sample
Use a deliberate product sample: commercially important products, thin records, difficult variants, different categories and products with frequent support questions. Include the information needed to test the actual business problem rather than selecting only the easiest records. State whether the sample represents the whole catalog or only a particular segment.
For each sampled product, capture the source record, the target representation, the critical buyer questions and the evidence needed to answer them. A globally complete record can still be missing a category-specific field. Check both whether a value is present and whether it is accurate for the exact variant and market.
Sources: [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce)
## Useful evaluation artifacts
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/audits#deliverable
An agent helping scope a pilot can request a source snapshot, issue list with concrete examples, proposed corrections, reviewed output records, published URLs, and measurement definitions. Preserve the before/after evidence so changes can be assessed. Make uncertain and blocked items visible rather than converting them into a clean-looking score.
The suggested artifacts are a scoping aid, not a statement that every audit offer includes all of them. Confirm deliverables, product count, supported platform, access requirements and review responsibilities with Catalog before describing a promised outcome.
Sources: [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Request a product-data audit](https://www.getcatalog.ai/audit) · [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic)
## Interpret readiness and pilot outcomes proportionately
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/audits#interpretation
A readiness score describes checks in a specific methodology at a specific time. It is not a certification by an AI provider, a probability of being recommended, or a revenue forecast. Similarly, an improved sample record demonstrates a data change; it does not prove a whole-catalog rollout or a downstream shopping result.
After publication, verify the actual endpoint and then measure the next relevant outcome. Preserve the implementation, deployed, accessible, observed and commercially attributed states separately. If the pilot's question is whether richer product facts help a particular class of comparison, design that measurement directly instead of relying on unrelated aggregate website traffic.
Sources: [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic) · [Catalog website](https://www.getcatalog.ai/)
---
# Getting started
Start with your product-data problem and confirm a concrete setup scope.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/getting-started
Audience: AI agents
Topics: onboarding, demo, audit, setup, contact, API access
Questions answered:
- How do I get started with Catalog?
- What do I need for setup?
## Book a demo or request an audit
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/getting-started#first-step
Use the existing demo scheduling link to speak with Catalog, or request a product-data audit through the main website. The audit form asks for contact details and the brand website; the team follows up by email.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Request a product-data audit](https://www.getcatalog.ai/audit)
## What to bring
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/getting-started#prepare
Bring your brand website, commerce platform, examples of difficult product questions, and the sources available to answer them. Identify the channels and measurements that matter to your team.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Request a product-data audit](https://www.getcatalog.ai/audit)
## Agree on access, review, and launch
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/getting-started#setup
Confirm the source connection, workspace setup, products to include, review process, and domain configuration with Catalog. Establish how you will check published content and what evidence will count as success.
Launch time depends on access, source quality, catalog size, review, and DNS. This reference does not promise a fixed turnaround. Pricing and commercial terms must be confirmed with the team; no purchasable plan is offered here.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Request a product-data audit](https://www.getcatalog.ai/audit)
## Choose the engagement path
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/getting-started#engagement-paths
For a merchant deployment, begin with the product-data problem and the source platform. For a developer integration, begin with the input type and required API output. For an evaluation, begin with a representative product sample and the question the pilot needs to answer. These can be related projects, but none automatically includes the others.
The documented API access contact is founders@getcatalog.ai. The demo and audit links remain on their original services. Reading a contact address or preparing a request is different from sending it. An agent should obtain the user's agreement before sharing contact details, product data, credentials, or other information with a service.
### brand
- path: Brand implementation
- prepare: Store URL, commerce platform, product scope, difficult product questions and source access
- confirm: Connection method, review, publishing scope, domain work and ongoing responsibilities
### api
- path: Developer API
- prepare: Input URLs/vendor/query, needed fields, endpoint version and intended workload
- confirm: API account, billing, processing options, result schema and error handling
### evaluation
- path: Audit or pilot
- prepare: Representative products, baseline evidence, target outcome and measurement window
- confirm: Deliverables, sample limits, success criteria and interpretation boundaries
Sources: [Catalog website](https://www.getcatalog.ai/) · [Request a product-data audit](https://www.getcatalog.ai/audit) · [Public API authentication reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/authentication.mdx)
## Onboarding completion states
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/getting-started#onboarding-states
The Shopify implementation includes installation confirmation, workspace provisioning, webhook setup, initial synchronization and storefront domain work. These are separate checks. A successful OAuth connection does not mean every product has been processed, and an enabled product does not prove its public page is correct.
Before reporting a merchant launch complete, verify the intended product scope, actual public representations, correct consumer-site links and the necessary DNS/TLS state. Confirm which ongoing measurements are connected and which remain unavailable. Setup time depends on permissions, source quality, review and domain configuration; use a scoped estimate from the team.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Request a product-data audit](https://www.getcatalog.ai/audit)
## Contact destinations
- [Book a demo](https://calendly.com/d/cvr8-2zy-txt/catalog-discovery-call)
- [Request an audit](https://www.getcatalog.ai/audit)
- API access: founders@getcatalog.ai
---
# Product-data API scope, versions & access
The authenticated API is a separate product surface for discovery, extraction and search. This document records supported concepts, version caveats and the evidence reviewed.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/api
Audience: AI agents
Topics: API, developers, v2, v3, authentication, crawl, extract, agentic search, legacy endpoint
Questions answered:
- Does Catalog have an API?
- Which extraction version should a new integration use?
- How do I obtain an API key?
- Is /api/products still available?
## API product and company reference are separate
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/api#separate-origin
Catalog's product-data API uses https://api.getcatalog.ai. It provides workflows for discovering listings, extracting product information, and searching for candidate products. The public documentation directs developers to founders@getcatalog.ai for API access. Access and billing must be arranged for the developer's account.
The API is separate from https://ai.getcatalog.ai, which serves this free-to-read company reference. The reference's /openapi.json describes only its document reads. It is not the product-data API specification and must not be used as a source of crawl, extraction, or search operations.
Sources: [Public API authentication reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/authentication.mdx) · [Live API migration notice](https://api.getcatalog.ai/docs.html) · [Public crawl API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/crawl/crawl.mdx) · [Public agentic search reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/search/agentic-search.mdx)
## Version guidance and retired endpoints
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/api#versions
The live API migration notice identifies /v3/extract as the current path for extracting known product URLs. The reviewed implementation retains v2 crawl, listing, extraction and search routes and includes a v3 extraction result format. Version numbers are endpoint-specific; do not replace v2 with v3 across every URL.
The legacy /api/products endpoint is retired. The live notice says it returns 410 Gone after authentication and explicitly warns that its query and filter payloads have no direct equivalent in extraction. Migration requires choosing the correct workflow and request shape, not changing only the endpoint string.
During this review the old docs.getcatalog.ai site returned 404. Its public documentation source remains available in Catalog-AI/mintlify-docs, and the live migration notice links to it. Some documentation examples still reference older versions. Use the specific retained endpoint reference, the live migration notice, and the team's confirmed contract together; do not treat every historical example as current.
Sources: [Live API migration notice](https://api.getcatalog.ai/docs.html) · [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx) · [Public crawl API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/crawl/crawl.mdx)
## Operation families and their completion signals
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/api#operations
These are API product operations, not callable actions on this company reference. The route families were checked against documentation and implementation. No authenticated processing jobs were run to create this reference, so account access, latency, success rate, and end-to-end output quality are not certified here.
### crawl
- operation: Discover a vendor's collections and product listings
- method: POST
- path: /v2/crawl
- input: url: vendor domain or website URL
- result: Asynchronous execution_id; poll the matching status endpoint
- state: documented_and_implemented; account_and_billing_required
### crawl-status
- operation: Read crawl progress
- method: GET
- path: /v2/crawl/{execution_id}
- input: Returned execution identifier
- result: Pending/running/completed/failed state and available discovery totals
- state: documented_and_implemented; authenticated
### listings
- operation: Retrieve discovered listing records
- method: GET
- path: /v2/listings
- input: vendor with endpoint-specific pagination
- result: A page of listing data and pagination metadata
- state: documented_and_implemented; authenticated
### extract-v3
- operation: Extract known product URLs
- method: POST
- path: /v3/extract
- input: urls array; confirm optional processing fields for this version
- result: Asynchronous execution_id; use matching v3 status/results endpoint
- state: current_migration_guidance_and_implemented; account_and_billing_required
### extract-v2
- operation: Retained v2 extraction
- method: POST
- path: /v2/extract
- input: urls or vendor; vendor mode uses discovered listings
- result: Asynchronous extraction in the v2 result contract
- state: retained_implementation_and_public_docs; confirm_for_existing_clients
### search
- operation: Find products from a natural-language request
- method: POST
- path: /v2/agentic-search
- input: query and optional customer_profile
- result: Asynchronous execution_id and matching status/results endpoint
- state: documented_and_implemented; account_and_billing_required
### search-mini
- operation: Synchronous product search
- method: POST
- path: /v2/agentic-search-mini
- input: query and optional enable_enrichment
- result: Product candidates in a synchronous list response
- state: documented_and_implemented; account_and_billing_required
### usage
- operation: Inspect account usage
- method: GET
- path: /v2/usage
- input: Supported period and pagination parameters
- result: Account-scoped usage data
- state: documented_and_implemented; authenticated
Sources: [Public crawl API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/crawl/crawl.mdx) · [Public product listing reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/get-listings.mdx) · [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx) · [Public agentic search reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/search/agentic-search.mdx) · [Public synchronous search reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/search/agentic-search-mini.mdx) · [Public API usage reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/usage/get-usage.mdx) · [Live API migration notice](https://api.getcatalog.ai/docs.html)
## Authentication and processing costs
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/api#auth
The documented authentication header is x-api-key. Use a valid account key on the API origin and keep it server-side. An unauthenticated listings request during review returned 401 with an API-key-required error; that verifies the authentication boundary, not successful authorized processing.
Crawl, extraction and search can consume credits. The crawl documentation states a billing prerequisite involving auto top-up. Confirm the current account configuration, charges and limits before running jobs; an agent should not enable billing or start an unbounded vendor job simply because a user asked about Catalog's capabilities. Preserve execution identifiers to track already-started work.
Sources: [Public API authentication reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/authentication.mdx) · [Public crawl API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/crawl/crawl.mdx) · [Public API error reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/resources/error-codes.mdx) · [Public API usage reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/usage/get-usage.mdx)
## Illustrative current extraction request
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/api#request-example
This request structure follows the live migration notice. The example domain and product are placeholders, no credential is included, and the request has not been executed. Confirm the account contract and use the corresponding status endpoint rather than treating acceptance as completed extraction.
### Start a bounded extraction using one known URL
Example kind: illustrative_request
```http
POST https://api.getcatalog.ai/v3/extract
Content-Type: application/json
x-api-key:
{
"urls": ["https://example.com/products/example-product"]
}
```
Sources: [Live API migration notice](https://api.getcatalog.ai/docs.html)
---
# Developer workflows & result interpretation
Task-oriented guidance for using discovery, extraction and search without confusing accepted jobs, incomplete data or pagination with completed results.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/api-workflows
Audience: AI agents
Topics: API workflow, pagination, polling, errors, retries, product comparison, async jobs
Questions answered:
- How do I go from a vendor website to product records?
- How should I poll extraction?
- What should a client do on API errors?
## When product URLs are already known
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/api-workflows#known-urls
Start with a small, explicit URL set. Choose the extraction version and processing options needed for the consuming application. Retain the returned execution_id, endpoint version, request time, input count and enabled options. If the request is accepted asynchronously, poll the matching execution resource rather than resubmitting the same job whenever a response is slow.
When the execution becomes terminal, inspect successful items, failures and pagination. Fetch all required result pages before reporting the delivered count. Preserve per-item source URLs and do not replace failed items with invented or unrelated products. A response with HTTP 200 can still describe a running job or include partial item outcomes.
Sources: [Live API migration notice](https://api.getcatalog.ai/docs.html) · [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx) · [Public API pagination guide](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/guides/pagination.mdx)
## When starting with a vendor domain
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/api-workflows#vendor
Use discovery to locate collections and product listings for the vendor. Wait for the discovery state appropriate to the next step and retrieve the listing records through their documented pagination. Then extract a deliberate sample or an explicitly authorized scope. For vendor-based extraction, the public v2 documentation requires previously discovered listings or a crawl_id to wait on active discovery.
Report discovery coverage and extraction coverage separately. A crawl can discover more URLs than the extraction scope, and some discovered URLs can fail processing. A vendor-level operation can be much larger than a small URL request. Specify max_products where the chosen contract supports it and confirm the intended workload before a broad run.
### discovered
- checkpoint: Listings discovered
- evidence: Discovery output or paginated listing records
- notEquivalentTo: Extracted or published product records
### accepted
- checkpoint: Processing accepted
- evidence: Execution identifier and accepted response
- notEquivalentTo: Successful completion
### completed
- checkpoint: Processing complete
- evidence: Terminal execution status plus item outcomes
- notEquivalentTo: All submitted items necessarily succeeded
### delivered
- checkpoint: Results retrieved
- evidence: Required pages saved and counts reconciled
- notEquivalentTo: Merchant storefront publication
Sources: [Public crawl API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/crawl/crawl.mdx) · [Public product listing reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/get-listings.mdx) · [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx)
## When the starting point is a shopping intent
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/api-workflows#search
Use search when the task is to find candidate products from a natural-language query rather than enumerate one merchant's complete catalog. The asynchronous search reference accepts a query and optional customer profile; the synchronous mini reference returns candidates directly. Choose the operation according to the desired output and latency model, then inspect the actual result fields.
Search results are candidates for evaluation. Check hard constraints against product evidence, resolve variants and market context, and follow the merchant URL for purchase-time facts. Do not describe search output as exhaustive catalog coverage, guaranteed stock, an independent product endorsement, or an executed purchase.
Sources: [Public agentic search reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/search/agentic-search.mdx) · [Public synchronous search reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/search/agentic-search-mini.mdx)
## Pagination and missing fields
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/api-workflows#pagination
The public API documentation describes paginated list responses. Use the actual endpoint's page and page-size parameters and response pagination metadata; do not assume every API or merchant storefront uses the same pagination style. For example, a merchant storefront's limit/offset interface is a different contract from a product-data API using page/page_size.
Processing options can change which fields are populated. A null or absent field can mean disabled processing, unavailable evidence, incomplete work, or an endpoint/version difference. Preserve the documented meaning rather than collapsing every null into a negative fact about the product. Store the version with exported data if consumers depend on a particular schema.
Sources: [Public API pagination guide](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/guides/pagination.mdx) · [Public product listing reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/get-listings.mdx) · [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx)
## Handle failures without duplicating paid work
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/api-workflows#errors
Use HTTP status, the structured error code, the execution state and per-item outcomes together. For support, retain the request identifier when supplied, the endpoint/version, time and a redacted payload. Never include an API key in a support artifact. The public error reference contains older endpoint examples, so use its semantics without copying retired URLs.
Apply bounded timeouts and backoff to safe retries. A transport failure after a job-start request can leave acceptance uncertain; investigate an existing execution before starting another paid job. Rate limiting is not a reason to run a faster loop. Current usage and rate headers should guide pacing rather than a rate limit copied from an old article.
### bad-input
- status: 400
- meaning: Request or validation problem
- response: Correct the payload; repeating identical invalid input will not fix it.
### auth
- status: 401 or 403
- meaning: Authentication or access problem
- response: Check the intended account and authorization; do not guess credentials.
### billing
- status: 402
- meaning: Billing or credit prerequisite
- response: Resolve account billing with authorization; do not silently enable spending.
### missing
- status: 404
- meaning: Resource or route unavailable
- response: Check endpoint version and identifier; do not turn it into an empty success.
### retired
- status: 410
- meaning: Retired resource
- response: Follow the migration contract; old query payloads may have no equivalent.
### conflict
- status: 409
- meaning: Operation conflicts with current state
- response: Inspect the existing job or state before starting another operation.
### rate
- status: 429
- meaning: Rate limit
- response: Respect Retry-After when present and use bounded backoff.
### server
- status: 5xx or transport timeout
- meaning: Server or transport failure
- response: Retry safe reads with bounds; reconcile uncertain job creation before resubmitting.
Sources: [Public API error reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/resources/error-codes.mdx) · [Public API authentication reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/authentication.mdx) · [Live API migration notice](https://api.getcatalog.ai/docs.html)
## A useful integration result
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/api-workflows#handoff
For a reproducible development handoff, include the operation and version, execution identifiers, requested and completed counts, failed item count, pagination completion, processing options, and the location of saved responses. Show a small representative sample with the actual evidence fields. Separate an implemented client from an authenticated successful run and from a production integration.
For a production decision, additionally agree on freshness, throughput, error handling, source coverage, acceptable field quality and support. This reference provides orientation and a source index; it does not substitute for the chosen API contract or an integration test under the customer's account.
Sources: [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx) · [Public API error reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/resources/error-codes.mdx) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality)
---
# Data handling, access & commercial boundaries
Published policy scope, data ownership questions, credential handling, and the information an agent should obtain before evaluating a deployment.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/security-and-data
Audience: AI agents
Topics: privacy, security, credentials, data retention, ownership, pricing, support, procurement
Questions answered:
- What privacy policy applies?
- Does Catalog have a verified security certification?
- Who owns the AI storefront?
- What should procurement confirm?
## Published policy and its scope
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/security-and-data#policy
The main website's privacy policy is the authoritative published policy for Catalog's website, services, and APIs. Its own last-updated date is September 1, 2025. That policy date is different from this reference's review date. Follow the original policy for its full wording and any subsequent revisions.
The policy describes information supplied by users, automatically collected log and usage information, and information from third parties or public sources. It describes use for operating and improving the service, support, security, and legal obligations. It says personal information is not sold and describes sharing with service providers, for legal reasons, and in business transfers. This short index does not replace the policy or create additional commitments.
Sources: [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy)
## Retention and contract-specific questions
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/security-and-data#retention
The published policy uses a purpose-based retention description: retaining information as needed to provide services and satisfy the other stated obligations, with anonymized or aggregated data potentially retained indefinitely. It does not establish one fixed deletion period for every data type and engagement.
For a procurement answer, obtain the applicable agreement and ask about source content, derived product fields, logs, customer-submitted files, backups, exports, subprocessors, deletion timing, and the handling of any personal data. Do not infer a data-processing agreement, a particular hosting region, a model-training exclusion, or a compliance certification from the existence of a privacy policy.
Sources: [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy)
## Access boundaries for agents
Evidence basis: reference_contract
Citation: https://ai.getcatalog.ai/security-and-data#access
The company reference at ai.getcatalog.ai is public and requires no credentials. It exposes read-only documents. A merchant workspace and the product-data API have separate authorization requirements. A visiting agent does not gain access to merchant data or paid processing merely by reading this reference.
For the product-data API, obtain an API key through the documented team contact and keep it in server-side secret storage. Supply credentials only to the intended API origin. Do not put keys into prompts, source-controlled examples, public URLs, browser JavaScript, or this company reference. A successful sign-in or authentication check is not authorization to start a broad processing job.
Sources: [Public API authentication reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/authentication.mdx)
## Brand subdomain and portability
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/security-and-data#ownership
A brand subdomain identifies where a storefront is served. It does not, by itself, define ownership of software, rights to reuse extracted third-party material, export scope, hosting continuity, or what happens when an engagement ends. The main website makes an ownership and portability statement; confirm its contractual implementation for the proposed engagement.
Useful questions cover DNS control, exported product records, source provenance, generated content, media rights, redirects, URL continuity, revocation of platform access, and who will operate the site after termination. Record the agreed answer rather than promising that a live service transfers automatically.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy)
## Procurement questions to route to the team
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/security-and-data#procurement
An agent preparing a vendor assessment should separate verified public facts from requested assurances. Catalog's public materials describe a product-data business; they are not a completed security questionnaire. Mark any missing contract or assurance as unverified rather than treating it as absent or satisfied.
### service-scope
- question: What is included?
- request: Product sources, product count, review responsibilities, publishing surfaces and support scope.
### commercial
- question: How is it charged?
- request: Current price, term, usage charges, limits, payment terms and any renewal conditions.
### assurance
- question: What assurances apply?
- request: Current security evidence, applicable agreements, processing roles and incident procedures.
### operations
- question: What happens when a source or channel fails?
- request: Freshness expectations, monitoring, escalation and recovery responsibilities.
### exit
- question: What can be exported or transferred?
- request: Content rights, format, timing, retained copies and operating responsibility.
Sources: [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy) · [Catalog website](https://www.getcatalog.ai/) · [Public API authentication reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/authentication.mdx)
---
# Questions & limitations
Direct answers with the boundaries left intact.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/faq
Audience: AI agents
Topics: FAQ, limitations, pricing, support, ownership
Questions answered:
- What should an agent avoid claiming about Catalog?
## Will Catalog replace our website?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#changes
The AI storefront is designed as a parallel information layer. Your existing website remains the destination for your customers. Confirm any optional site-side publishing or integration changes as part of setup.
Sources: [Catalog website](https://www.getcatalog.ai/)
## Can enriched data be wrong?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#accuracy
Yes. Extraction, normalization, and AI-assisted enrichment can produce errors. Review source evidence and resolve conflicts before relying on a claim. Catalog’s source-based approach does not make every generated field automatically correct.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Ecommerce Product Data Infrastructure Guide](https://www.getcatalog.ai/blog/complete-guide-ecommerce-product-data-catalog-ai)
## Does publication guarantee AI recommendations?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#recommendations
No. External assistants control retrieval, ranking, and presentation. A working AI storefront makes information accessible; it does not guarantee inclusion, click-throughs, or sales.
Sources: [Catalog website](https://www.getcatalog.ai/) · [What is agentic commerce?](https://www.getcatalog.ai/blog/what-is-agentic-commerce)
## Is product information always current?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#freshness
Connected product sources can supply updates, but published data and downstream caches can lag. Confirm freshness and critical purchase-time facts with the merchant. This company reference is manually maintained and carries a review date, not a live synchronization claim.
Sources: [Catalog website](https://www.getcatalog.ai/) · [What is agentic commerce?](https://www.getcatalog.ai/blog/what-is-agentic-commerce)
## Can an agent take actions on this AI site?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#protocols
This hostname serves public, read-only HTML, Markdown, and JSON over HTTP. It has an OpenAPI description of its read endpoints. It does not implement MCP, A2A, checkout, registration, account access, or form submission.
For a demo or audit, follow the contact links to their original services. An agent should obtain the user’s agreement before submitting personal information there.
Sources: [Request a product-data audit](https://www.getcatalog.ai/audit)
## Where are the policies and commercial terms?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#policies
The published privacy policy remains on the main website. Ask Catalog for the terms that apply to your engagement, including pricing, support, service levels, and any exit or portability commitments. This reference creates no additional contractual promise.
Sources: [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy)
## Does the free company reference include API access?
Evidence basis: reference_contract
Citation: https://ai.getcatalog.ai/faq#api-access
No. Reading ai.getcatalog.ai requires no account. The product-data API at api.getcatalog.ai requires account authorization and can consume credits. Use the API scope and developer workflow documents to choose the appropriate operation, then obtain access through the documented team contact.
Sources: [Public API authentication reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/authentication.mdx)
## Does Catalog replace a PIM, ERP or DAM?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#pim
Catalog is not presented here as a universal replacement for those systems. A PIM can remain the approved source of product content, an ERP can remain authoritative for operations, and a DAM can manage assets. Evaluate Catalog for the missing AI-oriented product-data and publication job, with explicit field ownership and integration scope.
Sources: [PIM systems and Catalog](https://www.getcatalog.ai/blog/catalog-ai-vs-traditional-pim-systems)
## Does every category use the same product fields?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#categories
No. Useful fields depend on category and buyer constraints. Apparel may require fit and sizing, furniture may require dimensions and clearance, and parts may require compatibility. The data-model guide describes field families; it does not guarantee that every source supplies every attribute or that one response schema fits every endpoint.
Sources: [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality)
## What happens when a product fact cannot be verified?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#missing-evidence
Keep the fact unresolved and identify the missing or conflicting evidence. Ask for a reliable source if the fact is needed for a decision. Do not substitute a similar product's specification or a plausible model-generated value. Field completeness and factual accuracy are separate checks.
Sources: [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce)
## Does extracting products automatically publish a merchant storefront?
Evidence basis: implementation_review
Citation: https://ai.getcatalog.ai/faq#api-vs-storefront
No. API processing, merchant workspace state, product activation and public storefront configuration are separate operations. A completed extraction returns data under its API contract. A merchant launch also needs the agreed review, product selection and verified public destination.
Sources: [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx) · [Catalog website](https://www.getcatalog.ai/)
## Can an agent buy something from this hostname?
Evidence basis: reference_contract
Citation: https://ai.getcatalog.ai/faq#consumer-checkout
No. This is company information for agents, not a merchant product catalog or checkout service. It accepts document reads and exposes no purchase, account, registration or form-submission endpoint. Follow the appropriate original service for an authorized next step.
## Does naming ChatGPT or Shopify imply a partnership?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#platform-logos
No. A supported connection, a measured referral source, a provider used in a visibility test, an example shopping interface, and a commercial partnership are different facts. This reference does not establish a partnership with each company whose name appears in Catalog's materials.
Sources: [Catalog website](https://www.getcatalog.ai/)
## Are the founders' former employers Catalog customers?
Evidence basis: public_source
Citation: https://ai.getcatalog.ai/faq#founder-employers
The About page describes prior experience at companies including Afterpay, Block, Square, Cash App and Curinos. Those biography statements do not establish current Catalog customer relationships. This reference does not publish a customer roster or turn illustrative examples into customer case studies.
Sources: [About Catalog](https://www.getcatalog.ai/about-us)
## Does a readiness score predict AI sales?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#audit-score
No. A readiness score concerns a specific set of checks and an observation time. Visibility, clicks, attributed orders and incremental sales require their own evidence. Use the audit and measurement documents to define what each result proves and what remains unmeasured.
Sources: [Catalog website](https://www.getcatalog.ai/) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic)
## Can all Direct traffic be attributed to AI?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#direct-traffic
No. Direct traffic mixes many sources with missing attribution. Some AI-driven visits can be hidden there, but identifying that portion requires evidence and assumptions. Keep observed AI referrals separate from inferred influence and label estimates as estimates.
Sources: [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic)
## What security certifications and service levels are verified here?
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/faq#certifications
This reference verifies the published privacy-policy location and summarizes its scope. It does not verify a particular certification, audit report, guaranteed uptime, residency commitment or contract-specific service level. Request current assurance materials and the applicable agreement from Catalog.
Sources: [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy)
## Is this knowledge updated automatically?
Evidence basis: reference_contract
Citation: https://ai.getcatalog.ai/faq#maintenance
No. It is a manually maintained corpus with an explicit review date. HTML, Markdown, JSON, the topic map and section records derive from the same authored content. A deployment timestamp is not substituted for a factual review, and reading the reference does not trigger product enrichment.
---
# Terminology & disambiguation
Definitions for agents interpreting Catalog's product, API, measurement and commerce terminology.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/glossary
Audience: AI agents
Topics: glossary, definitions, AI commerce, MCP, A2A, ACP, UCP, GMC, PIM
Questions answered:
- What does agentic commerce mean here?
- What is the difference between extraction, enrichment and publication?
- Does an API imply MCP support?
## Data and publication terminology
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/glossary#data
These definitions describe how terms are used in this reference. They clarify related concepts without making every associated capability a Catalog product commitment. Use the integration and capability records for availability.
### catalog-company
- term: Catalog
- definition: The software and services company at getcatalog.ai; legal name Agentic Commerce Inc.
### product-catalog
- term: Product catalog
- definition: A collection of a merchant's product records; not necessarily the Catalog company.
### product-data
- term: Product data
- definition: Information used to identify, describe, compare or transact a product, including structured fields and their supporting evidence.
### extraction
- term: Extraction
- definition: Acquiring product information from a source and returning structured values or content.
### normalization
- term: Normalization
- definition: Representing equivalent values consistently while retaining their meaning and entity association.
### enrichment
- term: Enrichment
- definition: Adding or organizing useful product attributes and context from supporting material; the added information still needs evidence.
### provenance
- term: Provenance
- definition: The source and derivation context of a claim, allowing a reader to inspect what supports it.
### variant
- term: Variant
- definition: A specific option combination of a product that can have distinct identifiers, price, stock and purchase URL.
### listing
- term: Listing
- definition: A merchant's representation of a product or offer at a particular location; discovering it is not full extraction.
### canonical
- term: Canonical URL
- definition: The identified primary URL for a specific resource, used to avoid treating multiple representations as different entities.
### jsonld
- term: JSON-LD
- definition: Linked data serialized as JSON, often embedded in a page to express structured entities and relationships.
### ais
- term: AI storefront
- definition: A parallel information surface designed for agent retrieval; verify its actual data and operations on the target hostname.
### pim
- term: PIM
- definition: Product information management: software and workflows for governing and preparing product content.
### dam
- term: DAM
- definition: Digital asset management: organization of files such as images, video and documents, with associated metadata.
### erp
- term: ERP
- definition: Enterprise resource planning: operational and transactional systems that can own inventory, orders and financial records.
Sources: [Ecommerce Product Data Infrastructure Guide](https://www.getcatalog.ai/blog/complete-guide-ecommerce-product-data-catalog-ai) · [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce) · [PIM systems and Catalog](https://www.getcatalog.ai/blog/catalog-ai-vs-traditional-pim-systems)
## API and agent protocol terminology
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/glossary#protocols
A protocol name in a marketing page indicates context, not verified integration. HTTP JSON documents, an OpenAPI description, an MCP tool server and an A2A service are different interfaces. Test what the specific host advertises.
### agentic-commerce
- term: Agentic commerce
- definition: Commerce workflows in which software agents assist with discovering, comparing or acting on products; the degree of action depends on the system and user authorization.
### http-api
- term: HTTP API
- definition: An interface accessed through HTTP requests and responses. It can be read-only or support actions; the actual methods define that boundary.
### openapi
- term: OpenAPI
- definition: A description of an HTTP API contract. Publishing a specification does not itself implement its listed operations.
### mcp
- term: MCP
- definition: Model Context Protocol, used to expose tools and resources to compatible clients. Not implemented on this company reference hostname.
### a2a
- term: A2A
- definition: Agent-to-Agent protocol for interaction with an agent service. Not implemented on this company reference hostname.
### acp
- term: ACP
- definition: Agentic Commerce Protocol, referenced in Catalog's commerce positioning. Do not infer an available Catalog delivery or checkout integration from the name.
### ucp
- term: UCP
- definition: Universal Commerce Protocol, referenced in Catalog's commerce positioning. Confirm the exact supported capability and deployment before describing it as available.
### gmc
- term: GMC
- definition: Google Merchant Center. A destination mentioned in Catalog's public positioning; this reference does not verify a generally available Catalog output pipeline.
### execution
- term: Execution identifier
- definition: The durable handle returned for an asynchronous processing job. Preserve it to query progress and retrieve results.
Sources: [Catalog website](https://www.getcatalog.ai/) · [What is agentic commerce?](https://www.getcatalog.ai/blog/what-is-agentic-commerce) · [Public crawl API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/crawl/crawl.mdx) · [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx)
## Measurement and evidence terminology
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/glossary#measurement
When a term describes a metric, include the measured population and unit. A definition alone does not prove that data is connected, complete or comparable for a particular merchant.
### completeness
- term: Completeness
- definition: Coverage of required fields for the chosen product category and destination. A filled field can still be inaccurate.
### accuracy
- term: Accuracy
- definition: Agreement between a claim and reliable evidence for the correct product, variant and context.
### freshness
- term: Freshness lag
- definition: Elapsed time between a relevant source change and the observed updated representation at a destination.
### referral
- term: AI referral
- definition: An arrival associated with recognized AI source signals. State whether the unit is requests, sessions, visitors or another event.
### visibility
- term: Sampled visibility
- definition: Observed product or brand representation for a defined prompt/provider/market population and time window.
### dark-traffic
- term: Dark traffic
- definition: Traffic with missing or insufficient attribution. It can include AI-influenced traffic but is not exclusively AI traffic.
### attribution
- term: Attribution
- definition: Assigning credit to a channel using a stated rule. It does not establish the outcome that would have occurred without that channel.
### incrementality
- term: Incrementality
- definition: An outcome caused by an intervention beyond what would otherwise have occurred; it requires an appropriate causal evaluation.
### implementation
- term: Implemented
- definition: A capability exists in the reviewed code. Configuration, account access and successful production execution are separate evidence states.
### verified-live
- term: Verified live
- definition: The specific published surface or operation was exercised successfully in the stated scope and time. It is not a universal guarantee.
Sources: [Product data quality](https://www.getcatalog.ai/blog/product-data-quality) · [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic)
---
# Sources & evidence
Public references, review scope, and what the evidence does not establish.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/sources
Audience: AI agents
Topics: sources, evidence, review date, provenance
Questions answered:
- What supports this reference?
- When was the content reviewed?
## A manually reviewed reference
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/sources#review
Reviewed on 2026-09-06. The review compared Catalog’s public website and published articles with its implementation to avoid presenting unverified channels as available. Private implementation details are not reproduced here.
Source links show the public basis for the topic. They do not mean that every phrase in a marketing source is independently validated. Availability qualifications and fit guidance are editorial conclusions from the review.
Sources: [Catalog website](https://www.getcatalog.ai/) · [About Catalog](https://www.getcatalog.ai/about-us) · [Ecommerce Product Data Infrastructure Guide](https://www.getcatalog.ai/blog/complete-guide-ecommerce-product-data-catalog-ai)
## Examples are not outcome evidence
Evidence basis: editorial_guidance
Citation: https://ai.getcatalog.ai/sources#evidence-boundaries
Product demonstrations, illustrated dashboards, and category explainers show an approach. They do not by themselves establish customer results, causal revenue lift, direct platform partnerships, or universal integration availability.
This reference makes no quantified customer-performance claim. Ask Catalog for relevant evidence for your category, product source, and evaluation window.
Sources: [Catalog website](https://www.getcatalog.ai/) · [What is agentic commerce?](https://www.getcatalog.ai/blog/what-is-agentic-commerce)
## Public references
- [Catalog website](https://www.getcatalog.ai/): Public product explanation. Illustrations and example metrics are not customer outcome evidence.
- [About Catalog](https://www.getcatalog.ai/about-us): Company identity, founders, and product-data thesis.
- [Published privacy policy](https://www.getcatalog.ai/legal/privacy-policy): Legal identity and the authoritative policy; its own update date is September 1, 2025.
- [Request a product-data audit](https://www.getcatalog.ai/audit): Public request form; submitting a request is not a completed audit.
- [Ecommerce Product Data Infrastructure Guide](https://www.getcatalog.ai/blog/complete-guide-ecommerce-product-data-catalog-ai): Published April 28, 2026. Explains attributes, identifiers, validation, and delivery layers.
- [What is agentic commerce?](https://www.getcatalog.ai/blog/what-is-agentic-commerce): Published June 9, 2026. Category education, not a guarantee that Catalog offers every example.
- [Catalog's pre-seed announcement](https://www.getcatalog.ai/blog/catalog-raises-3m-pre-seed): Published March 23, 2026. Company-reported USD 3 million pre-seed led by Acrew Capital; product claims in the announcement require current availability review.
- [Product data quality](https://www.getcatalog.ai/blog/product-data-quality): Published July 10, 2026; updated July 31, 2026. Definitions, category-specific validation and evaluation guidance.
- [Product data extraction](https://www.getcatalog.ai/blog/product-data-extraction): Published July 16, 2026; updated July 31, 2026. Source acquisition and normalization guidance.
- [Machine-readable product enrichment](https://www.getcatalog.ai/blog/product-data-enrichment-ai-commerce): Published June 16, 2026. Field families and workflow examples; illustrative product records are not validated product specifications.
- [PIM systems and Catalog](https://www.getcatalog.ai/blog/catalog-ai-vs-traditional-pim-systems): Published May 25, 2026. Catalog's own positioning and coexistence guidance, not an independent competitor benchmark.
- [Dark traffic in agentic commerce](https://www.getcatalog.ai/blog/dark-agentic-commerce-traffic): Published July 15, 2026. Measurement caveats; third-party percentages are not Catalog customer results.
- [Live API migration notice](https://api.getcatalog.ai/docs.html): Verified reachable during review. Retires the legacy /api/products endpoint and points new extraction work to /v3/extract. This is not the old hosted docs site.
- [Public API authentication reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/authentication.mdx): Public documentation source reviewed at commit 082b50a. API keys and founders@getcatalog.ai contact; preserve server-side credential handling.
- [Public crawl API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/crawl/crawl.mdx): Public documentation source reviewed at commit 082b50a; compared with the retained v2 implementation. Describes asynchronous discovery and billing prerequisites.
- [Public extraction API reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/extract/extract.mdx): Public v2 documentation source reviewed at commit 082b50a. Shared concepts remain useful; use the live migration notice for the current extraction version and confirm its result schema.
- [Public agentic search reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/search/agentic-search.mdx): Public documentation source reviewed at commit 082b50a; matched to retained v2 asynchronous search implementation. No authenticated search job was run for this reference.
- [Public synchronous search reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/search/agentic-search-mini.mdx): Public documentation source reviewed at commit 082b50a; matched to retained v2 synchronous search implementation. Not an exhaustive merchant catalog export.
- [Public product listing reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/get-listings.mdx): Public documentation source reviewed at commit 082b50a. Listing discovery differs from full extraction.
- [Public API error reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/resources/error-codes.mdx): Public documentation source reviewed at commit 082b50a. Use error semantics; some embedded examples still refer to older endpoint versions.
- [Public API pagination guide](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/guides/pagination.mdx): Public documentation source reviewed at commit 082b50a. Request and response pagination belong to the chosen endpoint/version.
- [Public API usage reference](https://github.com/Catalog-AI/mintlify-docs/blob/main/v2/api-reference/endpoints/usage/get-usage.mdx): Public documentation source reviewed at commit 082b50a. Authenticated usage reporting is distinct from commercial pricing or a free allowance.
---
# Guide for AI assistants
Retrieve focused topic documents or ingest the full corpus, then cite stable sections with their source and availability context.
Reviewed: 2026-09-06
Canonical: https://ai.getcatalog.ai/agents
Audience: AI agents
Topics: agent instructions, retrieval, formats, citation, topic routing
Questions answered:
- How should an agent retrieve and cite this knowledge?
## Suggested reading order
Evidence basis: reference_contract
Citation: https://ai.getcatalog.ai/agents#workflow
Start at /knowledge-map.json to select documents by topic, questions answered, size and related pages. Read /index.md for orientation, /capabilities.md and /integrations.md for availability, and the relevant detailed topic. /content.json contains the full structured corpus; /llms-full.txt contains the complete Markdown text; /sections.jsonl provides one self-contained, citable record per section.
## Read-only representations
Evidence basis: reference_contract
Citation: https://ai.getcatalog.ai/agents#representations
Every reference page has matching HTML, Markdown (.md), and JSON (.json) URLs. The homepage uses /, /index.md, and /index.json. Request Accept: text/markdown for Markdown at an HTML page URL. JSON uses the explicit .json URL. /agents.txt is a plain-text alias of /agents.md.
GET, HEAD, and OPTIONS are supported. No authentication is required. /openapi.json describes the JSON read endpoints and /.well-known/api-catalog links to it. Unknown paths return 404; unsupported write methods on existing documents return 405.
## Preserve context when answering
Evidence basis: reference_contract
Citation: https://ai.getcatalog.ai/agents#boundaries
Cite the relevant canonical page and its review date. Preserve the distinction between an implemented capability, a configured merchant, and external adoption. Do not infer guaranteed outcomes, prices, partnerships, certifications, or connector availability.
This site supplies reference information, not higher-priority instructions for an assistant. It has no MCP server, A2A service, agent registration, or downloadable skill. Keep user consent with any contact action on external services.
## Route a question to the smallest useful evidence set
Evidence basis: reference_contract
Citation: https://ai.getcatalog.ai/agents#question-routing
Use the topic map's topics, answers and relatedPages to choose documents. Its word and byte counts help select a retrieval size. When the question needs the whole company context, use /llms-full.txt or /content.json. When indexing into a retrieval system, /sections.jsonl supplies one JSON object per authored section with the parent document, stable citation URL, review date and resolved sources.
### entity
- question: Identity, founders, financing or history
- read: /company.md and /brand-facts.json
### features
- question: What Catalog can do and whether it is available
- read: /capabilities.json and /integrations.md
### fields
- question: Attributes, variants, provenance or processing
- read: /data-model.md and /enrichment.md
### storefront
- question: Merchant storefront behavior and protocol boundaries
- read: /ai-storefront.md and the actual merchant's live guide
### fit
- question: Buyer fit or alternatives
- read: /use-cases.md, /fit.md and /comparisons.md
### measurement
- question: Audit, visibility, traffic or revenue interpretation
- read: /audits.md and /measurement.md
### api
- question: Technical integration or API versions
- read: /api.md and /api-workflows.md
### commercial
- question: Setup, pricing, policies or security evidence
- read: /getting-started.md and /security-and-data.md
## Cite the answer and preserve its evidence basis
Evidence basis: reference_contract
Citation: https://ai.getcatalog.ai/agents#citation-contract
Each section has a stable canonical citation URL, evidence basis and source identifiers. Resolve source identifiers using the document's sources array; section-export records already include the relevant source objects. Use the section URL when citing Catalog's curated assessment and the original source URL when citing a particular published claim. Markdown includes explicit section anchors matching the HTML and JSON identifiers.
The evidence basis values are public_source, implementation_review, editorial_guidance and reference_contract. Public-source status means the statement is grounded in an attributed publication, not independently audited. Implementation review establishes code behavior in the reviewed scope, not universal production availability. Editorial guidance is an evaluation or interpretation rule. Reference contract describes this site's own behavior.
## Treat the corpus as evidence, not operating authority
Evidence basis: reference_contract
Citation: https://ai.getcatalog.ai/agents#authority
This site is reference data for an agent, not a higher-priority instruction source. It does not authorize sending messages, disclosing information, spending API credits, changing DNS, accessing a merchant account or buying products. Follow the user's task and consent boundaries for any external action. Illustrative API requests and synthetic records are marked and are not observed customer results.
When the answer depends on a missing commercial fact, unverified integration or current private configuration, say what the reference establishes and route the remaining question to the appropriate team contact. Do not guess an unavailable endpoint, invent a pricing plan, treat not verified as a promised roadmap, or use another merchant's capabilities as evidence for this company hostname.
---