コンテンツAPI

編集チームとAIが共に制作し検証手順を経たコンテンツを JSON、Markdown、TXT、HTML、JSON-LD 形式と多言語で提供する API です。同じキーでセマンティック検索とコンテンツ音声(TTS)メタ、さらにモデル学習·RAG インデックス用データセット(本文コーパス·instruction·多言語パラレル)まで利用でき、埋め込みベクトル原本と音声 mp3 は Pro プランで提供します。無料キーを発行してすぐに始められます。

料金プラン

APIテスト

使い方

発行されたキーを Authorization ヘッダーに入れて呼び出します。以下はエンドポイント・パラメータ・応答フォーマットと例です。

エンドポイント

データセット (学習·RAG)

モデル学習·ファインチューニング·RAGインデックスのように複数件を一度に取得する用途のために、コンテンツを学習用スキーマへ正規化して提供します。一覧·単件APIと同じくpage·per_page·category·tag·updated_sinceに対応し、format=jsonlで受け取れば学習パイプラインへそのまま投入できます。

per_page上限はFreeプランが10件、Proプランは種別ごとに最大100件です(埋め込みは20件)。クレジットはリクエストしたper_page基準で計算されるため、同じ分量を単件取得で繰り返すより少なく済みます。

データセットAPIは無料データ提供を置き換えるものではありません。コンテンツを1件ずつTXT·Markdown·JSON·JSON-LDで取得する認証不要の経路は、これまでどおり無料で提供され続けます。 無料データ利用のご案内

提供言語

• 1ティア - 翻訳の検証を終えた言語です。人が読むWebページ・検索露出(sitemap・hreflang)・AI音声(TTS)・埋め込みまですべて提供されます。
• 2ティア - 機械翻訳のデータ専用言語です。データファイルとAPIでのみ提供され、Webページ・検索露出・音声(TTS)・埋め込みは提供されません。検収前であることを示す translation_status: machine ラベルが常に併記されます。

APIのlangパラメータには上記の設定値をそのまま入れます。コンテンツ単件・データセットは2ティア言語も受け付けますが、音声(TTS)・埋め込みのエンドポイントは1ティア言語のみ応答します。

クエリパラメータ

対応フォーマット (単一取得の format)

例

認証には Authorization: Bearer ヘッダーまたは X-Api-Key ヘッダーを使用します。

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

# カテゴリで絞り込み
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents?lang=ko&category=<CATEGORY_SLUG>"

# タグで絞り込み
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents?lang=ko&tag=<TAG_SLUG>"

# 増分同期 (指定時刻以降の更新分)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents?updated_since=2026-01-01T00:00:00Z"

# 特定のサービスのみ (任意 - 省略で全体)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents?lang=ko&service=<SERVICE>"

# 単一取得 (HTML フォーマット)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents/<CONTENT_ID>?lang=ko&format=html"

# slug で単一取得 (Markdown フォーマット)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents/by-slug/<SLUG>?lang=ko&format=md"

# 画像メタデータ
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents/<CONTENT_ID>/images"

# カテゴリ一覧
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/categories?lang=ko"

# タグ一覧
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/tags?lang=ko"

# バインダー一覧
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/binders?lang=ko"

# バインダー所属コンテンツ
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/binders/<BINDER_SLUG>/contents?lang=ko"

# サイト一覧
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/sites?lang=ko"

# サイト所属コンテンツ
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/sites/<SITE_SLUG>/contents?lang=ko"

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

# セマンティック検索 (ベクトル意味検索)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/search?q=<KEYWORD>&mode=semantic&lang=ko"

# 埋め込みベクトル原本 (Pro)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents/<CONTENT_ID>/embeddings?lang=ko"

# TTS音声メタ
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/contents/<CONTENT_ID>/audio?lang=ko"

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

# データセットカタログ
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets"

# 本文コーパス (一度に複数件)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/corpus?lang=ko&per_page=100"

# 本文コーパス JSONL (学習パイプライン用)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/corpus?lang=ko&format=jsonl"

# 差分同期 (指定時刻以降の更新分のみ)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/corpus?updated_since=2026-01-01T00:00:00Z&format=jsonl"

# instructionデータセット (FAQ → messagesペア)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/qa?lang=ko&format=jsonl"

# 多言語パラレルコーパス (検収本のみ)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/parallel?langs=ko,en,ja&status=reviewed"

# 埋め込みベクトルのバルク (Pro)
curl -H "Authorization: Bearer <API_KEY>" \
  "https://onbinder.com/api/v1/datasets/embeddings?lang=ko&per_page=20"

任意: ヘッダーの代わりにクエリトークン(URL認証)を使えます。「マイコンテンツAPI」ページで発行した QUERY_KEY を付けてヘッダーなしで呼び出します。URL・ログに露出しうるため読み取り専用・失効・無効化可能で、機密でない手軽な用途にのみ推奨します。

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

月間クォータには成功(2xx)応答のみが算入され、残量は X-Monthly-Quota-* 応答ヘッダーで確認できます。クォータは毎月1日(KST)にリセットされます。

セマンティック検索・埋め込み・オーディオ・データセットのリクエストは追加クレジットを使用します: セマンティック検索(mode=semantic)2倍、埋め込みベクトル原本5倍、TTS音声mp3ファイル3倍(メタは1倍)。データセットはリクエストしたper_pageに比例します(コーパス·QAは10件あたり1、パラレルは5件あたり1、埋め込みは2件あたり1)。ベクトル原本·音声mp3ファイル·埋め込みデータセットはProプラン専用で、各機能は管理者が該当API(埋め込み/オーディオ/データセット)を有効化した場合のみ動作します。

APIの利用には次のポリシーが適用されます: 利用規約 · 返金ポリシー · プライバシー