Quick Start

Get up and running with the ArticlesQ API in under 5 minutes. Create a project, generate an API key, and pull your first article.

Create a project

Sign in to ArticlesQ and create a project for the website you want to publish to. Each project has its own brand voice, niche, and article history — and its own API keys.

Open Settings → Integrations & API for your project and click Create Key. Pick the scopes you need (start with articles:read) and copy the aq_live_... value once — it won't be shown again.

Each API key is scoped to a single project. The same key can never read another project's articles.

Authenticate

Pass the key as a Bearer token in every request:

curl https://articlesq.com/api/v1/articles \
  -H "Authorization: Bearer aq_live_..."

List your articles

curl https://articlesq.com/api/v1/articles \
  -H "Authorization: Bearer aq_live_..."

Returns a paginated list of articles for the project the key belongs to. Use ?page=1&limit=20 to navigate. The default page size is 20 (max 100).

Fetch a single article

curl https://articlesq.com/api/v1/articles/best-crm-for-startups \
  -H "Authorization: Bearer aq_live_..."

Slugs are unique within a project. The single-article endpoint returns the full markdown body in content.

Key concepts

A Project is one website. It has its own brand voice, ICP, and article history. Every API key belongs to exactly one project.
An Article is markdown plus metadata (title, slug, keyword, meta description). Slugs are unique within a project.
Scopes control what an API key is allowed to do — for example, a read-only key can fetch articles but can't modify them. Choose the minimum scopes you need when creating a key as a security measure.

Next steps

Install the TypeScript SDK for a type-safe client with autocomplete and error handling built in.
Read the API Reference for the full list of endpoints with request schemas, response shapes, and error codes.