AIAgentStore Micro‑Pay APIs

Pay‑per‑answer endpoints using x402 (quote → on‑chain pay → redeem).

Endpoints

  • POST /demand-insights – insights from anonymized visitor chats
  • POST /ai-early-adopters-goals – insights from 1‑year goals dataset
  • POST /analytics/agent-conversions – aggregated marketplace conversions

Payment (x402)

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

Quick Start (cURL)

Demand Insights (visitor chats)

curl -sS -i -X POST 'https://aiagentstore.ai/demand-insights' \
+  -H 'Content-Type: application/json' \
+  --data-raw '{"query":"Which landing‑page claims resonate most with visitors evaluating AI agents? List top 5 themes with example copy."}'

AI Early Adopters’ Goals (1‑year dataset)

curl -sS -i -X POST 'https://aiagentstore.ai/ai-early-adopters-goals' \
+  -H 'Content-Type: application/json' \
+  --data-raw '{"query":"What are the top problems people aim to solve in the next 12 months? Rank the top 10 with brief stats and examples."}'

Agent Conversions Analytics

curl -sS -i -X POST 'https://aiagentstore.ai/analytics/agent-conversions' \
+  -H 'Content-Type: application/json' \
+  --data-raw '{"filters":{"aggregate":"category","country":"US"}}'

Errors use short codes: intent_not_found, tx_required, tx_not_confirmed, transfer_not_found, insufficient_amount, tx_already_used, already_consumed.