Content Research Agents

List content research agents

Lists your agents. Filter with is_recurring and include_inactive.

get/v1/agents

Request

Base URL: https://api.virlo.ai
URL: https://api.virlo.ai/v1/agents
Auth: HTTP bearer

Query parameters

is_recurring'true' | 'false'

Only recurring agents (true) or only one-time agents (false). Omit for both.

include_inactive'true' | 'false'

Include paused agents (default false).

limitnumber

Example:50

Items to return (1-100, default 50). Values above 100 are clamped.

pagenumber

Example:1

Page number, 1-indexed (default 1).

Response

Agents

Example response

{
  "data": {
    "limit": 50,
    "page": 1,
    "count": 12,
    "agents": [
      {
        "keywords": [
          "protein recipes",
          "meal prep"
        ],
        "platforms": [
          "tiktok",
          "youtube",
          "instagram"
        ],
        "intent_keywords": [
          "high protein recipe",
          "protein meal prep",
          "protein dessert"
        ],
        "pinned_keywords": [
          "protein recipe",
          "highprotein"
        ],
        "latest_run": {
          "keyword_breakdown": [
            {
              "keyword": "high protein recipe",
              "videos_inserted": 41,
              "videos_updated": 12,
              "tiktok_count": 27,
              "youtube_count": 12,
              "instagram_count": 2
            }
          ]
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.