Commerce API & MCP › Quickstart

Your first Commerce integration

Create a developer project, then pick the path that matches how you are building. Both paths reach a useful Commerce result from signup in under two minutes.

Start with a Developer Project Sign in to Developer Console

How are you building?

Both options start from the same Developer Project. Neither path requires the other -- connect an agent directly, or call the REST API directly, without going through the other integration first.

Commerce MCP

Connect an AI agent

Suitable for supported MCP clients such as ChatGPT, Claude, Cursor, and other compatible MCP clients.

1.Create account
2.Developer Project
3.Create Commerce MCP credential
4.Copy configuration
5.Connect client
6.Ask first commerce question

From the selected Developer Project, create a Commerce MCP credential with credential_kind=commerce_mcp and commerce:read scope. Store it as NESIKA_COMMERCE_MCP_CREDENTIAL, then connect https://mcp.nesika.ai/commerce. A general REST API key cannot connect Commerce MCP. The surface exposes only search_products, resolve_product, find_offers, deep_search, get_commerce_job.

{
  "mcpServers": {
    "nesika-commerce": {
      "type": "http",
      "url": "https://mcp.nesika.ai/commerce",
      "headers": {
        "X-API-Key": "nes_your_commerce_mcp_credential"
      }
    }
  }
}

Ask your first commerce question, for example: “Find the cheapest current offer for a Sony WH-1000XM5.”

Open Commerce MCP setup

Commerce REST API

Build an application

Call the market-wide Commerce API v1 directly from your own backend or script.

1.Create account
2.Developer Project
3.Generate API key
4.Call POST /api/v1/commerce/search-products
5.Receive first result

From the selected Developer Project, create an API key with credential_kind=api_key. Store it as $NESIKA_API_KEY and use a separate key for each deployment environment. Send it with the established X-API-Key header.

curl -X POST "https://api.nesika.ai/api/v1/commerce/search-products" \
  -H "X-API-Key: $NESIKA_API_KEY" \
  -H "Idempotency-Key: 8f14e45f-2d3b-4f1c-9a71-8f2c6f2b9c31" \
  -H "Content-Type: application/json" \
  -d '{ "market": "AU", "query": "iPhone 16" }'

Generate this key from the Developer Console for an existing Developer Project.

Your first Commerce integration

How are you building?

Connect an AI agent

Build an application

Next steps

Commerce API reference

Commerce MCP

Agent recipes