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
Soon
catalogGPT Feed API — 30–60 days out, 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

Three API products. One integration pattern.

All three APIs share the same authentication model, header conventions, and error format. 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. Estimated availability: 30–60 days.

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

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. catalogGPT Feed API waitlist is open.