> ## Documentation Index > Fetch the complete documentation index at: https://developers.semji.com/llms.txt > Use this file to discover all available pages before exploring further. # Semji API overview > Introduction to the Semji REST API v1 — base URL, authentication, response format, rate limits, and the full list of available resources. The Semji API is a REST API that lets you integrate Semji's AI-powered content marketing platform into your own tools and workflows. Every endpoint returns JSON, requires a Bearer API key, and lives under `https://api.semji.com/v1/`. This page explains the fundamentals before you make your first request. ## Base URL All API v1 endpoints share the following base URL: ``` https://api.semji.com/v1 ``` There is no version negotiation via headers — the version is part of the path. Every endpoint documented in this reference is prefixed with `/v1/`. ## Your first API call The quickest way to verify your API key is to fetch your own user record. Replace `sk_...` with your actual key: ```bash title="cURL" theme={null} curl https://api.semji.com/v1/me \ -H "Authorization: Bearer sk_your_api_key_here" ``` A successful response looks like this: ```json title="200 OK" theme={null} { "id": "usr_01hx9z3k4m5n6p7q8r9s0t1u", "firstName": "Alice", "lastName": "Martin", "email": "alice@example.com", "profileImageUrl": null, "jobTitle": "SEO Lead", "languageCode": "en", "organization": { "id": "org_01hx9z3k4m5n6p7q8r9s0t2v", "name": "Example Corp", "createdAt": "2024-01-10T08:00:00Z", "brandName": null, "brandImageUrl": null, "credits": { "analysis": 47, "aiWriting": 12, "contentIdeasSearches": 5 }, "usersCount": 3, "workspacesCount": 2 }, "createdAt": "2024-03-15T09:12:00Z" } ``` Generate your API key in the Semji app at [Settings > Organization > API Keys](https://app.semji.com). See [Authentication](/api-reference/authentication) for full details. ## Authentication Every request must include an `Authorization` header with a Bearer token: ``` Authorization: Bearer sk_your_api_key_here ``` API keys begin with `sk_`. A missing or malformed key returns `401 Unauthorized`. A valid key without access to the requested resource returns `403 Forbidden`. See the [Authentication guide](/api-reference/authentication) for code examples in Python, Node.js, and more. ## Response format All responses use `Content-Type: application/json`. **Single resources** are returned as a flat JSON object: ```json theme={null} { "id": "...", "name": "..." } ``` **Collections** are wrapped in a standard pagination envelope: ```json theme={null} { "data": [ { "id": "...", "name": "..." } ], "pagination": { "total": 84, "page": 1, "limit": 25, "hasMore": true } } ``` Use the `page` and `limit` query parameters to paginate. `limit` accepts values from 1 to 100 and defaults to 25. ## Error format All errors follow the same shape regardless of status code: ```json theme={null} { "error": { "code": "not_found", "message": "The requested resource was not found." } } ``` The `code` field is a stable machine-readable string you can match in code. The `message` field is a human-readable description, useful for debugging. See the [Errors reference](/api-reference/errors) for the full list of codes and HTTP status codes. ## Rate limits Each API key is limited to **1,000 requests per hour** on a rolling window, with a burst limit of **20 requests per second**. Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers. Exceeding the limit returns `429 Too Many Requests`. See [Rate Limits](/api-reference/rate-limits) for details and retry guidance. ## Resources The API exposes the following resource groups. Click any card to go to the endpoint reference. Retrieve the authenticated user and their organization, and list members of your organization with their roles. List and inspect the websites you track in Semji. Each workspace contains pages, contents, keywords, and workflow configuration. Import URLs into a workspace, trigger crawls to fetch metadata, and associate focus keywords for SEO analysis. Create and manage SEO content drafts, track their Content Score (0–100), and generate full articles with Atomic Content AI. Analyze search terms to get SERP-based recommendations: topics, questions, search intents, and links to add. Analyze questions asked to AI engines (ChatGPT, Google AI Overviews) to get GEO recommendations and AI citation data. Configure editorial identities that Atomic Content uses to match your writing style, tone, and brand guidelines. Upload reference materials that the AI draws from during content generation to produce more accurate, brand-aligned output. Track the status of Atomic Content AI generation jobs, confirm generated drafts, or cancel them. View your organization's credit consumption history across keyword analyses, AI generation, and content ideas.