Content brief

Turn live SERP intent into a production-ready content brief for writers and agents. Costs 6 credits.

post/content/brief

Request

  • Base URL: https://www.agentseo.dev/api/v1
  • URL: https://www.agentseo.dev/api/v1/content/brief
  • Auth: API key in header x-api-key

Query parameters

syncboolean

Open a short inline processing window when supported by the endpoint. If the result is not ready yet, the endpoint may still return 202 with a queued payload that includes poll_url, events_url, and retry_after_seconds.

Headers

x-project-idstring

Optional attribution label for grouping usage and jobs by project.

x-workflow-idstring

Optional attribution label for grouping usage and jobs by workflow or agent run.

Request body

keywordstring required
targetstring

Optional target brand, domain, or product.

audiencestring

Optional audience description for writer guidance.

brand_voice'neutral' | 'expert' | 'friendly' | 'bold' | 'technical'
page_type'auto' | 'blog_post' | 'landing_page' | 'comparison_page' | 'guide' | 'tool_page'
locationstring
location_codeinteger

Optional search location code for deterministic geo-targeting.

languagestring
device'desktop' | 'mobile'
brief_depth'standard' | 'detailed'
include_serp_outlineboolean

Response

Completed content brief workflow with agent_workflow

keywordstring
targetstring nullable
content_briefobject
outlineobject nullable
markdown_summarystring

Changes

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