プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
DuckDuckGoの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordでDuckDuckGoを検索し、順位、タイトル、リンク、表示URL、スニペット、サイトアイコンを含む結果を最大50件取得します。地域、言語、期間（1日、1週間、1か月、1年）で絞り込めます。指定できるのは通常の検索語のみです。引用符で囲んだフレーズやsite:は課金前に拒否されます。 | 1,000リクエストあたり$0.56 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
DuckDuckGoの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | country, language, page, time_window | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | rank · title · url · displayed_url · text · favicon_url · platform |
DuckDuckGoのsearchのパラメータはそれぞれどういう意味ですか？
keywordでDuckDuckGoを検索し、順位、タイトル、リンク、表示URL、スニペット、サイトアイコンを含む結果を最大50件取得します。地域、言語、期間（1日、1週間、1か月、1年）で絞り込めます。指定できるのは通常の検索語のみです。引用符で囲んだフレーズやsite:は課金前に拒否されます。
keyword必須- DuckDuckGoの検索語（500文字以内）です。完全一致フレーズ用の引用符や site: などの演算子を含む場合は、課金前に拒否されます。
country任意- DuckDuckGoの検索地域を指定する2文字の国コードです（例：
us、gb、de、jp）。省略するか、DuckDuckGoに対応する地域がない国を指定すると、すべての地域を検索します。DuckDuckGoヘルプ：URLパラメータによる検索地域の設定 — DuckDuckGoのヘルプページによると、検索地域はセーフサーチなどの設定と並んでklパラメータで設定し、「地域-言語」の形式（us-enやde-deなど）で指定します。この資料で確認できるのは、DuckDuckGoが地域ごとに結果を分けていることのみです。このAPIの`country`と`language`はEveryInfraが定義したもので、組み合わせてこの地域設定に変換されます。2文字の国コードはDuckDuckGoの地域トークンに変換され（gbはuk-enになります）、地域リストにない国の場合はすべての地域が検索対象になります。結果の件数や日付フィルターについては、この資料には記載されていません。 · 確認日 language任意- 複数の言語版がある地域で、言語版を選ぶための2文字の言語コードです（例：カナダの場合は
enまたはfr）。それ以外の地域では効果はありません。 page任意- 返す結果のページ番号です。1から始まり、1ページあたり
limit件の結果が含まれます（最大20ページ）。 time_window任意- 直近の一定期間のページのみを返します。
day、week、month、yearのいずれかを指定します。省略すると期間の制限はありません。
DuckDuckGo 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":"duckduckgo","action":"search","params":{"keyword":"<keyword>"}}'
DuckDuckGo APIに関する質問
DuckDuckGo APIでは何を取得できますか？
platformをduckduckgoに設定します。現在のカタログには検索が掲載されています。これらのアクション名はそれぞれ異なるDuckDuckGoのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
DuckDuckGoのsearchリクエストを開始するには、どの入力を使用しますか？
DuckDuckGoの検索語（500文字以内）です。完全一致フレーズ用の引用符や site: などの演算子を含む場合は、課金前に拒否されます。params内のkeywordとして送信してください。
DuckDuckGoのsearchはどのフィールドを返しますか？
宣言されたスキーマにはrank、title、displayed_url、textが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
DuckDuckGoのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。