cresvadevelopers
5-minute guide

Quickstart

From zero to your first query in 5 minutes. This guide walks you through connecting to the Cresva Storefront API using the Agent Commerce Protocol.

1

Create your Cresva account

Sign up for a free Cresva account at cresva.ai/signup. You'll get access to the dashboard where you can manage your brand, products, and API keys.

Screenshot: Cresva dashboard signup page
2

Connect your product catalog

From the dashboard, connect your product catalog. You can import products via:

  • CSV upload — bulk import from a spreadsheet
  • Shopify integration — one-click sync from your Shopify store
  • API — programmatically push products via the management API

Once connected, Cresva automatically generates an AI-optimized storefront for your products.

3

Get your API key

Navigate to Settings → API Keysin the dashboard. You'll see two types of keys:

  • pk_live_* — Public key for read-only access (product search, browsing)
  • sk_live_* — Secret key for full access (transactions, negotiations)

Copy your public key for this quickstart. You'll also find test keys (pk_test_*) for sandbox testing.

Environment
# Add to your .env file
CRESVA_API_KEY=pk_live_your_key_here
CRESVA_BRAND_ID=brand_abc123
4

Make your first query

Install the SDK and make your first product query:

// 1. Install the SDK
// npm install @cresva/sdk

import { CresvaClient } from "@cresva/sdk";

const client = new CresvaClient({
  apiKey: process.env.CRESVA_API_KEY,
  brandId: process.env.CRESVA_BRAND_ID,
});

// 2. Search for products
const results = await client.query({
  intent: "search",
  query: "wireless headphones under $200",
  filters: {
    price: { max: 200, currency: "USD" },
    in_stock: true,
  },
  limit: 5,
});

// 3. Display results
for (const product of results.products) {
  console.log(`${product.title} — $${product.price}`);
  console.log(`  Rating: ${product.reviews_summary?.average}/5`);
  console.log(`  Trust: ${product.trust_score?.tier}`);
  console.log();
}
5

Set up your storefront for AI agents

To make your storefront discoverable by AI agents, publish an ACP discovery file. Cresva hosts this automatically at:

URL
https://your-domain.com/.well-known/acp.json

If you're using a custom domain, add a redirect from /.well-known/acp.json to your Cresva-hosted discovery file. Cresva generates this automatically when you activate your storefront.

That's it! Your products are now queryable by any AI agent that speaks ACP. 🎉

Next steps