# SUBJCT API Documentation

> Official REST API reference for SUBJCT — the content optimisation platform for AI search. Automate internal linking, entity tagging, JSON-LD schema, and archive-scale optimisation via API.

SUBJCT is API-first. Use this documentation to authenticate, manage organisations and properties, ingest content, auto-link articles, run entity analysis, and pull metrics.

Base URL: `https://api.subjct.ai`  
Interactive docs: `https://docs.subjct.ai`  
OpenAPI (machine-readable): `https://api.subjct.ai/docs/openapi.yaml`

## Authentication

Most endpoints accept either:

- Bearer JWT: `Authorization: Bearer <User-Authentication-Token>`
- Organisation secret key: `X-Secret-Key: <Organisation-Secret-Key>`

## Docs

- [API Reference](https://docs.subjct.ai/): Interactive, server-rendered OpenAPI reference (Scalar)
- [OpenAPI specification](https://api.subjct.ai/docs/openapi.yaml): Canonical YAML schema for codegen and agents
- [llms-full.txt](https://docs.subjct.ai/llms-full.txt): Expanded agent-oriented API overview
- [OpenAPI (same-origin)](https://docs.subjct.ai/openapi.yaml): Mirrored OpenAPI document

## API areas

- [Authentication](https://docs.subjct.ai/#tag/auth): Login and auth flows
- [Organisation](https://docs.subjct.ai/#tag/org): Organisation management
- [Properties](https://docs.subjct.ai/#tag/properties): Site/property configuration
- [Search](https://docs.subjct.ai/#tag/search): Content search endpoints
- [Articles](https://docs.subjct.ai/#tag/article): Article CRUD and workflows
- [Ingest](https://docs.subjct.ai/#tag/ingest): Content ingestion
- [Analysis](https://docs.subjct.ai/#tag/analysis): Content analysis
- [Metrics](https://docs.subjct.ai/#tag/metrics): Performance and engagement metrics
- [Autolink](https://docs.subjct.ai/#tag/autolink): Automated internal linking
- [Competitors](https://docs.subjct.ai/#tag/competitors): Competitor tracking
- [Entity analysis](https://docs.subjct.ai/#tag/entity-analysis): Entity footprint and gap analysis
- [Tasks](https://docs.subjct.ai/#tag/tasks): Async task endpoints
- [Google Analytics](https://docs.subjct.ai/#tag/google-analytics): GA integrations
- [Webhooks](https://docs.subjct.ai/#tag/webhooks): Webhook configuration

## Product

- [SUBJCT website](https://www.subjct.ai/): Product overview and positioning
- [Web app](https://app.subjct.ai/): Sign in to the SUBJCT application
- [Contact](https://www.subjct.ai/contact): Sales and support

## Optional

- [Robots](https://docs.subjct.ai/robots.txt): Crawler policy
- [Sitemap](https://docs.subjct.ai/sitemap.xml): Indexable URLs