# Radar

2 endpoints for radar, with parameters and a real response example.

## GET /projects/{id}/radar/analysis

**Get the project's latest Radar analysis**

Returns the project's latest Radar run. Check `estado` first: a run may be in progress, interrupted, failed, or there may be none yet. Starting a new run only happens from the Radar screen, not through the API.

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes | Opaque id from a previous response. |

Response:

```json
{
  "state": "completed",
  "startedAt": "2026-08-22T00:45:37.177413+00:00",
  "phase": null,
  "error": null,
  "lastCompleted": {
    "id": "12831dc4-f950-4125-aa85-0a31cac0c66d",
    "completedAt": "2026-08-22T00:45:37.177413+00:00",
    "insight": null,
    "targets": {
      "terms": [
        "instagram"
      ],
      "hashtags": [],
      "yt_terms": [],
      "competitors": [
        "use.posttar"
      ],
      "yt_channels": []
    },
    "kpis": {
      "all": {
        "views": 1280681274,
        "studied": 109
      },
      "youtube": {
        "views": 0,
        "studied": 0
      },
      "instagram": {
        "views": 1280681274,
        "studied": 109
      }
    }
  }
}
```

## GET /projects/{id}/radar/inspirations

**List the project's Radar inspirations**

Lists the posts Radar has already found for this project, best to worst, with who published each one, the link, the caption, and the views. Read-only: does not start an analysis and does not create a post.

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes | Opaque id from a previous response. |
| `platform` | query | "instagram" | "youtube" | no |  |
| `limit` | query | integer | no | Default 10, max 100. |
| `cursor` | query | string | no |  |

Response:

```json
{
  "total": 4,
  "next": "eyJjaGF2ZSI6OTIuOSwiaWQiOiJEYVpXZ2NYeDJMVCJ9",
  "inspirations": [
    {
      "shortcode": "DcNflthvNwy",
      "url": "https://www.instagram.com/p/DcNflthvNwy/",
      "handle": "simran.verma125",
      "caption": "Relatable 💯…\n•\n•\n#Corporate #instagram #reels #viral #follow , Explore, Office, work, Comedy, Corporatelife, employees, reality",
      "platform": "instagram",
      "format": "video",
      "score": 93.4,
      "views": 13856429,
      "firstSeenAt": "2026-08-22T00:43:51.906847+00:00",
      "publishedAt": "2026-08-19T07:04:52+00:00"
    },
    {
      "shortcode": "DaZWgcXx2LT",
      "url": "https://www.instagram.com/p/DaZWgcXx2LT/",
      "handle": "fyndingplaces",
      "caption": "😂🔥 Think you know every Instagram trick? Think again! 👀📱\n\nI just shared 3 fun Instagram pranks that will leave your friends totally confused! 🤯🤣 These are easy to try, harmless,...",
      "platform": "instagram",
      "format": "video",
      "score": 92.9,
      "views": 11870423,
      "firstSeenAt": "2026-08-22T00:43:21.423496+00:00",
      "publishedAt": "2026-07-05T03:32:33+00:00"
    }
  ]
}
```