Posttar API

Radar

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

View as MarkdownOpen in ClaudeOpen in ChatGPT

GET/projects/{id}/radar/analysis

Get the Radar analysis

Returns the project's latest Radar run. Check state 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.

ParameterInTypeDescription
idrequiredpathstringmax 200 charsOpaque id from a previous response. Do not build one: an id that is not a valid identifier is refused with invalid_input, and one that belongs to another workspace with not_found.

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": [

GET/projects/{id}/radar/inspirations

List 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.

ParameterInTypeDescription
idrequiredpathstringmax 200 charsOpaque id from a previous response. Do not build one: an id that is not a valid identifier is refused with invalid_input, and one that belongs to another workspace with not_found.
platformquery"instagram" | "youtube"Only inspirations found on this platform. Without it, both.
limitqueryintegerDefault 10, max 100.
cursorquerystringmax 2048 charsOpaque cursor from a previous response's next field.

Response

{
  "total": 4,
  "next": "eyJrZXkiOjkyLjksImlkIjoiRGFaV2djWHgyTFQifQ",
  "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"
    },