製品について、過去に何が語られたか

BuyItForLifeのbackpackに関する過去の記録を検索。取得した文章を自分たちで読み、分類し、調査の偏りや限界とともに報告するためのAPIです。

リクエスト例

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditlistening.com/v1/search?q=backpack&subreddit=BuyItForLife&limit=3"

調査の問いを小さく具体的にする

Reddit Listeningは、ブランドや市場の調査担当者が過去のRedditの記録を取得するための独立したアーカイブAPIです。Redditの公式サービスでも提携サービスでもなく、リアルタイムの会話を監視するものではありません。「消費者全体がどう思うか」ではなく、「取得できた文章では耐久性がどのような経験として語られているか」という問いから始められます。

最初の例はGET https://api.redditlistening.com/v1/search?q=backpack&subreddit=BuyItForLife&limit=3です。q=backpackで文章を検索し、subreddit=BuyItForLifeでコミュニティを指定し、limit=3で最大3件を求めます。3件見つかる保証はありません。小さな結果を読んで調査条件を検討する例であり、無作為抽出やコミュニティ全体の要約ではありません。

縫い目、ファスナー、背負い心地、使用年数など、実際の記述に沿って自分たちの分類を作れます。本人の経験、購入前の質問、他人の評価の引用は区別しましょう。こうした分類や集計は取得後のローカルな作業です。APIが感情スコア、通知、市場シェア、調査レポートを生成するわけではありません。

取得できた文章と、見えていない範囲

レスポンスはフラットなレコードです。parent_idやlink_idがあれば手元のデータを関連付けられますが、欠けている親投稿や返信が補われるわけではありません。褒め言葉と不満が同じ文章にある場合は、それぞれの理由を残してください。短いコメントだけでは判断できない点も、無理に結論へ変えず調査メモに記録します。

結果はアーカイブの_doc順で、時系列、関連度、スコアの順ではありません。min_scoreは絞り込み専用です。1リクエストは最大100件、1クエリは最大100ページまでで、ページ巡回や日付分割によって全件取得が保証されることもありません。アーカイブの網羅性、永続性、同じクエリが将来も同じ結果になることは保証されません。

BuyItForLifeには耐久性への関心というコミュニティ固有の特徴があります。英語のbackpackだけでは別の呼び方や言語の経験を拾えず、発言者も購入者全体を代表するとは限りません。取得した文章内の傾向を、世論、売上、代表性のある標本の結果として扱わないでください。検索条件と見えていない範囲を結果と一緒に示すことが大切です。

アクセスと費用を確認する

メールアドレスとパスワードで登録すると、支払い前にAPIキーが一度だけ表示されます。取得にはAuthorization: Bearer <key>またはX-API-Key: <key>を使えます。キーと残高はredditlistening.com専用です。キーを公開コードに含めず、利用アプリのサーバー側で管理してください。100クレジットの試用枠はネットワーク全体の不正利用防止条件によって付与される場合があります。

空の結果を含め、成功した取得1回につき1クレジットです。成功した取得リクエスト1,000回が$1、最低$50のチャージが50,000有料クレジットに相当します。購入分に有効期限はなく、サブスクリプションもありません。フィルターはドキュメント、費用は料金、登録と請求書はAPIキーのページで確認できます。