The content creation workflow at a glance
Research target keywords and competitor URLs
Call Get SERP URLs to research your topic and validate your target keywords and competitor URLs for which your draft will be optimized for. This is a pre-requisite for creating a draft: the results feed the
phrases and competitorUrls fields in the next step.Create a draft
Call Create a draft with the keyword phrases and competitor URLs you selected. This returns a
draftId used by every subsequent step.Request content insights
Call Request content insights to start generating insights for the draft. This kicks off an asynchronous process, so the request returns immediately without the results.
Get content insights
Poll Get content insights to check the status and retrieve the results of the insights generation request once it completes.
Generate a Content Score
Call Generate content score to produce a score and detailed evaluation of the draft’s content across intent alignment and topical coverage. Use this score to determine how close to publication-ready your draft is.
Validate content guidance
Call Validate content guidance to check your draft’s content against the generated insights and see how well it satisfies the recommendations.
Generate your draft
Call Generate your content to generate content—outlines, drafts, meta descriptions, title tags, and more—that is aligned with the insights and content score for the draft.
You can also write and revise your
bodyCopy field manually—or pipe it in from wherever you draft content—with the Update draft endpoint.Update your draft and iterate
Update your draft’s
bodyCopy via Update a draft.