Pay‑per‑Answer Endpoints (x402)

First POST returns a 402 quote with Pay + intentId. After paying on‑chain, POST again with { intentId, txHash } to get the result.

Demand Insights (Visitor Chats)

Turn anonymized visitor transcripts into conversion‑ready insights (messaging, pricing, GTM).

POST /demand-insights

Request (preferred)

{
  "query": "Top objections about pricing?"
}

Response (after payment)

{
  "resultType": "chat",
  "reply": "# Markdown answer...",
  "dataHash": "...",
  "schemaVersion": "chat/v1"
}

Quote example

curl -sS -i -X POST 'https://aiagentstore.ai/demand-insights'   -H 'Content-Type: application/json'   --data-raw '{"query":"Top objections about pricing?"}'

AI Early Adopters’ Goals (1‑Year)

Answers from a live dataset of 12‑month goals by newsletter subscribers interested in AI agents.

POST /ai-early-adopters-goals

Request (preferred)

{
  "query": "What goals do early AI‑agent adopters prioritize over 12 months?"
}

Response (after payment)

{
  "resultType": "chat",
  "reply": "# Markdown answer...",
  "dataHash": "...",
  "datasetCount": 1234,
  "schemaVersion": "chat/v1"
}

Agent Conversions Analytics

Aggregated marketplace conversions by agent/category/industry/country.

POST /analytics/agent-conversions

Request

{
  "filters": {
    "aggregate": "agent", // or category|industry|country
    "country": "US"
  }
}

Response (after payment)

{
  "resultType": "analytics",
  "stats": { "aggregate": "agent", "rows": [ ... ] },
  "schemaVersion": "agent-conversions/v1"
}

Payment (x402)

POST → get a 402 with Pay header and intentId.
Send ≥ 0.49 USDC on Base (chainId 8453) to the recipient from the Pay header.
POST again with { intentId, txHash } and your body to receive the result.

Errors: intent_not_found, tx_required, tx_not_confirmed, transfer_not_found, insufficient_amount, tx_already_used, already_consumed.