Gallery Submissions API

The product, service, or offering URL that was purchased.

e.g. "https://www.nike.com/t/air-force-1"

Name of the seller, brand, or merchant.

e.g. "Nike"

Name of the product or service.

e.g. "Air Force 1 '07"

Purchase price. Alias: priceAmount. Must be a non-negative number; stored to 2 decimals.

e.g. 115.00

Contact email for the caller. Must contain @. Never shown publicly.

e.g. "dev@yourapp.com"

Contact phone for the caller. US & Canada only: must be "+1" followed by 10 digits. Common separators (spaces, dashes, parens, dots) are stripped before validation. Never shown publicly.

e.g. "+14155550123" · "+1 (415) 555-0123"

Root URL of the site. Auto-derived from productUrl's origin when omitted.

e.g. "https://www.nike.com"

The chosen options as discrete strings: size, color, tier, seat, etc. List each option separately; the specific variant/SKU should be apparent from the options here. Each option max 120 chars, up to 24 options. A single string is also accepted and split on common separators.

e.g. ["White/White", "Men's size M 10 / W 11.5"]

Whole number of units purchased (min 1).

e.g. 1

Optional longer description (max 2000 chars).

3-letter currency code. Defaults to USD.

e.g. "USD"

Billing cadence for subscriptions: once, day, week, month, quarter, year. Defaults to once.

e.g. "month"

Product image URL. Send the highest-resolution image available; 600px wide or larger strongly preferred. Avoid tiny thumbnails.

e.g. "https://cdn.example.com/product-1200.png"

Set true when the image is a text-forward poster/card (a wordmark, plan card, event ticket, etc.) rather than a photographic product shot. Poster images are shown fully (contain-fit + centered) over a matching backdrop instead of being cropped to fill, so no artwork is cut off. Also accepts snake_case text_poster. Defaults to false.

e.g. true

A direct URL to the seller's own brand logo. Do not send third-party logo-service links; when a valid direct logo isn't available we resolve one ourselves.

The product category. Use one of our standard categories whenever it applies; send the exact value shown in the category list. If your product is genuinely new, you can submit a custom value.

e.g. "apparel" · "saas" · "consumer services"

Where the buy button lived, e.g. the ad network, chat, or article.

e.g. "Pinterest ad" · "ChatGPT" · "The Verge"

A re-playable MCP request that lets others buy exactly this product. Send the JSON-RPC style request object (or a JSON string). Stored as-is for reference and never executed by us. Max 20,000 chars serialized.

e.g. { "method": "tools/call", "params": { "name": "checkout", "arguments": { "productUrl": "https://www.nike.com/t/air-force-1", "options": ["White/White", "M 10"] } } }

Buyer's first name for public attribution (max 80 chars).

e.g. "Alex"

Buyer's last initial only, never a full last name. Trimmed to a single initial.

e.g. "R"

When the purchase happened.

e.g. "2026-07-02T18:30:00Z"

Event start date for ticketed purchases. ALWAYS send this for tickets (category tickets/events): ticketed submissions without an event date are rejected in review, and any event whose date is today or in the past (evaluated in US Pacific time) is automatically removed so past events never appear. Bare calendar date only, no time or timezone. Also accepts snake_case event_date.

e.g. "2026-08-15"

Your own reference / partner id for this submission.

Self-declare mature / sensitive content. Also accepts: mature, flagged, sensitive.

e.g. true

Set to "mature" to hold the item out of the public gallery.

e.g. "mature"