---
title: "Create a Shopify Recommendation Audit baseline"
method: POST
path: "/api/v1/recommendation-audit"
tags: ["Recommendation Audits"]
---

# Create a Shopify Recommendation Audit baseline

`POST /api/v1/recommendation-audit`

## Request

- Base URL: `https://agenticcom.ai`
- URL: `https://agenticcom.ai/api/v1/recommendation-audit`
- Auth: none declared

Read public storefront and product evidence for one Shopify store and
one to three exact product pages. When the one-link web flow supplies
no buyer question, Colter derives five deterministic questions from the
product name, brand, and category. Questions do not affect the page
findings or fix selection.

The stable `readiness_baseline_only` response value is a compatibility
label. This endpoint does not query a named answer engine or show that a
product was displayed, cited, or recommended. No authentication required.

The multi-page and comparison-page request fields are a technical API
superset for batch work. The merchant product at `/audit` checks one
public Shopify product page at a time.

## Request body

- object
  - `store_url` string, uri, required
  - `product_urls` string[], required
  - `intents` string[], required
  - `competitor_urls` string[]

## Response `200`

Shopify public-evidence baseline completed.

- object
  - `kind` 'recommendation_audit', required
  - `audit_id` string, required
  - `report_url` string, required
  - `audit_version` string, required
  - `store` object, required
    - `url` string
    - `hostname` string
    - `platform` 'Shopify'
  - `evidence_status` 'readiness_baseline_only', required
  - `score` integer, required
  - `grade` string, required
  - `measured_at` string, date-time
  - `intents` string[], required
  - `product_profile` object, required
    - `name` string, nullable
    - `brand` string, nullable
    - `category` string, nullable
  - `suggested_questions` string[], required
  - `evidence_rows` object[], required
  - `fixes` object[], required
  - `claim_boundary` string, required

## Other responses

- `400`: Invalid JSON, URL, product count, intent count, or domain binding.
- `422`: Colter could not confirm a Shopify storefront, so no Shopify-specific recommendation was generated.

---

[API](https://skmtc.dev/agenticcom/apis/colter-public-api.md) · [All operations](https://skmtc.dev/agenticcom/apis/colter-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenticcom/apis/colter-public-api/revisions/c86a6b9228f0?raw)