Developer Platform

Build on OmniCommerce marketplace-PIM rails

Use REST, MCP, CLI, and webhooks to create enriched catalog data, evaluate agentic readiness, sync commercial fields, and monitor AI Shelf Share.

Auth

Use the API key from settings directly as a bearer token.

Authorization: Bearer omni_sk_...

MCP

Agent-callable tools share the same auth and API contracts.

CLI

Run developer workflows from local scripts and pipelines.

yarn omni evaluate --product-id PRODUCT_ID

API Products

Products

POST

Create or upsert a product by SKU, mirror images, pass LLM instructions, create variants, and queue enrichment.

POST /api/v1/products

Category Recommendations

POST

Suggest marketplace categories and category attribute values for a persisted product.

POST /api/v1/manage-product-category/recommend

Connected Marketplaces

GET

List connected marketplace stores for the authenticated organization.

GET /api/v1/marketplaces/connected

Publish

POST

Publish a product to the marketplaces already enabled on that product.

POST /api/v1/products/{productId}/publish

Evaluate

POST

Score SKU readiness for agentic commerce engines.

POST /api/v1/evaluate

Agentic Checkout

POST

Create merchant-fulfilled checkout sessions, reserve inventory, and complete native agentic orders. Live settlement requires ACP or x402 configuration.

POST /api/v1/checkout-sessions

UCP Checkout

POST

Expose Universal Commerce Protocol shopping checkout and order endpoints for standards-aware agents.

POST /ucp/v1/checkout-sessions

UCP Profile

GET

Advertise Universal Commerce Protocol shopping capabilities for sitemap-first agents.

GET /.well-known/ucp

Sync

POST

Update price, sale price, and stock, then queue sync workers.

POST /api/v1/sync

Monitor

POST

Run AI Shelf Share monitoring and replay workflows.

POST /api/v1/monitor

MCP Tools

Developer operations are available to tool-calling agents.

  • omni_evaluate_sku
  • omni_sync_sku
  • omni_monitor_visibility

Webhooks

Subscribe to product, sync, and visibility events.

GET /api/v1/webhooksPOST /api/v1/webhooks