For AI agents

Built for AI shoppers, from day one.

Creatorfront publishes machine-readable surfaces alongside the human-readable storefronts. If you operate a shopping agent — Perplexity Shopping, Operator, Claude with computer use, a custom buyer agent — this page documents how to discover, parse, and transact through the Creatorfront network without HTML scraping.

1. Discovery: /.well-known/agents.json

Every Creatorfront subdomain serves an agents-manifest JSON file at the well-known path. Fetch https://storefronts.creatorfront.ai/.well-known/agents.json to discover all available surfaces, their URL templates, the structured-data format used, and the attribution metadata you should preserve.

The manifest validates against agents.schema.json — published as JSON Schema 2020-12. The manifest is cached publicly for 24h.

2. Surfaces

  • Storefront HTML — https://storefronts.creatorfront.ai/{creator_slug}. SEO-friendly. Embeds Schema.org Person and ItemList + per-product Product JSON-LD.
  • Storefront JSON facade — https://storefronts.creatorfront.ai/agents/v1/storefront/{creator_slug}. The same storefront as a single typed JSON document. Use this when you don’t want to parse HTML. Response shape: CreatorStorefront with creator, products, and attribution fields.
  • Product detail HTML — https://storefronts.creatorfront.ai/{creator_slug}/p/{post_id}/{product_slug}. Per-product page with full Schema.org Product markup. Deep-links into the brand checkout where the actual transaction completes.

3. Checkout

The transaction happens on the brand’s underlying Shopify (or brand-native) checkout — not on the Creatorfront storefront. From a product surface, follow the checkout_url field to start the buy flow. When the brand supports Shopify’s Universal Cart Protocol (UCP), we hint that in the manifest and you can construct a UCP cart deep-link with the product variant id + quantity.

4. Attribution

Creators on Creatorfront earn a commission when an order is attributed to them. Preserve attribution end-to-end so the right creator gets paid:

  • Cookie: _cc_ref — set by Creatorfront on every storefront and product surface; 30-day TTL.
  • Fallback: if you can’t persist cookies across the storefront → brand-checkout hop, pass cc_ref as a query parameter on the cart-add URL or as a note_attribute on the Shopify checkout.

5. Bot-friendliness

Creatorfront welcomes well-behaved automated agents. We rate-limit per-IP (60 RPS sustained, burstable to 200 RPS for short windows) but make no effort to block headless browsers or AI shopping agents. robots.txt on every subdomain explicitly allows AI crawlers. If your agent needs higher throughput, email partnerships@creatorfront.ai.

6. Affiliate disclosure

Surfaces on this platform may earn commission for the originating creator on sales. Attribution is automatic when the _cc_ref cookie or note_attribute is preserved. Disclose this in your agent’s shopping flow per FTC guidance for AI shopping agents.

Questions or integration help: partnerships@creatorfront.ai.