API DuckDuckGo
DuckDuckGo — поисковая система с упором на конфиденциальность. search возвращает до 50 органических результатов по запросу с заголовком, ссылкой, отображаемым URL, сниппетом и иконкой сайта.
Фильтруйте по региону с помощью country и language, а по давности — с помощью time_window (day, week, month или year). Принимаются только обычные поисковые слова: кавычки для точной фразы и операторы вроде site: отклоняются до списания средств.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия DuckDuckGo: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите в DuckDuckGo по keyword и получайте до 50 результатов с позицией, заголовком, ссылкой, отображаемым URL, сниппетом и иконкой сайта. | $0.56 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API DuckDuckGo?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите в DuckDuckGo по | keyword | country, language, page, time_window | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | rank · title · url · displayed_url · text · favicon_url · platform |
Что означают параметры действия search в API DuckDuckGo?
Ищите в DuckDuckGo по keyword и получайте до 50 результатов с позицией, заголовком, ссылкой, отображаемым URL, сниппетом и иконкой сайта. Фильтруйте по региону, языку и давности (день, неделя, месяц или год). Только простые поисковые слова: фразы в кавычках и site: отклоняются до списания средств.
keywordОбязательный- Поисковые слова DuckDuckGo, до 500 символов. Кавычки для точной фразы и операторы вроде site: отклоняются до списания средств.
countryНеобязательный- Двухбуквенный код страны, например
us,gb,deилиjp, задающий регион поиска DuckDuckGo. Чтобы искать по всем регионам, не указывайте параметр или укажите страну, для которой у DuckDuckGo нет региона.Справка DuckDuckGo: как задать регион поиска параметрами URL — На странице справки DuckDuckGo сказано, что регион поиска задаётся параметром kl в формате «регион-язык» (например, us-en или de-de) наряду с такими настройками, как безопасный поиск. Источник подтверждает только, что DuckDuckGo разделяет результаты по регионам; `country` и `language` этого API определены EveryInfra и объединяются в эту настройку региона: двухбуквенный код страны преобразуется в региональный токен DuckDuckGo (gb становится uk-en), а для страны, которой нет в списке регионов, поиск выполняется по всем регионам. О количестве результатов и фильтрах по дате источник ничего не говорит. · Проверено languageНеобязательный- Двухбуквенный код языка, выбирающий языковую версию региона, у которого их несколько, например
enилиfrдля Канады; в остальных случаях не действует. pageНеобязательный- Номер страницы результатов, начиная с 1; на странице
limitрезультатов (не более 20 страниц). time_windowНеобязательный- Возвращать только страницы за недавний период:
day,week,monthилиyear. Без параметра ограничения по дате нет.
Как использовать API DuckDuckGo
- 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>"}}'
Вопросы об API DuckDuckGo
Какие данные можно получить через API DuckDuckGo?
Укажите в platform значение duckduckgo. В текущем каталоге: поиск. Эти названия действий соответствуют разным объектам или представлениям DuckDuckGo; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе DuckDuckGo?
Поисковые слова DuckDuckGo, до 500 символов. Кавычки для точной фразы и операторы вроде site: отклоняются до списания средств. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе DuckDuckGo?
Объявленная схема включает rank, title, displayed_url и text. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия DuckDuckGo возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.