Inucomi Developers

APIドキュメント

Inucomiのデータをアプリケーションに統合する方法を学びましょう。

認証ティア2で必須

APIキーヘッダー
エンタープライズAPIへのすべてのリクエストには、X-API-KEYヘッダーにAPIキーを含めてください。

# リクエスト例

curl -H "X-API-KEY: inu_..." https://inucomi.jp/api/v1/posts

インタラクティブ・エクスプローラー (Swagger UI)新規

以下のインタラクティブ・エクスプローラーを使用して、APIエンドポイントを直接テストできます。

APIティア

ティア1: パブリック無料
個人開発者や試用ユーザー向けの公開読み取り専用データ。
  • 認証不要
  • 制限されたデータフィールド (BaseDTO)
  • 厳格なレート制限
  • エンドポイント: /api/v1/public/*
ティア2: エンタープライズ有料
パートナーおよび商用利用向けのフルデータアクセス。
  • ステータス: 稼働中
  • 有効なAPIキーが必要
  • 全データフィールド (EnterpriseDTO)
  • 利用量を記録（現在は月額定額、超過従量課金は準備中）
  • エンドポイント: /api/v1/*

データプロダクト（外販）

APIによるデータ提供を見越し、提供形態を3層で構造化しています。② AI学習用・③ 研究用は、パートナーシップ前提の「応相談」窓口です（個人を識別できる情報は提供しません。匿名加工した情報のみを対象に個別審査します）。

通常API稼働中
店舗情報・クチコミ（公開系）と集計統計（犬種×月・k≥10）を照会する開発者向けAPI。

¥55,000/月（税込）・自己申込み

エンドポイント: /api/v1/*

AI学習用データライセンス応相談
商用のAI学習・製品R&D向けに、匿名加工した個体レコードを提供するデータライセンス（応相談）。

応相談（カスタム年間契約）

お問い合わせ（応相談）
研究用データ提供応相談
非商用の学術・研究向けデータ提供（応相談）。権威ある学術・研究機関に限り低廉/無償。商用目的の研究はAI学習用ライセンスへご案内。

応相談（権威ある学術・研究機関のみ低廉/無償）

お問い合わせ（応相談）

エンドポイント

記事一覧の取得
ページネーションされた記事の一覧を取得します。

HTTPリクエスト

GET /api/v1/public/posts // パブリックGET /api/v1/posts // エンタープライズ

レスポンスの比較

パブリック (ティア1)

{
  "data": [
    {
      "id": "...",
      "title": "サンプル記事",
      "thumbnail_url": "..."
      // 本文は含まれません
    }
  ]
}

エンタープライズ (ティア2)

{
  "data": [
    {
      "id": "...",
      "title": "サンプル記事",
      "content_html": "<p>本文のHTML...</p>",
      "author": { ... },
      "tags": [...]
    }
  ]
}