プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Etsyの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | Etsyの出品をkeywordで検索します。各商品の価格、定価、通貨、評価、販売元のショップを取得できます。任意のフィルターとして、通貨、タイトルの除外語、最低価格、並べ替えを指定できます。出品データは、ハンドメイドでの製作、在庫、配送を保証するものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
商品詳細profile | 出品のurlからEtsyの商品1件のレコード全体を取得します。説明、素材、価格帯、バリエーション、レビューのハイライト、販売元のショップが含まれます。アクション名とは異なり、profileが対象とするのは商品であり、購入者アカウントやショップページ全体ではありません。 | 1,000リクエストあたり$1.39 | 正常 |
レビューreviews | Etsyストアのショップ単位のレビューを取得します。shopにショップの短縮名またはショップURLを指定します。評価、投稿者、関連する出品タイトル、出品者の返信を取得できます。レビューは個別の出品ではなくショップ全体に対するものです。取得したレビューがすべての販売を網羅するわけではありません。 | 1,000リクエストあたり$1.39 | 正常 |
ショップshop | shopに名前またはURLを指定してEtsyショップを検索し、ID、所在地、開店日、公開中の出品数、Star Sellerバッジを取得します。is_star_sellerは確認時点のバッジの有無を示すもので、今後のサービス品質を約束するものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
商品詳細product_detail | 出品のurlからEtsyの商品1件を取得します。説明、現在価格と元の価格、表示されている在庫数、評価、バリエーション、タグが含まれます。in_stock_quantityはページに表示された数であり、監査済みの在庫数ではありません。この操作で商品が取り置きされることはありません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Etsyの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 Etsyの出品を | keyword | currency, exclude_keywords, min_price, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | listing_id · title · url · price · list_price · currency · rating · rating_scale · shop_id · shop_name · shop_rating · shop_review_count · on_sale · free_shipping · is_digital · image_url · platform |
profile商品詳細 出品の | url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | listing_id · title · url · description · materials · category · price · price_min · price_max · currency · review_count · shop_id · shop_name · shop_review_count · shop_years · ships_from_country · image_url · platform · images · review_highlights · review_tags · variants |
reviewsレビュー Etsyストアのショップ単位のレビューを取得します。 | shop | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | review_id · text · rating · rating_scale · author_name · author_username · posted_at · listing_title · seller_response · product_url · shop_name · shop_url · shop_rating · shop_review_count · platform |
shopショップ
| shop | shop_name, username | Sync配信 | — | 1,000リクエストあたり$1.39 | shop_id · shop_name · shop_url · is_star_seller · active_listing_count · on_etsy_since · location · platform |
product_detail商品詳細 出品の | url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · name · text · price · original_price · currency · in_stock_quantity · rating · rating_scale · review_count · shop_id · variants · tags · image_url · platform |
Etsyのsearchのパラメータはそれぞれどういう意味ですか？
Etsyの出品をkeywordで検索します。各商品の価格、定価、通貨、評価、販売元のショップを取得できます。任意のフィルターとして、通貨、タイトルの除外語、最低価格、並べ替えを指定できます。出品データは、ハンドメイドでの製作、在庫、配送を保証するものではありません。
keyword必須- Etsyの商品検索で、商品タイトルや出品を検索するための検索クエリ文字列を指定します（例：ceramic mug）。ショップを完全一致で検索するものではありません。ショップのプロフィールやレビューを取得するにはshopを使ってください。
currency任意- 検索結果に表示される出品価格の通貨を、対応している小文字の通貨コードで設定します。デフォルトはusdです。min_priceパラメータはこの通貨で解釈されます。この設定はレスポンスの表示値にのみ影響し、プラットフォームAPIの課金通貨は変更しません。指定可能な値:
audbrlcadchfdkkeurgbphkdinrjpymxnnoknzdseksgdusd exclude_keywords任意- この配列で指定したいずれかの文字列をタイトルに含む商品を除外します（例：["digital", "download"]）。大文字と小文字は区別しません。このフィルターは商品タイトルのみを対象とし、特定の出品者は除外しません。また、商品説明全体がチェックされるとは限りません。
min_price任意- Etsyの商品検索結果を最低出品価格で絞り込みます。指定した通貨での0以上の数値を指定します。最小注文数量、送料の上限、リクエストの予算上限を表すものではありません。
sort任意- Etsyのsearchアクションにおける商品検索結果の並び順を指定します。指定できる値はrelevance（デフォルト）、price_asc、price_desc、newestです。旧来の互換エイリアスであるmost_relevant、lowest_price、highest_price、recently_listedも使えます。このパラメータでショップレビューは並べ替えられません。指定可能な値:
newestprice_ascprice_descrelevance
Etsyのprofileのパラメータはそれぞれどういう意味ですか？
出品のurlからEtsyの商品1件のレコード全体を取得します。説明、素材、価格帯、バリエーション、レビューのハイライト、販売元のショップが含まれます。アクション名とは異なり、profileが対象とするのは商品であり、購入者アカウントやショップページ全体ではありません。
url必須- profileおよびproduct_detailアクションで単一商品の詳細を取得するには、/listing/<ID>/形式の完全なEtsy出品URLを指定します。profileはユーザープロフィールではなく商品の詳細を対象とする点に注意してください。ショップのエンドポイントを照会する場合、必須のshopパラメータの代わりにはなりません。
Etsyのreviewsのパラメータはそれぞれどういう意味ですか？
Etsyストアのショップ単位のレビューを取得します。shopにショップの短縮名またはショップURLを指定します。評価、投稿者、関連する出品タイトル、出品者の返信を取得できます。レビューは個別の出品ではなくショップ全体に対するものです。取得したレビューがすべての販売を網羅するわけではありません。
shop必須- ショップを、ショートネームまたはhttps://www.etsy.com/shop/<shop_name>のような完全なURLで指定します。reviewsアクションでは個々の出品のレビューではなくショップ単位のレビューを返し、shopアクションではショップの基本的なメタデータを取得します。Etsy：ショップリンクの形式 — Etsyの公式ドキュメントによると、ショップリンクにはショップのショートネームが含まれます（例：www.etsy.com/shop/shopname）。このパラメータの指定どおりにショップのショートネームまたは/shop/リンクを使用し、ショップリンクの代わりに商品ページのリンクを使わないでください。 · 確認日
Etsyのshopのパラメータはそれぞれどういう意味ですか？
shopに名前またはURLを指定してEtsyショップを検索し、ID、所在地、開店日、公開中の出品数、Star Sellerバッジを取得します。is_star_sellerは確認時点のバッジの有無を示すもので、今後のサービス品質を約束するものではありません。
shop必須- ショップを、ショートネームまたはhttps://www.etsy.com/shop/<shop_name>のような完全なURLで指定します。reviewsアクションでは個々の出品のレビューではなくショップ単位のレビューを返し、shopアクションではショップの基本的なメタデータを取得します。Etsy：ショップリンクの形式 — Etsyの公式ドキュメントによると、ショップリンクにはショップのショートネームが含まれます（例：www.etsy.com/shop/shopname）。このパラメータの指定どおりにショップのショートネームまたは/shop/リンクを使用し、ショップリンクの代わりに商品ページのリンクを使わないでください。 · 確認日
shop_name任意- Etsyショップのショートネームを表す互換入力です。reviewsまたはshopアクションを呼び出す際は、引き続き必須のメインパラメータであるshopを含める必要があります。
username任意- ショップのショートネームを指定する代替の互換入力で、優先度はshopおよびshop_nameより低くなります。購入者のユーザー名を表すものではなく、必須のshopパラメータも引き続き指定する必要があります。
Etsyのproduct_detailのパラメータはそれぞれどういう意味ですか？
出品のurlからEtsyの商品1件を取得します。説明、現在価格と元の価格、表示されている在庫数、評価、バリエーション、タグが含まれます。in_stock_quantityはページに表示された数であり、監査済みの在庫数ではありません。この操作で商品が取り置きされることはありません。
url必須- profileおよびproduct_detailアクションで単一商品の詳細を取得するには、/listing/<ID>/形式の完全なEtsy出品URLを指定します。profileはユーザープロフィールではなく商品の詳細を対象とする点に注意してください。ショップのエンドポイントを照会する場合、必須のshopパラメータの代わりにはなりません。
Etsy APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"etsy","action":"search","params":{"keyword":"<keyword>"}}'
Etsy APIに関する質問
Etsy APIでは何を取得できますか？
platformをetsyに設定します。現在のカタログには検索、商品詳細、レビュー、ショップ、商品詳細が掲載されています。これらのアクション名はそれぞれ異なるEtsyのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Etsyのsearchリクエストを開始するには、どの入力を使用しますか？
Etsyの商品検索で、商品タイトルや出品を検索するための検索クエリ文字列を指定します（例：ceramic mug）。ショップを完全一致で検索するものではありません。ショップのプロフィールやレビューを取得するにはshopを使ってください。params内のkeywordとして送信してください。
Etsyのsearchはどのフィールドを返しますか？
宣言されたスキーマにはlisting_id、title、price、list_priceが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Etsyのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。