Radar

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

View as Markdown Open in Claude Open in ChatGPT

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	Description
`id`required	path	string	Opaque id from a previous response.

Response

{
  "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	Description
`id`required	path	string	Opaque id from a previous response.
`platform`	query	"instagram" \| "youtube"
`limit`	query	integer	Default 10, max 100.
`cursor`	query	string

Response

{
  "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"
    }
  ]
}