開発者はAPIを何に利用できますか？

APIを使うと、Inoreaderで行っている操作を自分のコードで実行できます。フィード、フォルダー、タグの一覧取得、任意のフィード、フォルダー、タグ、状態の記事の読み取り、未読数の取得、記事の既読化、タグ付けやスター付け、フィードの追加や編集、タグの名前変更や削除、監視フィードの作成が可能です。典型的な用途としては、リーダーアプリがないプラットフォーム向けのリーダーアプリ、タグを付けた記事を公開するスクリプト、フォルダーからデータを取り込むダッシュボードなどがあります。

アカウントを読み取る

ストリームの内容は、ストリームの記事を返します。ストリームには、単一のフィード、フォルダーやタグ、または既読、スター付き、配信済み、注釈付き、いいね済み、保存済みウェブページなどの状態があります。返される項目数はデフォルトで20件、最大100件まで選択でき、古い順か新しい順か、開始時刻、既読記事を除外するかどうかも選択できます。継続トークンを使うと、残りのページを順に取得できます。各記事には、ID、タイトル、日付、URL、HTMLコンテンツ、著者、配信元フィード、カテゴリーが含まれ、リクエストに応じて自分の注釈やIntelligenceの要約も、JSONまたはAtom形式で含まれます。項目IDはIDのみを、未読数はカウンターを返し、フィード一覧、フォルダー／タグ一覧、ユーザー情報はアカウントの情報を示します。

アカウントを変更する

タグの編集は記事を既読にしたり、スターやタグを付けたりし、すべて既読にするはストリーム全体を既読にします。フィードの追加とフィードの編集はフィードを購読したり変更したりし、タグの名前変更とタグの削除はタグを管理し、ストリーム設定の変更はストリームの設定を変更します。監視フィードも、プランの上限内で作成および削除できます。

アクセスの仕組み

リクエストは https://www.inoreader.com/reader/api/0 に送信され、読み取りにはGET、変更にはPOSTを使用します。ユーザーはOAuth 2.0でサインインし、スコープにはゾーン1のみを対象とするread、またはread writeを指定します。読み取りはゾーン1、変更はゾーン2の使用量としてカウントされ、Proアプリケーションではそれぞれ1日100リクエストまで利用できます。InoreaderはAPIアクセスを提供していますか？で登録について説明しており、開発者ポータルにはすべてのメソッドのドキュメントがあります。

代替手段

Zapier、IFTTT、n8nとの連携はこのAPIを基盤としており、フィード出力を使うと、コードなしでフォルダーやタグをRSSまたはJSONとして公開できます。APIを基盤とするサードパーティ製リーダーアプリは、サポート > モバイルアプリ > サードパーティ製アプリに一覧表示されています。

APIアクセスはProプランとTeamプランに含まれていますが、Freeアカウントでは、Inoreaderのアプリがないプラットフォーム上の公開アプリに限って利用できます。