# get_signals

> The day's demand patterns from DECA's radar, with the apps, reviews and posts behind them.

**GET /api/agent/signals · MCP tool get_signals · Free**
Every day DECA's radar reads the App Store and Google Play charts in dozens of countries, finds the apps that are climbing, and groups them into **patterns**: several apps answering the same want. For each pattern it listens to what people say about it in reviews and posts. `get_signals` returns those patterns, strongest first.

## Parameters

| Name | Type | Description |
|---|---|---|
| `query` | string | Words that must all appear in the pattern, its apps or what people say. Optional. |
| `heat` | `rising` · `steady` | Only patterns people are talking about this much. Optional. |
| `limit` | integer | How many to return, 1 to 25. Default 10. |

## Request

```bash title="cURL"
curl "https://app.decalabs.ai/api/agent/signals?heat=rising&limit=5"
```

```json title="MCP"
{ "name": "get_signals", "arguments": { "heat": "rising", "limit": 5 } }
```

```ts title="TypeScript"
const res = await fetch("https://app.decalabs.ai/api/agent/signals?heat=rising&limit=5");
const { signals } = await res.json();
```

## Response

```json
{
  "day": "2026-11-18",
  "read": { "apps": 36722, "charts": 1003, "pockets": 60, "rising": 14 },
  "count": 1,
  "signals": [
    {
      "id": 1632,
      "name": "Paid film-look camera apps",
      "summary": "Paid camera apps that apply vintage, film, or cinematic color looks to photos and video, aimed at people who want a stylized image without editing.",
      "heat": "rising",
      "apps": [
        { "name": "Chromagraph Camera", "url": "https://apps.apple.com/us/app/chromagraph-camera/id6803329435", "fact": "29 days old · #1 paid in Photo & Video (DE)" },
        { "name": "Very Good Camera", "url": "https://apps.apple.com/us/app/very-good-camera/id6760676546", "fact": "28 days old · #20 paid in Photo & Video (GB)" }
      ],
      "people_say": ["Early reviews praise Chromagraph's distinctive image rendering, while some users mention interface issues."],
      "people_want": ["An Android version of Chromagraph, which reviewers say it lacks."],
      "posts": [{ "title": "Chromagraph Camera Review", "url": "https://www.youtube.com/watch?v=ey8s3xHnf_c", "where": "YouTube" }],
      "ideas": 0
    }
  ]
}
```

| Field | Description |
|---|---|
| `day` | The day the radar read, in UTC. |
| `read` | How much it read that day: apps, charts, patterns, and patterns people are talking about more. |
| `signals[].heat` | `rising`, `steady` or `quiet`: how much people are talking about the pattern. `null` when it was not heard. |
| `signals[].apps[].fact` | The app's age and its best place on one store category's chart in one country. A place is never on a store's overall chart. |
| `signals[].people_say` | What people say about the pattern, in short sentences. |
| `signals[].people_want` | What they ask for that the apps do not give them. |
| `signals[].ideas` | How many ideas DECA wrote from this pattern. Read them with [`get_ideas`](https://app.decalabs.ai/docs/tools/get-ideas). |

> **Note** · The radar updates once a day. Answers are cached for up to ten minutes.

Source: https://app.decalabs.ai/docs/tools/get-signals
