Content brief (AEO)

Generates a content brief for a keyword, built from an analysis of the keywords currently ranking. The brief includes a recommended content blueprint, an answer-first (AEO) strategy, and an FAQ derived from People Also Ask. This is an asynchronous job.

Requires SERP analysis first

A brief is built from the keyword's SERP. Analyse the keyword via SERP overview before requesting a brief, or pass `analyze: true` to do both in one call.

Create a brief

POST/keywords/content-brief

Body parameters

Parameter	Type	Description
`keyword`required	string	The keyword to build a brief for.
`country`	string	2-letter ISO country code. Defaults to `us`.
`analyze`	boolean	Run SERP analysis first if it hasn't been done. Defaults to `false`.

cURL

curl -X POST "https://api.oneclickseo.ai/v1/keywords/content-brief" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "what is link building", "analyze": true }'

Fetch the brief

GET/keywords/content-brief/{job_id}

200Completed content brief

Response

{
  "data": {
    "id": "job_a12d8e",
    "status": "completed",
    "blueprint": {
      "target_word_count": 1800,
      "heading_count": 9,
      "content_type": "guide",
      "nlp_terms": ["anchor text", "domain authority", "outreach"]
    },
    "aeo": {
      "direct_answer": "Link building is the process of...",
      "answer_first_headings": ["What is link building?", "Why it matters"],
      "faq": [
        { "question": "Is link building still relevant?", "answer": "Yes..." }
      ],
      "schema_recommendations": ["FAQPage", "Article"]
    }
  },
  "meta": { "request_id": "req_8f2c1a", "credits_charged": 3 }
}

Key fields

Parameter	Type	Description
`blueprint`	object	Target structure: word count, headings, content type and NLP terms harvested from competitors.
`aeo`	object	Answer-engine strategy: direct answer, answer-first headings, FAQ (from PAA) and JSON-LD schema recommendations.