API連携機能で特定の範囲（1〜200件、201件〜など）のデータを取得するためのlimitとoffsetの設定方法

APIリクエスト時のパラメータ「limit」に取得件数を、「offset」に取得開始位置を指定することで実行可能です。

「楽楽販売」のAPI連携機能（レコード参照APIなど）を利用して大量のデータを取得する際、一度に取得できる件数には上限（最大200件）があります。そのため、全データを取得するには「limit（取得件数）」と「offset（取得開始位置）」という2つのパラメータを組み合わせて、データを分割してリクエストする必要があります。

【設定箇所】 外部システムからのAPIリクエストパラメータ（レコード参照APIなど）

設定手順と具体的な値の指定例

取得したいデータの範囲に合わせて、以下のルールで値をセットしてリクエストを実行してください。

◆1. 1件目から200件のデータを取得する場合

最初のデータから上限いっぱいの200件を取得する設定です。
limit（取得件数）： 200
offset（取得開始件数）： 1

◆2. 201件目からさらに200件のデータを取得する場合

201件目を起点として、次のブロックの200件を取得する設定です。
limit（取得件数）： 200
offset（取得開始件数）： 201

※limitに指定できる最大件数は200です。201以上の数値を指定しても、一度に取得できるのは200件までとなります。
※offsetは「何件目から取得を開始するか」を指します。2回目以降のリクエストでは、「前回取得した最後の件数 + 1」の数値を指定してください。

関連マニュアル

詳細な仕様やAPIの仕様書については、下記記事をご確認ください。

API連携オプションの基本的な設定方法

連携設定の全体像について解説しています。
API連携オプション：設定方法

APIリクエストの上限値に関する仕様

1分間あたりのリクエスト回数制限など、プランごとの上限値について詳しく記載されています。
API連携オプション：リクエスト上限の回避方法

（記事ID：2661）