Tools
check_idea
Any product idea, checked against today's app-store charts.
POST/api/agent/checkSend an idea in a few sentences. DECA places it by meaning among the apps climbing the App Store charts today and returns facts, not an opinion:
- The closest apps, how alike they are, how long they have been on the store, and their best chart position today.
- The demand pattern those apps belong to, and how much people talk about it (
heat). - What their users complain about, quoted from reviews, and what people search for that nobody answers.
- How crowded the field is:
crowd,demandandopenings, in the same plain words every time.
No model writes a verdict here, so the answer is fast and the same for the same idea on the same day. For an expected sign-up rate and a pass line, call quote_test. For a full written reading, see Score an idea.
Parameters
| Name | Type | Description |
|---|---|---|
idea.pitch |
string | Who it is for and what it does for them, 20 to 2,000 characters. Required. |
idea.name |
string | The product's name, if it has one. |
Request
curl -X POST https://app.decalabs.ai/api/agent/check \
-H "Content-Type: application/json" \
-d '{"idea":{"pitch":"A calm sorting puzzle where players type any theme and get a fresh ad-free level pack."}}'{ "name": "check_idea", "arguments": { "idea": { "pitch": "A calm sorting puzzle where players type any theme and get a fresh ad-free level pack." } } }Response
{
"day": "2026-11-21",
"field": { "crowd": "contested", "demand": "rising", "openings": "2 complaint themes and 6 unanswered searches to build on", "alike_seen_on_charts": 4, "alike_charting_today": 2, "young_and_charting": 2 },
"closest_apps": [ { "name": "…", "url": "…", "developer": "…", "likeness": 0.61, "days_on_store": 102, "chart": "#9 top free Puzzle games (BR)" } ],
"demand_patterns": [ { "name": "…", "summary": "…", "heat": "rising", "people_want": ["…"], "complaints": [ { "theme": "…", "quote": "…" } ], "unanswered_searches": ["…"] } ],
"next": "For an expected sign-up rate and a pass line, call quote_test with this pitch. …"
}The values above show the shape of the answer. Yours come from the day's charts.
Reading the field
crowd |
Apps this alike the radar has seen on the charts |
|---|---|
nothing alike charting |
none |
few alike |
1 to 2 |
contested |
3 to 5 |
crowded |
6 or more |
alike_charting_today counts those with a chart position today. Counts stop at 12.
demand is rising when people talk about the pattern more than usual, present when alike apps chart, and not seen on the charts otherwise. A field with nothing alike can mean an opening or no demand. openings tells you which.
Errors
| Code | When |
|---|---|
bad_idea |
The pitch is missing, shorter than 20 characters or longer than 2,000. |
radar_unavailable |
The charts or the matching cannot be read right now. Try again in a minute. |