eBayレビューAPI

EveryInfraのeBay レビューエンドポイント（ebay/reviews）を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにebay、actionにreviewsを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - seller: eBayの出品者アカウントのユーザー名を正確に指定します。ストアの表示名や会社名ではありません。storeクエリでは出品者の出品一覧の取得に、reviewsクエリではitem_idと組み合わせて購入者の評価の取得に使われます。
  - item_id: 出品者の出品に紐づく数値のeBay商品ID（通常は/itm/のURLから取り出します）で、reviewsクエリでsellerと組み合わせて使います。特定の出品を表すもので、汎用的なカタログ商品IDやレビューのIDではありません。
- 任意パラメータ：
  - country: domainの互換入力で、同じくebay.comのようなeBayサイトのドメインを受け付けます。USやDEのような国コードではありません。両方を指定した場合はdomainが優先されます。
  - domain: eBayサイトのドメインを、スキームやパスを付けずに指定します（例：ebay.com、ebay.de、ebay.co.uk）。デフォルトはebay.comで、search、store、reviewsのページの生成に使われます。
  - product_id: 数値のeBay商品IDを受け付けるitem_idの互換エイリアスです。reviewsアクションでは、引き続きitem_idが必須です。
  - q: reviewsアクションで数値のeBay商品IDを受け付けるitem_idの互換エイリアスです。自由テキストの検索クエリとしては使えません。商品検索にはkeywordを使ってください。
  - seller_name: eBayの出品者アカウントのユーザー名です。
  - url: URLの自動生成の代わりに、storeアクションではeBayのストア・出品者の出品一覧ページ、reviewsアクションでは/fdbk/の評価ページを直接指定します。URLを指定しても、sellerやitem_idパラメータが必須であることに変わりはありません。
  - username: storeおよびreviewsアクションにおける、出品者アカウントのユーザー名sellerの互換エイリアスです。sellerパラメータが優先され、引き続き必須です。このフィールドは購入者やレビュー投稿者のハンドルを表すものではありません。
  - limit: この呼び出しで返す最大行数で、1〜100の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。（デフォルト：20）
- レコードのリストを返します。各レコードの主なフィールド: text、rating、rating_scale、username、submitted_at、seller_reply、image_count、reviewer_feedback_score、reviewer_feedback_star、product_name、product_id（eBayカタログの商品ID（product_detail））、product_price。フィールドは全部で14個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=ebayを参照してください。.
- リクエストボディの例：
{
  "platform": "ebay",
  "action": "reviews",
  "params": {
    "seller": "musicmagpie",
    "item_id": "388071794887"
  }
}
- 料金：1,000リクエストあたり$1.39。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。