Quickstart

This guide walks you through the four steps to go from zero to an AI-optimized content draft using the Semji API.

You need a Semji account to follow this guide. Sign up or log in at app.semji.com.

1. Create your API key

Open API key settings

Generate a key

Click New API key, give it a name (e.g. quickstart), and click Create.

Copy the key

Your key is shown once. Copy it now — you won’t be able to see it again. All keys start with sk_.

Treat your API key like a password. Don’t commit it to source control or include it in client-side code.

Export it in your terminal to use it in the commands below:

export SEMJI_API_KEY="sk_your_api_key_here"

TypeScript examples read exported values with process.env. Python examples read them with os.environ[...].

2. Test your key

Call GET /v1/me to verify your key works and see your organization:

const response = await fetch("https://api.semji.com/v1/me", {
  headers: { Authorization: `Bearer ${process.env.SEMJI_API_KEY}` },
});
console.log(await response.json());

import os
import requests

response = requests.get(
    "https://api.semji.com/v1/me",
    headers={"Authorization": f"Bearer {os.environ['SEMJI_API_KEY']}"},
)
print(response.json())

curl https://api.semji.com/v1/me \
  -H "Authorization: Bearer $SEMJI_API_KEY"

You should get back your user profile and organization:

{
  "id": "df286a001943",
  "firstName": "Jane",
  "lastName": "Smith",
  "email": "jane@example.com",
  "createdAt": "2024-03-15T10:30:00+00:00",
  "jobTitle": "Marketing Manager",
  "languageCode": "en",
  "profileImageUrl": null,
  "organization": {
    "id": "89b0f07aade2",
    "name": "Example Corp",
    "createdAt": "2024-01-10T08:00:00+00:00",
    "brandName": null,
    "brandImageUrl": null,
    "credits": {
      "analysis": 47,
      "aiWriting": 12,
      "contentIdeasSearches": 5
    },
    "usersCount": 3,
    "workspacesCount": 2
  }
}

3. Get your workspace

A workspace represents one website in Semji. List your workspaces to grab the id you’ll use in the next steps:

const response = await fetch("https://api.semji.com/v1/workspaces", {
  headers: { Authorization: `Bearer ${process.env.SEMJI_API_KEY}` },
});
const { data } = await response.json();
console.log(data[0].id, data[0].name);

import os
import requests

response = requests.get(
    "https://api.semji.com/v1/workspaces",
    headers={"Authorization": f"Bearer {os.environ['SEMJI_API_KEY']}"},
)
workspaces = response.json()["data"]
print(workspaces[0]["id"], workspaces[0]["name"])

curl https://api.semji.com/v1/workspaces \
  -H "Authorization: Bearer $SEMJI_API_KEY"

Save your workspace ID:

export WORKSPACE_ID="6c629e33a9a6"

4. Import a page and optimize it

Import the page

Import a URL into your workspace. You can optionally attach a focus keyword right away:

const response = await fetch(
  `https://api.semji.com/v1/workspaces/${process.env.WORKSPACE_ID}/pages`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.SEMJI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      url: "https://example.com/blog/my-article",
      focusKeyword: "content marketing strategy",
    }),
  }
);
const page = await response.json();
console.log(page.id);

import os
import requests

response = requests.post(
    f"https://api.semji.com/v1/workspaces/{os.environ['WORKSPACE_ID']}/pages",
    headers={
        "Authorization": f"Bearer {os.environ['SEMJI_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "url": "https://example.com/blog/my-article",
        "focusKeyword": "content marketing strategy",
    },
)
page = response.json()
print(page["id"])

curl -X POST "https://api.semji.com/v1/workspaces/$WORKSPACE_ID/pages" \
  -H "Authorization: Bearer $SEMJI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/blog/my-article",
    "focusKeyword": "content marketing strategy"
  }'

The response returns the page with its id and crawled metadata (title, word count, etc.). Save the page ID for the next step:

export PAGE_ID="1b81be0eb082"

Create a content draft

Create a content linked to the page you just imported:

const contentRes = await fetch(
  `https://api.semji.com/v1/workspaces/${process.env.WORKSPACE_ID}/contents`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.SEMJI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      title: "Content Marketing Strategy for 2025",
      pageId: process.env.PAGE_ID,
    }),
  }
);
const content = await contentRes.json();
console.log(content.id);

import os
import requests

response = requests.post(
    f"https://api.semji.com/v1/workspaces/{os.environ['WORKSPACE_ID']}/contents",
    headers={
        "Authorization": f"Bearer {os.environ['SEMJI_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "title": "Content Marketing Strategy for 2025",
        "pageId": os.environ["PAGE_ID"],
    },
)
content = response.json()
print(content["id"])

curl -X POST "https://api.semji.com/v1/workspaces/$WORKSPACE_ID/contents" \
  -H "Authorization: Bearer $SEMJI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"title\": \"Content Marketing Strategy for 2025\",
    \"pageId\": \"$PAGE_ID\"
  }"

Save the content ID:

export CONTENT_ID="3a89fc29d1f3"

Analyze the focus keyword

Before generating content, the focus keyword needs a completed SEO analysis. Trigger it with POST /v1/keywords/:id/analyze using the keyword ID returned during page import:

export KEYWORD_ID="b211968d8d46"

await fetch(
  `https://api.semji.com/v1/keywords/${process.env.KEYWORD_ID}/analyze`,
  {
    method: "POST",
    headers: { Authorization: `Bearer ${process.env.SEMJI_API_KEY}` },
  }
);

import os
import requests

requests.post(
    f"https://api.semji.com/v1/keywords/{os.environ['KEYWORD_ID']}/analyze",
    headers={"Authorization": f"Bearer {os.environ['SEMJI_API_KEY']}"},
)

curl -X POST "https://api.semji.com/v1/keywords/$KEYWORD_ID/analyze" \
  -H "Authorization: Bearer $SEMJI_API_KEY"

Poll GET /v1/keywords/:id until analysisStatus reaches success:

while (true) {
  const res = await fetch(
    `https://api.semji.com/v1/keywords/${process.env.KEYWORD_ID}`,
    { headers: { Authorization: `Bearer ${process.env.SEMJI_API_KEY}` } }
  );
  const kw = await res.json();
  console.log(`Analysis: ${kw.analysisStatus}`);
  if (["success", "failed"].includes(kw.analysisStatus)) break;
  await new Promise((r) => setTimeout(r, 5000));
}

import os
import time
import requests

while True:
    kw = requests.get(
        f"https://api.semji.com/v1/keywords/{os.environ['KEYWORD_ID']}",
        headers={"Authorization": f"Bearer {os.environ['SEMJI_API_KEY']}"},
    ).json()
    print(f"Analysis: {kw['analysisStatus']}")
    if kw["analysisStatus"] in ("success", "failed"):
        break
    time.sleep(5)

curl "https://api.semji.com/v1/keywords/$KEYWORD_ID" \
  -H "Authorization: Bearer $SEMJI_API_KEY"

The analysis typically completes within 30 to 90 seconds.

Launch Atomic Content

Trigger an AI content generation on the draft. Use replace to generate from scratch or optimize to rewrite existing content:

await fetch(
  `https://api.semji.com/v1/contents/${process.env.CONTENT_ID}/atomic`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.SEMJI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ type: "replace" }),
  }
);

import os
import requests

requests.post(
    f"https://api.semji.com/v1/contents/{os.environ['CONTENT_ID']}/atomic",
    headers={
        "Authorization": f"Bearer {os.environ['SEMJI_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={"type": "replace"},
)

curl -X POST "https://api.semji.com/v1/contents/$CONTENT_ID/atomic" \
  -H "Authorization: Bearer $SEMJI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "replace" }'

Poll for completion

The generation runs asynchronously. Poll GET /v1/contents/:id/generation until the status reaches review:

while (true) {
  const res = await fetch(
    `https://api.semji.com/v1/contents/${process.env.CONTENT_ID}/generation`,
    { headers: { Authorization: `Bearer ${process.env.SEMJI_API_KEY}` } }
  );
  const { status } = await res.json();
  console.log(`Status: ${status}`);
  if (["review", "failed", "cancelled"].includes(status)) break;
  await new Promise((r) => setTimeout(r, 5000));
}

import os
import time
import requests

while True:
    status = requests.get(
        f"https://api.semji.com/v1/contents/{os.environ['CONTENT_ID']}/generation",
        headers={"Authorization": f"Bearer {os.environ['SEMJI_API_KEY']}"},
    ).json()
    print(f"Status: {status['status']}")
    if status["status"] in ("review", "failed", "cancelled"):
        break
    time.sleep(5)

curl "https://api.semji.com/v1/contents/$CONTENT_ID/generation" \
  -H "Authorization: Bearer $SEMJI_API_KEY"

Possible statuses: queued → pending → review → success (after confirm) or failed / cancelled.

Confirm the draft

Once the status is review, confirm the generation to apply it to your content:

await fetch(
  `https://api.semji.com/v1/contents/${process.env.CONTENT_ID}/generation/confirm`,
  {
    method: "POST",
    headers: { Authorization: `Bearer ${process.env.SEMJI_API_KEY}` },
  }
);

import os
import requests

requests.post(
    f"https://api.semji.com/v1/contents/{os.environ['CONTENT_ID']}/generation/confirm",
    headers={"Authorization": f"Bearer {os.environ['SEMJI_API_KEY']}"},
)

curl -X POST "https://api.semji.com/v1/contents/$CONTENT_ID/generation/confirm" \
  -H "Authorization: Bearer $SEMJI_API_KEY"

Your content is now optimized. Open it in the Semji editor to review and publish.

Quickstart

1. Create your API key

2. Test your key

3. Get your workspace

4. Import a page and optimize it

Import the page

Create a content draft

Analyze the focus keyword

Launch Atomic Content

Poll for completion

Confirm the draft

What’s next?

API Reference

Authentication

​1. Create your API key

​2. Test your key

​3. Get your workspace

​4. Import a page and optimize it

​Import the page

​Create a content draft

​Analyze the focus keyword

​Launch Atomic Content

​Poll for completion

​Confirm the draft

​What’s next?

API Reference

Authentication

1. Create your API key

2. Test your key

3. Get your workspace

4. Import a page and optimize it

Import the page

Create a content draft

Analyze the focus keyword

Launch Atomic Content

Poll for completion

Confirm the draft

What’s next?