Developer APIs

The full visualAI platform.
Available as an API.

Every product in the visualAI stack — trimodal search, AI data cleaning, feed generation — is accessible via versioned REST APIs. Build custom integrations, headless storefronts, or automation pipelines on top of the same infrastructure powering live Shopify merchants.

v1
shopperGPT Search API — production, stable
Alpha
cleanerGPT Data API —
limited early access
2H 2026
catalogGPT Feed API + MCP server —
spec live, waitlist open
Architecture

Built multi-tenant from day one. Not retrofitted.

visualAI's APIs were designed to power multi-tenant Shopify apps — not added as an afterthought. Every endpoint is versioned, multi-tenant via the x-merchant-id header, and instrumented with OpenTelemetry distributed tracing. Authentication is API key based. Rate limits and SLAs activate at paid tiers.

✓Multi-tenant via x-merchant-id header
✓API key authentication
✓Versioned endpoints (v1)
✓OpenTelemetry distributed tracing
✓FastAPI async — low latency at scale
✓OpenAPI spec available for all products

REST APIs + an MCP server. One integration pattern.

Every API shares the same authentication model, header conventions, and error format — and the same engine is exposed as an MCP server for AI agents. Integrate once; add products as they become available.

shopperGPT Search API

v1 · Production

Text, color, and image search — all three modalities available via REST. Ideal for headless storefronts, custom search UIs, and merchandising automation.

POST /api/v1/product/search/text
POST /api/v1/product/search/textandcolor
POST /api/v1/product/search/image
GET  /api/v1/searchlookup/trending
GET  /api/v1/user/preferences

cleanerGPT Data API

Alpha · Limited Access

Full product cleaning workflow via API. Retrieve products pending review, approve or reject rewrites, push approved data to Shopify, and track job status. Ideal for custom review UIs and automated cleaning pipelines.

GET /api/v1/cleaner/products
POST /api/v1/cleaner/approve
POST /api/v1/cleaner/reject
POST /api/v1/cleaner/push
GET /api/v1/cleaner/push-status

catalogGPT Feed API

Coming Soon

Download ACP, schema.org JSON-LD, UCP, and Google Merchant Center feeds programmatically. Ingest products, retrieve enriched data, generate third-party API keys. Ships with catalogGPT (June 2026).

GET /api/v1/feeds/acp
GET /api/v1/feeds/jsonld
GET /api/v1/feeds/gmc
POST /api/v1/ingest
GET /api/v1/product/{id}/enriched

MCP Server

2H 2026

The same engine, exposed over the Model Context Protocol so AI agents can call search, enrichment, and feeds as tools directly. Subscription-gated distribution to the ChatGPT Apps SDK, Claude, and any MCP-compliant host — the public spec is live at developer.vairetail.com/docs.

MCP tools/list
MCP tools/call · product.search
MCP tools/call · catalog.enrich
MCP tools/call · feed.generate

How it works

From API access request to production integration in four steps.

01

Request access

Apply for API access. We provision credentials and a sandbox merchant account for development and testing.

02

Authenticate

Include your API key in the Authorization header. Set x-merchant-id for multi-tenant calls. All endpoints follow the same auth pattern.

03

Integrate

Use the API reference to build your integration. Python and JavaScript SDKs available on request. OpenAPI spec available for all three products.

04

Deploy

Move to production credentials. SLA and rate limits activate. Support is available via the developer portal.

Build on the same infrastructure powering live merchants.

shopperGPT Search API is available now. cleanerGPT alpha access is limited. The catalogGPT Feed API and MCP server ship 2H 2026 — waitlist is open.