Content Research Agents

Suggest keywords for an intent

Given an intent, returns a quality-graded keyword set you can pass straight to POST /v1/agents. Free and synchronous — no agent is created and no credits are spent, so you can iterate until the quality score looks right.

post/v1/agents/suggest-keywords

Request

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

Request body

intentstring required

What the agent should research, in plain language. Same field you will pass to POST /v1/agents.

topic_hintstring

Short topic or agent-name hint to steer generation.

platformsstring[]

Platforms the agent will collect from.

existing_keywordsstring[]

The agent’s current keywords. Required in practice for refresh and opportunity modes so the engine can avoid repeating them.

mode'create' | 'refresh' | 'opportunity'

create (default) builds a fresh set from the intent. refresh replaces stale keywords on an existing agent. opportunity looks for under-covered angles adjacent to the current set.

desired_countnumber

How many keywords to aim for. Clamped by the engine to the data-backed 7-12 sweet spot — beyond ~15 keywords the off-target ratio climbs sharply.

use_web_groundingboolean

Ground generation in current web results so timely phrasing is picked up. Slower; leave off for evergreen niches.

Example request

{
  "intent": "Track viral protein-recipe content for a fitness brand",
  "topic_hint": "Protein Recipes",
  "platforms": [
    "tiktok",
    "instagram"
  ],
  "existing_keywords": [
    "high protein recipe"
  ],
  "desired_count": 7
}

Response

Suggested keywords

Changes

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