Tweet Composer API, Draft Checks & Post Preview

POST

compose

curl --request POST \
  --url https://xquik.com/api/v1/compose \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "step": "<string>",
  "topic": "<string>",
  "goal": "<string>",
  "styleUsername": "<string>",
  "tone": "<string>",
  "mediaType": "<string>",
  "callToAction": "<string>",
  "additionalContext": "<string>",
  "draft": "<string>",
  "hasLink": true,
  "hasMedia": true
}
'

import requests

url = "https://xquik.com/api/v1/compose"

payload = {
    "step": "<string>",
    "topic": "<string>",
    "goal": "<string>",
    "styleUsername": "<string>",
    "tone": "<string>",
    "mediaType": "<string>",
    "callToAction": "<string>",
    "additionalContext": "<string>",
    "draft": "<string>",
    "hasLink": True,
    "hasMedia": True
}
headers = {
    "Content-Type": "<content-type>",
    "x-api-key": "<api-key>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': '<content-type>', 'x-api-key': '<api-key>'},
  body: JSON.stringify({
    step: '<string>',
    topic: '<string>',
    goal: '<string>',
    styleUsername: '<string>',
    tone: '<string>',
    mediaType: '<string>',
    callToAction: '<string>',
    additionalContext: '<string>',
    draft: '<string>',
    hasLink: true,
    hasMedia: true
  })
};

fetch('https://xquik.com/api/v1/compose', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/compose"

	payload := strings.NewReader("{\n  \"step\": \"<string>\",\n  \"topic\": \"<string>\",\n  \"goal\": \"<string>\",\n  \"styleUsername\": \"<string>\",\n  \"tone\": \"<string>\",\n  \"mediaType\": \"<string>\",\n  \"callToAction\": \"<string>\",\n  \"additionalContext\": \"<string>\",\n  \"draft\": \"<string>\",\n  \"hasLink\": true,\n  \"hasMedia\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "checklist": [
    {
      "factor": "No external links in body",
      "passed": true
    }
  ],
  "nextStep": "All 9 checks passed. Get an account from GET /api/v1/x/accounts. Then send the draft to POST /api/v1/x/tweets. The intentUrl also supports one-click posting.\n",
  "passed": true,
  "passedCount": 9,
  "topSuggestion": "All Xquik editorial checks passed.",
  "totalChecks": 9,
  "intentUrl": "https://x.com/intent/tweet?text=PostgreSQL%2018%20reduced%20query%20latency"
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "checklist": [
    {
      "factor": "No external links in body",
      "passed": true
    }
  ],
  "nextStep": "All 9 checks passed. Get an account from GET /api/v1/x/accounts. Then send the draft to POST /api/v1/x/tweets. The intentUrl also supports one-click posting.\n",
  "passed": true,
  "passedCount": 9,
  "topSuggestion": "All Xquik editorial checks passed.",
  "totalChecks": 9,
  "intentUrl": "https://x.com/intent/tweet?text=PostgreSQL%2018%20reduced%20query%20latency"
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

Free. This endpoint does not consume credits.

Use 3 Compose calls. The endpoint returns guidance and checks. It does not write or publish the final post.

Workflow

Call compose with a topic.
If fresh context helps, fetch one suggested radarRecommendations endpoint.
Pass selected facts to refine with the topic, goal, and tone.
Write a draft. Call score with the full text.

The guidance uses Xquik editorial heuristics. It does not predict reach. X does not publish its production ranking weights.

Requests

1. Compose
2. Refine
3. Score

Returns 18 editorial rules, 4 follow-up questions, and 7 source-specific Radar recommendations.

curl https://xquik.com/api/v1/compose \
  -X POST \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "step": "compose",
    "topic": "PostgreSQL query planning",
    "goal": "authority"
  }'

Required fields: step, topic.Optional fields:

goal: engagement, followers, authority, or conversation. Defaults to engagement.
styleUsername: Username from a saved style analysis.

Returns goal, tone, media, and editorial guidance.

curl https://xquik.com/api/v1/compose \
  -X POST \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "step": "refine",
    "topic": "PostgreSQL query planning",
    "goal": "authority",
    "tone": "professional",
    "mediaType": "none"
  }'

Required fields: step, topic, goal, tone.Optional fields:

mediaType: photo, video, or none.
callToAction: Specific action the draft should request.
additionalContext: Audience, constraints, or source context.

Runs 9 deterministic text checks.

curl https://xquik.com/api/v1/compose \
  -X POST \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "step": "score",
    "draft": "PostgreSQL 18 reduced query latency by 30%. Test the JIT compiler on analytical workloads. Which result changed your rollout plan?",
    "hasLink": false
  }'

Required fields: step, draft.hasLink means a separate link card is attached. The deprecated hasMedia field remains accepted. Text checks ignore it.

Headers

Send either an API key or an authenticated session cookie.

string

Full account API key. An authenticated session cookie also works.

string

required

Use application/json.

Body

string

required

Use compose, refine, or score.

string

Required for compose and refine.

string

Required for refine. Optional for compose.

string

Saved style username for compose.

string

Required for refine.

string

Optional photo, video, or none value for refine.

string

Optional requested action for refine.

string

Optional audience, constraint, or source context for refine. Include selected facts from a recommended Radar endpoint when current context helps.

string

Required full post text for score.

boolean

Set true when a separate link card is attached during score.

boolean

Deprecated compatibility field. Text checks ignore it.

Response

200 OK

The response shape matches the requested workflow step.

Compose Response

object[]

required

18 Xquik editorial rules. Each item has rule.

string[]

required

4 questions for the next writing step.

object[]

required

7 source-specific suggestions for researching a fresh post angle.

string

required

Radar endpoint for the suggested source.

string

required

Source-specific instructions for using returned facts.

string

required

Radar source identifier.

string

required

Current-topic research that the source supports.

object[]

required

19 published signal names. Every multiplier states that X does not publish the production weight.

object[]

required

19 published signal names. Every weight is null.

string

required

States that X publishes no universal engagement window or decay rate.

string[]

required

4 negative predictions named by X’s public model. No severity order is claimed.

string

required

Signal source and evidence limits.

string

required

X post intent seeded with the topic.

string

required

Optional Radar research guidance and exact fields required for refine.

object[]

Saved styles. Present when saved styles exist and styleUsername is omitted.

string

Cached style username.

integer

Cached post count for the style.

string[]

Cached examples. Present when styleUsername matches a cached style.

string

Fallback instruction when the requested style is unavailable.

Refine Response

string[]

required

Goal, tone, media, and editorial guidance.

object[]

required

3 patterns. Each item has description and pattern.

string

required

X post intent seeded with the topic.

string

required

Exact fields required for the score call.

Score Response

The checks cover:

External links in the body
Hashtags
Excessive capitalization
Length from 50 through 280 characters
Excessive punctuation
Emojis
Em dashes, en dashes, or double dashes
At least 8 substantive words
Duplicate link-card URLs

These are Xquik style checks. They are not X ranking guarantees.

{
  "checklist": [
    { "factor": "No external links in body", "passed": true },
    { "factor": "No hashtags", "passed": true },
    { "factor": "No excessive capitalization", "passed": true },
    { "factor": "Length between 50 and 280 characters", "passed": true },
    { "factor": "No excessive punctuation", "passed": true },
    { "factor": "No emojis", "passed": true },
    { "factor": "No em dashes or double dashes", "passed": true },
    { "factor": "Sufficient substance", "passed": true },
    { "factor": "Link-in-reply strategy", "passed": true }
  ],
  "intentUrl": "https://x.com/intent/tweet?text=...",
  "nextStep": "All 9 checks passed. Get an account from GET /api/v1/x/accounts. Then send the draft to POST /api/v1/x/tweets. The intentUrl also supports one-click posting.",
  "passed": true,
  "passedCount": 9,
  "topSuggestion": "All Xquik editorial checks passed.",
  "totalChecks": 9
}

intentUrl appears only when all 9 checks pass. Failed items include a suggestion.

Errors

400 Invalid Input
401 Unauthenticated
429 Rate Limited

{
  "error": "invalid_input",
  "message": "step is required. Must be \"compose\", \"refine\", or \"score\"."
}

Missing step-specific fields also return invalid_input.

{ "error": "unauthenticated" }

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

Wait for Retry-After before retrying.

Research current context with Radar. Save accepted text with Create Draft. Analyze a reference voice with Analyze Style.

Create draftSave a tweet draft with text, an optional topic, and an optimization goal for later review, editing, or publishing without posting to X. See examples.

Tweet Composer API, Draft Checks & Post Preview

curl --request POST \
  --url https://xquik.com/api/v1/compose \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "step": "<string>",
  "topic": "<string>",
  "goal": "<string>",
  "styleUsername": "<string>",
  "tone": "<string>",
  "mediaType": "<string>",
  "callToAction": "<string>",
  "additionalContext": "<string>",
  "draft": "<string>",
  "hasLink": true,
  "hasMedia": true
}
'

import requests

url = "https://xquik.com/api/v1/compose"

payload = {
    "step": "<string>",
    "topic": "<string>",
    "goal": "<string>",
    "styleUsername": "<string>",
    "tone": "<string>",
    "mediaType": "<string>",
    "callToAction": "<string>",
    "additionalContext": "<string>",
    "draft": "<string>",
    "hasLink": True,
    "hasMedia": True
}
headers = {
    "Content-Type": "<content-type>",
    "x-api-key": "<api-key>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': '<content-type>', 'x-api-key': '<api-key>'},
  body: JSON.stringify({
    step: '<string>',
    topic: '<string>',
    goal: '<string>',
    styleUsername: '<string>',
    tone: '<string>',
    mediaType: '<string>',
    callToAction: '<string>',
    additionalContext: '<string>',
    draft: '<string>',
    hasLink: true,
    hasMedia: true
  })
};

fetch('https://xquik.com/api/v1/compose', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/compose"

	payload := strings.NewReader("{\n  \"step\": \"<string>\",\n  \"topic\": \"<string>\",\n  \"goal\": \"<string>\",\n  \"styleUsername\": \"<string>\",\n  \"tone\": \"<string>\",\n  \"mediaType\": \"<string>\",\n  \"callToAction\": \"<string>\",\n  \"additionalContext\": \"<string>\",\n  \"draft\": \"<string>\",\n  \"hasLink\": true,\n  \"hasMedia\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "checklist": [
    {
      "factor": "No external links in body",
      "passed": true
    }
  ],
  "nextStep": "All 9 checks passed. Get an account from GET /api/v1/x/accounts. Then send the draft to POST /api/v1/x/tweets. The intentUrl also supports one-click posting.\n",
  "passed": true,
  "passedCount": 9,
  "topSuggestion": "All Xquik editorial checks passed.",
  "totalChecks": 9,
  "intentUrl": "https://x.com/intent/tweet?text=PostgreSQL%2018%20reduced%20query%20latency"
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

Overview

X API

X Write

Trends

Radar

Account

API Keys

Guest Wallets

Credits

X Accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Tweet Composer API, Draft Checks & Post Preview

Workflow

Requests

Headers

Body

Response

200 OK

Compose Response

Refine Response

Score Response

Errors

​Workflow

​Requests

​Headers

​Body

​Response

​200 OK

​Compose Response

​Refine Response

​Score Response

​Errors

Workflow

Requests

Headers

Body

Response

200 OK

Compose Response

Refine Response

Score Response

Errors