# Semji Help Center

- [Help Center (207 pages)](https://help.semji.com/_llms/en/help-center.txt): Documentation for Help Center.

## Home

- [How can we help you?](https://help.semji.com/index.md): Guides, tutorials and best practices to get the most out of the platform, from your first import to automating with AI.

## Getting Started

- [First steps](https://help.semji.com/en/getting-started/first-steps.md): Create your account, invite your team, and set up your workspace.
- [Getting started with Semji](https://help.semji.com/en/getting-started/getting-started-with-semji.md): Everything you need to go from a brand-new account to your first optimized draft, in nine steps.
- [Connect your data](https://help.semji.com/en/getting-started/connect-your-data.md): Connect Search Console and your analytics tools to bring your existing performance data into Semji.
- [Users & permissions](https://help.semji.com/en/getting-started/users-and-permissions.md): Manage who has access to your workspace and what they can do.
- [Create your first content](https://help.semji.com/en/getting-started/create-your-first-content.md): Create your first piece of content and get familiar with the Semji editor.

### Set up your AI

- [Set up your AI](https://help.semji.com/en/work-faster-with-ai/setting-up-your-ai-environment.md): Configure your Knowledge Base, Brand Voice, and presets to get generations tailored to your brand.
- [Know everything on AI+ Knowledge Base: Create more relevant, optimized, and faster content! 🚀](https://help.semji.com/en/work-faster-with-ai/know-everything-on-ai-knowledge-base-create-more-relevant-optimized-and-faster-content.md): AI+ Knowledge transforms content creation by leveraging your specific information sources to produce accurate and optimized texts.
- [How to configure your Brand Voice?](https://help.semji.com/en/work-faster-with-ai/how-to-use-semjis-ai-brand-voice.md): AI+ Brand Voice will transform your content by adding your brand's unique tone.
- [AI+ Knowledge Base: Create a Knowledge Base](https://help.semji.com/en/work-faster-with-ai/ai-knowledge-base-create-a-knowledge-base.md): Centralize your information to generate high-quality AI content 🚀

## Developer

### Quickstart

#### Quickstart

- [Semji API & MCP Documentation](https://help.semji.com/developers/overview.md): Integrate Semji into your workflows through the REST API, or let Claude, ChatGPT, or any AI assistant drive your workspace via the MCP server.
- [Quickstart](https://help.semji.com/quickstart.md): Create your API key, retrieve your workspace, import a page, and optimize it with Atomic Content — all from the command line.

### Guides

#### Guides

- [Semji API guides overview](https://help.semji.com/guides/overview.md): End-to-end guides that combine several Semji API endpoints: sync drafts to your CMS and get SEO and GEO recommendations from a keyword.
- [Sync drafts to your CMS](https://help.semji.com/guides/sync-drafts-to-cms.md): Poll Semji for drafts ready to publish, push them to your CMS, then mark them as published in Semji, with a push-based webhook alternative.
- [Get SEO & GEO recommendations from a keyword](https://help.semji.com/guides/seo-geo-recommendations.md): Create a draft from a focus keyword, run a keyword analysis, and pull back the typed SEO (Google Search) and GEO (Google AI Overview) recommendations.

### API Reference

#### Overview

- [Semji API overview](https://help.semji.com/api-reference/overview.md): Introduction to the Semji REST API v1 — base URL, authentication, response format, rate limits, and the full list of available resources.
- [Authentication](https://help.semji.com/api-reference/authentication.md): Generate a Semji API key from Settings, send it as a Bearer token on every request, and handle 401 Unauthorized and 403 Forbidden errors in your integration.
- [Rate Limits](https://help.semji.com/api-reference/rate-limits.md): Understand Semji API rate limits, how to read rate limit response headers, handle 429 errors, and implement exponential backoff in your integration.
- [Errors](https://help.semji.com/api-reference/errors.md): Full reference for Semji API error codes, HTTP status codes, error response format, and handling strategies including retries and validation errors.

#### Me

- [Get authenticated user](https://help.semji.com/api-reference/me/get-authenticated-user.md): Returns the user authenticated by the API key, with the linked organization embedded.

#### Users

- [List organization members](https://help.semji.com/api-reference/users/list-organization-members.md): Returns all members of the organization linked to the API key, with their role.

#### Workspaces

- [List workspaces](https://help.semji.com/api-reference/workspaces/list-workspaces.md): Returns all workspaces in the organization accessible to the authenticated user.
- [Get workspace details](https://help.semji.com/api-reference/workspaces/get-workspace-details.md): Returns details of a specific workspace.
- [List workspace members](https://help.semji.com/api-reference/workspaces/list-workspace-members.md): Returns all members of a workspace with their role.
- [List content statuses](https://help.semji.com/api-reference/workspaces/list-content-statuses.md): Returns all content statuses for a workspace, ordered by position. Includes system statuses ("to do", "published") which are read-only.

#### Folders

- [List folders](https://help.semji.com/api-reference/folders/list-folders.md): Returns all folders in a workspace as a flat list. Use parentFolderId to reconstruct the tree.
- [Create a folder](https://help.semji.com/api-reference/folders/create-a-folder.md): Creates a new folder in the workspace.
- [Update a folder](https://help.semji.com/api-reference/folders/update-a-folder.md): Updates a folder name or parent. Returns the updated folder.
- [Delete a folder](https://help.semji.com/api-reference/folders/delete-a-folder.md): Deletes a folder. Contents inside the folder are not deleted — they become unorganized.

#### Pages

- [List pages in a workspace](https://help.semji.com/api-reference/pages/list-pages-in-a-workspace.md): Returns a paginated list of tracked pages in the workspace. Supports text search, category filtering, and sorting.
- [Import a page](https://help.semji.com/api-reference/pages/import-a-page.md): Imports an existing URL into the workspace (crawls it to extract title, meta description, etc.). Use this for pages you already have online and want to track. Optionally sets a URL category and focus keyword. To create a new editorial draft that does not yet have a URL, use POST /v1/workspaces/:work…
- [Get page details](https://help.semji.com/api-reference/pages/get-page-details.md): Returns full details of a page, including its focus keyword.
- [Update a page](https://help.semji.com/api-reference/pages/update-a-page.md): Updates a page focus keyword and/or URL category. The URL category cannot currently be unset once assigned.
- [Delete a page](https://help.semji.com/api-reference/pages/delete-a-page.md): Deletes a page and its associated contents.
- [Crawl a page](https://help.semji.com/api-reference/pages/crawl-a-page.md): Triggers an asynchronous crawl to refresh the page metadata (title, meta description, etc.). Poll GET /v1/pages/:pageId to see updated data.

#### Contents

- [List contents in a workspace](https://help.semji.com/api-reference/contents/list-contents-in-a-workspace.md): Returns a paginated list of contents. Supports filtering by status, assignee, folder, due date, and text search.
- [Create a content](https://help.semji.com/api-reference/contents/create-a-content.md): Creates a new content draft in the workspace. Pass pageId to attach the draft to an existing imported page, or omit it to create a blank draft (editorial brief with no URL) — in that case an empty page is auto-created and returned in the response.
- [List contents for a page](https://help.semji.com/api-reference/contents/list-contents-for-a-page.md): Returns all content versions associated with a specific page.
- [Get content details](https://help.semji.com/api-reference/contents/get-content-details.md): Returns full details of a content, including HTML body, version, and embedded relations.
- [Update a content](https://help.semji.com/api-reference/contents/update-a-content.md): Updates a content. The version field is required for optimistic locking.
- [Delete a content](https://help.semji.com/api-reference/contents/delete-a-content.md): Permanently deletes a content. This action cannot be undone.
- [Mark a content as published](https://help.semji.com/api-reference/contents/mark-a-content-as-published.md): Marks the content as published in Semji. Call this endpoint after the content has been published on your CMS. If no URL is provided, the associated page URL is used. If no publication date is provided, the current server time is used.
- [Generate Atomic Content](https://help.semji.com/api-reference/contents/generate-atomic-content.md): Launches an AI content generation on the draft. The keyword must have a completed SEO analysis. Poll GET /v1/contents/:contentId/generation to track progress.

#### Content Generations

- [Get generation status](https://help.semji.com/api-reference/content-generations/get-generation-status.md): Returns the current status of the Atomic Content generation attached to a content. Poll this endpoint to track progress.
- [Confirm a generation](https://help.semji.com/api-reference/content-generations/confirm-a-generation.md): Confirms and accepts the generated content. The draft is updated with the generation result. Requires status = "review".
- [Cancel a generation](https://help.semji.com/api-reference/content-generations/cancel-a-generation.md): Cancels a generation that is queued, pending, or awaiting review.

#### Content Ideas

- [Start a content idea search](https://help.semji.com/api-reference/content-ideas/start-a-content-idea-search.md): Launches an asynchronous Content Ideas search for a keyword in the workspace. Consumes one content-ideas-searches credit. Returns immediately with the search id and status 'pending' — poll GET /v1/content-idea-searches/:contentIdeaSearchId until status is 'success', then read the results with GET /v…
- [Get a content idea search](https://help.semji.com/api-reference/content-ideas/get-a-content-idea-search.md): Returns a content idea search and its processing status (pending → success / failed). Use it to poll an asynchronous search started with POST.
- [Delete a content idea search](https://help.semji.com/api-reference/content-ideas/delete-a-content-idea-search.md): Deletes a content idea search and all of its content ideas.
- [List content ideas of a search](https://help.semji.com/api-reference/content-ideas/list-content-ideas-of-a-search.md): Returns a paginated list of the content ideas produced by a completed search. Each idea carries its keyword, URL, search volume, keyword difficulty, estimated traffic, relevance and the workspace's own ranking on the keyword. Supports filtering (keyword, title, url, type, keywordBrand, and gte/lte r…

#### Credit Usages

- [List credit usages](https://help.semji.com/api-reference/credit-usages/list-credit-usages.md): Returns the credit consumption history for the organization, paginated. Each entry details a credit consumed with its context.

#### Keywords

- [List keywords for a page](https://help.semji.com/api-reference/keywords/list-keywords-for-a-page.md): Returns all keywords associated with a page. Not paginated (pages rarely have more than 50 keywords).
- [Add a keyword to a page](https://help.semji.com/api-reference/keywords/add-a-keyword-to-a-page.md): Associates a keyword with a page. Creates the keyword if it does not exist.
- [Get keyword details](https://help.semji.com/api-reference/keywords/get-keyword-details.md): Returns full details of a keyword, including analysis status and focus prompt.
- [Update a keyword](https://help.semji.com/api-reference/keywords/update-a-keyword.md): Updates a keyword (e.g. set or remove the focus GEO prompt).
- [Launch keyword analysis](https://help.semji.com/api-reference/keywords/launch-keyword-analysis.md): Triggers an asynchronous analysis on a keyword (Google Search organic SERP scrape, recommendations computation). Poll GET /v1/keywords/:keywordId to track progress via analysisStatus.
- [Generate keyword analysis report](https://help.semji.com/api-reference/keywords/generate-keyword-analysis-report.md): Returns an analysis report for the keyword, scoring the provided content against each surface. The report contains the data computed by the keyword analysis — an overall score, typed recommendations (each with its own sub-score and supporting data), and surface-specific context: SERP competitors for…

#### Prompts

- [List prompts for a keyword](https://help.semji.com/api-reference/prompts/list-prompts-for-a-keyword.md): Returns GEO prompts associated with a keyword.
- [Create a prompt](https://help.semji.com/api-reference/prompts/create-a-prompt.md): Creates a GEO prompt for a keyword.
- [Get prompt details](https://help.semji.com/api-reference/prompts/get-prompt-details.md): Returns details of a prompt. Useful for polling analysisStatus after launching a GEO analysis.
- [Launch prompt analysis](https://help.semji.com/api-reference/prompts/launch-prompt-analysis.md): Triggers an asynchronous analysis on a prompt (ChatGPT). The parent keyword must have a completed keyword analysis. Poll GET /v1/prompts/:promptId to track progress.
- [Generate prompt analysis report](https://help.semji.com/api-reference/prompts/generate-prompt-analysis-report.md): Returns an analysis report for the prompt, scoring the provided content against ChatGPT. The report contains the data computed by the prompt analysis — an overall score, typed recommendations (each with its own sub-score and supporting data), the cited sources, the mentioned brands, and the markdown…

#### Brand Voices

- [List brand voices](https://help.semji.com/api-reference/brand-voices/list-brand-voices.md): Returns all brand voices configured for a workspace. Use the brand voice ID in POST /v1/contents/:contentId/atomic settings.
- [Get brand voice details](https://help.semji.com/api-reference/brand-voices/get-brand-voice-details.md): Returns details of a brand voice.

#### Knowledge Documents

- [List knowledge documents](https://help.semji.com/api-reference/knowledge-documents/list-knowledge-documents.md): Returns all knowledge documents in a workspace. Enable knowledge sources in POST /v1/contents/:contentId/atomic settings.
- [Get knowledge document details](https://help.semji.com/api-reference/knowledge-documents/get-knowledge-document-details.md): Returns details of a knowledge document.

### Webhooks

- [Webhooks](https://help.semji.com/integrations/overview.md): Semji's webhook events: get notified when a draft is staged for review or when it's published, so you can push content to your CMS or trigger downstream automations.
- [Send to CMS webhook](https://help.semji.com/integrations/send-to-cms-webhook.md): The content_staged webhook contract: how Semji pushes a draft to your CMS endpoint before publication and how your endpoint responds.
- [Content published webhook](https://help.semji.com/integrations/content-published-webhook.md): How the content_published webhook notifies your endpoint when an editor marks a content as published in Semji, with Make and N8n templates.

### Agents (MCP)

#### MCP server

- [Semji MCP server](https://help.semji.com/mcp/overview.md): Connect your AI assistant to Semji and drive your SEO and GEO content workflow in plain language.
- [Connect to Semji](https://help.semji.com/mcp/connecting.md): Add the Semji MCP server to Claude and any other MCP-compatible assistant.
- [Configure Semji MCP server toolsets and read-only scope](https://help.semji.com/mcp/configuration.md): Scope the Semji MCP server URL to specific toolsets like planning, content-generation, and knowledge-base, with an optional read-only mode.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)

## Optional

- [Status](https://status.semji.com/)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [English / Help Center (207 pages)](https://help.semji.com/_llms/en/help-center.txt): Documentation for English / Help Center.
- [French (286 pages)](https://help.semji.com/_llms/fr.txt): Documentation for French.
- [French / Centre d'aide (214 pages)](https://help.semji.com/_llms/fr/centre-d-aide.txt): Documentation for French / Centre d'aide.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.