Market Research Example
Create a structured market brief from product, audience, competitors, objective, and constraints.
When to use this task
Use these examples as starting points, then adapt the input contract to your own product.
Request JSON
Send this payload to /v1/generate with your OneAI API key.
{
"type": "market_research",
"input": {
"product": "Unified model gateway plus Task Intelligence API",
"audience": "SaaS builders",
"competitors": [
"generic model gateways",
"AI workflow tools"
],
"objective": "Find a practical launch wedge"
},
"options": {
"llm": {
"mode": "balanced",
"maxCostUsd": 0.05
}
}
}cURL
Use Idempotency-Key for production retries and store requestId from the response.
curl -s https://oneai-saas-api-production.up.railway.app/v1/generate \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_ONEAI_API_KEY" \
-H "Idempotency-Key: market-research-001" \
-d '{"type":"market_research","input":{"product":"Unified model gateway plus Task Intelligence API","audience":"SaaS builders","competitors":["generic model gateways","AI workflow tools"],"objective":"Find a practical launch wedge"},"options":{"llm":{"mode":"balanced","maxCostUsd":0.05}}}' | jqExample output shape
Actual model wording can vary, but your integration should expect the same business-level structure.
{
"marketSummary": "SaaS builders need more than model access; they need governed task outputs they can sell.",
"targetSegments": [
"AI SaaS founders",
"developer tools",
"support automation teams"
],
"competitors": [
"Model gateways",
"prompt workflow tools",
"agent frameworks"
],
"wedge": "Position OneAI as Task Intelligence plus cost-controlled model gateway.",
"risks": [
"Crowded model gateway market",
"Need proof from real customer workflows"
],
"recommendedNextSteps": [
"Publish use cases",
"Run customer pilots",
"Measure task adoption"
]
}Use balanced mode for structured research. Upgrade to premium only for high-value enterprise briefs.
This example is available on the Pro tier. Free examples are suitable for initial testing. Pro examples are designed for customer-facing workflows.
Common mistakes
Most integration issues come from missing context or using the wrong plan for the task tier.
Load the matching preset in Playground, run a real request, then copy the final payload into your backend.