API Naver
Получение публикаций из блогов Naver, статей в сообществах, комментариев и отзывов о заведениях по ссылкам на их страницы для исследования корейского контента и магазинов.
Передайте URL публикации или ссылку на страницу заведения. Поисковые ключевые слова к отзывам о заведениях не применяются.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Naver: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите посты в Naver Blog и Cafe по ключевому слову: только в блогах, только в Cafe или и там, и там. | $1.39 за 1 000 запросов | Норма |
Сведения о постеpost | Получите пост из Naver Blog в формате JSON по его url: полный текст, автора, категорию, теги, ссылки на изображения и упомянутые места. | $1.39 за 1 000 запросов | Норма |
Комментарииcomments | Получите комментарии к посту в Naver Blog или Cafe по его url: имя комментатора, текст, время и флаг is_reply для ответов. | $20.79 за 1 000 запросов | Норма |
Отзывыreviews | Получите отзывы посетителей о ресторане или заведении в Naver Place: оценку, текст, дату визита, число визитов автора отзыва, упомянутое блюдо или товар и ответ владельца, если он есть. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Naver?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите посты в Naver Blog и Cafe по ключевому слову: только в блогах, только в Cafe или и там, и там. Вы получите автора, название Cafe, категорию, показатели вовлечённости и флаг спонсорского материала. В выдаче Naver много продвигаемых постов. Чтобы отфильтровать их, используйте | keyword | content_type, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=20. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | source · title · url · text · author_name · author_url · cafe_name · category · like_count · comment_count · posted_at · has_video · is_sponsored · platform · tags · image_urls · mentioned_places |
postСведения о посте Получите пост из Naver Blog в формате JSON по его | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | source · title · url · text · author_name · author_url · cafe_name · category · like_count · comment_count · posted_at · has_video · is_sponsored · platform · tags · image_urls · mentioned_places |
commentsКомментарии Получите комментарии к посту в Naver Blog или Cafe по его | url | — | Режим выдачи: Sync | — | $20.79 за 1 000 запросов | author_name · text · posted_at · is_reply · platform · post_url |
reviewsОтзывы Получите отзывы посетителей о ресторане или заведении в Naver Place: оценку, текст, дату визита, число визитов автора отзыва, упомянутое блюдо или товар и ответ владельца, если он есть. | url | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=50, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · place_id · place_name · text · rating · rating_scale · visited_at · posted_at · visit_count · view_count · item_name · origin_type · language · owner_reply · author_id · author_name · author_review_count · place_total_reviews · place_average_rating · platform |
Что означают параметры действия search в API Naver?
Ищите посты в Naver Blog и Cafe по ключевому слову: только в блогах, только в Cafe или и там, и там. Вы получите автора, название Cafe, категорию, показатели вовлечённости и флаг спонсорского материала. В выдаче Naver много продвигаемых постов. Чтобы отфильтровать их, используйте is_sponsored.
Что означают параметры действия post в API Naver?
Получите пост из Naver Blog в формате JSON по его url: полный текст, автора, категорию, теги, ссылки на изображения и упомянутые места. Посты из Cafe тоже поддерживаются. Возвращается только то, что видно на странице поста. Закрытый контент получить нельзя.
Что означают параметры действия comments в API Naver?
Получите комментарии к посту в Naver Blog или Cafe по его url: имя комментатора, текст, время и флаг is_reply для ответов. Ничего не публикуется, полная иерархия ответов не гарантируется.
Что означают параметры действия reviews в API Naver?
Получите отзывы посетителей о ресторане или заведении в Naver Place: оценку, текст, дату визита, число визитов автора отзыва, упомянутое блюдо или товар и ответ владельца, если он есть. url должен быть ссылкой Naver Place с /restaurant/ или /place/ и ID заведения. Дата визита хранится отдельно от даты публикации.
Как использовать API Naver
- 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":"naver","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Naver
Какие данные можно получить через API Naver?
Укажите в platform значение naver. В текущем каталоге: поиск, сведения о посте, комментарии и отзывы. Эти названия действий соответствуют разным объектам или представлениям Naver; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Naver?
Ключевые слова на корейском или других языках для поиска по контенту Naver Blog и Naver Cafe в действии search. Полнотекстовый поиск по отзывам о заведениях на карте в действии reviews не выполняется. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Naver?
Объявленная схема включает source, title, text и author_name. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Naver возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.