メインコンテンツへスキップ
デフォルトでは、1ページあたり返されるクエリ結果は20件のみで、この結果の順序は保証されておらず変更される可能性があります。ページネーションと並べ替えにより、さらに多くの結果を取得し、結果の順序を定義することが可能になります。

ページネーション

APIはデフォルトで、20件の結果を含む最初のページのみを返します。ページあたりの結果の数を増やすようリクエストするには、リクエストにlimitクエリパラメータを指定して送信します。
limitの最大値は100です。返される結果ページ数を増やすには、各ページでnext_marker値を返します。
このnext_markerを使用すると、結果の次のページについて新しいリクエストを作成できます。
レスポンスに次のマーカーが含まれていない場合は、これ以上一致する結果がないことを意味します。
next_markerを使用するには、結果の次のページにまったく同じクエリを使用することが重要です。queryquery_paramsなどのパラメーターが変更されると、APIはエラーを返します。

並べ替え

結果は、サポートされているどのメタデータフィールドタイプを使用しても並べ替えることができます。現在サポートされているタイプは、floatdateおよびstringのみです。enumまたはmultiSelect値による並べ替えは現在サポートされていません。 結果を並べ替えるには、並べ替えの基準として使用する1つ以上のフィールドキーに加えて、方向を指定します。
並べ替えの方向は、指定したすべてのキーで同じにする必要があります。つまり、各field_keydirectionは同じにする必要があります。
最終更新日 2026年7月1日