API

API

A small async contract built around real research runs

The public API is intentionally narrow. Submit a concept test or quick pulse, get a job back, and keep execution on the existing AYA artifact path.

curl https://api.askyouraudience.ai/v1/concept-tests \  -H "X-Api-Key: aya_test_..." \  -H "Idempotency-Key: ct-001" \  -H "Content-Type: application/json" \  -d '{    "brief": "UK fintech app for first-time investors",    "concept": "An investing app that explains every decision in plain English"  }'

Transport

Production contract and staging transport

Production and staging both use the same /v1 contract on custom API domains. Use the raw Supabase transport only as an operator fallback when you are bypassing domain routing.

POST https://api.askyouraudience.ai/v1/concept-tests

POST https://api-staging.askyouraudience.ai/v1/concept-testsX-Api-Key: aya_test_...Content-Type: application/json

Async jobs

Poll or subscribe for completion

AYA returns async job handles so API callers, apps, and agents can move quickly without keeping long-running requests open.

GET /v1/jobs/{job_id}
{  "id": "2d6c...",  "operation": "concept-tests.run",  "status": "completed",  "linked_resource": {    "type": "concept_test_job",    "id": "b473..."  }}