Skip to main content
POST
Create article

Authorizations

Authorization
string
header
required

Your API key. Create one in Settings, API keys. Send it as Authorization: Bearer rk_live_YOUR_KEY.

Path Parameters

project
string
required

The project id. 24 characters. From List projects.

Pattern: ^[0-9a-f]{24}$

Body

application/json
prompt_id
integer
required

The prompt the article targets.

keyword
string
required

The keyword the article should rank for, as in the Create Content dialog.

Maximum string length: 255
article_type
enum<string>

The article format. Default is the format the cited pages use most.

Available options:
blog_post,
listicle,
comparison,
alternatives,
faq,
first_person_review
country
string

Two-letter country the article should rank in; drives the SERP research. Default is the project region.

Required string length: 2
language
enum<string>

Language of the SERP research and of the article. Default is English.

Available options:
en,
da,
de,
es,
fr,
it,
pt,
nl,
pl,
ru
additional_details
string

Instructions for the writer.

Maximum string length: 1500
force
boolean

Write a new article even if one for the same prompt, type and keyword exists.

sheet
string

Name of the content sheet the article row goes on, under Agents → Sheets. Default is the project's "API" sheet. A sheet holds 50 rows; a full one rolls over to "Name 2" and meta.sheet tells you where the row landed.

Maximum string length: 80

Response

The run has started.

data
object
meta
object
credits
object

What this call cost and what is left. Also in the X-RadarKit-Credits-Charged and X-RadarKit-Credits-Remaining headers.

request_id
string

A unique id for this call. Also in the X-Request-Id header. Quote it when you contact support.

Example:

"req_01j9x4m2p7q8r9s0t1u2v3w4x5"