Content API

An API that serves content our editors build together with AI and verify against their editorial standards, in JSON, Markdown, TXT, HTML and JSON-LD across multiple languages. The same key also covers semantic search, text-to-speech audio metadata and datasets for model training and RAG indexing (text corpus, instruction pairs, multilingual parallel), while raw embedding vectors and audio mp3 files come with the Pro plan. Get a free key and start right away.

Pricing

API test

Usage

Call the API with your key in the Authorization header. Below are the endpoints, parameters, response formats and examples.

Endpoints

Datasets (training and RAG)

For work that needs many records at once - model training, fine-tuning, RAG indexing - content is normalized into training-ready schemas. page, per_page, category, tag and updated_since behave exactly as in the list and single-item APIs, and format=jsonl feeds straight into a training pipeline.

The per_page cap is 10 on the Free plan and up to 100 per kind on Pro (20 for embeddings). Credits are computed from the requested per_page, so a bulk call costs less than fetching the same volume one item at a time.

The dataset API does not replace the free data files. The unauthenticated paths that serve individual articles as TXT, Markdown, JSON and JSON-LD remain free exactly as they are today. Free data access guide

Available languages

• Tier 1 - Languages whose translations have been reviewed. Everything is provided: human-readable web pages, search exposure (sitemap and hreflang), AI audio (TTS) and embeddings.
• Tier 2 - Machine-translated, data-only languages. Served through data files and the API only - no web pages, no search exposure, no audio (TTS) and no embeddings. Every file carries a translation_status: machine label to mark that it has not been reviewed.

Pass these values directly as the API's lang parameter. Single content and dataset endpoints accept tier 2 languages, while the audio (TTS) and embedding endpoints answer for tier 1 languages only.

Query parameters

Supported formats (single content format)

Examples

Authenticate with the Authorization: Bearer header or the X-Api-Key header.

# List
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/contents?lang=ko&page=1&per_page=20"

# Filter by category
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/contents?lang=ko&category=<CATEGORY_SLUG>"

# Filter by tag
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/contents?lang=ko&tag=<TAG_SLUG>"

# Incremental sync (modified since a datetime)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/contents?updated_since=2026-01-01T00:00:00Z"

# Single content (HTML format)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/contents/<CONTENT_ID>?lang=ko&format=html"

# Look up by slug (Markdown format)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/contents/by-slug/<SLUG>?lang=ko&format=md"

# Image metadata
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/contents/<CONTENT_ID>/images"

# Category list
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/categories?lang=ko"

# Tag list
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/tags?lang=ko"

# Binder list
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/binders?lang=ko"

# Content in a binder
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/binders/<BINDER_SLUG>/contents?lang=ko"

# Site list
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/sites?lang=ko"

# Content in a site
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/sites/<SITE_SLUG>/contents?lang=ko"

# Search
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/search?q=<KEYWORD>&lang=ko"

# Semantic search (vector meaning)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/search?q=<KEYWORD>&mode=semantic&lang=ko"

# Embedding vectors (Pro)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/contents/<CONTENT_ID>/embeddings?lang=ko"

# TTS audio metadata
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/contents/<CONTENT_ID>/audio?lang=ko"

# TTS audio mp3 (Pro)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/contents/<CONTENT_ID>/audio/ko"

# Dataset catalog
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/datasets"

# Text corpus (many records at once)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/datasets/corpus?lang=ko&per_page=100"

# Text corpus as JSONL (for training pipelines)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/datasets/corpus?lang=ko&format=jsonl"

# Incremental sync (only records changed since a timestamp)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/datasets/corpus?updated_since=2026-01-01T00:00:00Z&format=jsonl"

# Instruction dataset (FAQ to message pairs)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/datasets/qa?lang=ko&format=jsonl"

# Multilingual parallel corpus (reviewed only)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/datasets/parallel?langs=ko,en,ja&status=reviewed"

# Embedding vectors in bulk (Pro)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://injoys.com/api/v1/datasets/embeddings?lang=ko&per_page=20"

Optional: instead of headers you can use a query token (URL auth). Append the QUERY_KEY issued on the "My Content API" page to call without headers. It can be exposed in URLs/logs, so it is read-only, expiring and revocable - recommended only for non-sensitive convenience use.

https://injoys.com/api/v1/contents?query_key=<QUERY_KEY>&lang=ko

Only successful (2xx) responses count toward the monthly quota; remaining quota is reported in the X-Monthly-Quota-* response headers. The quota resets on the 1st of each month (KST).

Semantic search, embedding, audio and dataset requests use extra credits: semantic search (mode=semantic) 2x, raw embedding vectors 5x, TTS audio mp3 files 3x (metadata 1x). Datasets scale with the requested per_page (1 per 10 records for corpus and QA, 1 per 5 for parallel, 1 per 2 for embeddings). Raw vectors, audio mp3 files and the embeddings dataset are Pro-only, and each feature works only when the admin has enabled the corresponding API (embeddings/audio/datasets).

Use of the API is subject to: Terms · Refund Policy · Privacy