플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Naver 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Naver 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드로 네이버 블로그와 카페 게시물을 검색하며, 블로그, 카페 또는 둘 다로 범위를 지정할 수 있습니다. 작성자, 카페 이름, 카테고리, 반응 수, 광고 여부 플래그를 받을 수 있습니다. 네이버 검색 결과에는 홍보성 게시물이 많으므로 | keyword | content_type, sort | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=20. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | 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게시물 상세 정보
| url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | 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댓글
| url | — | Sync 응답 | — | 요청 1,000개당 $20.79 | author_name · text · posted_at · is_reply · platform · post_url |
reviews리뷰 네이버 플레이스 음식점이나 업체의 방문자 리뷰를 가져옵니다. 평점, 리뷰 내용, 방문일, 리뷰어의 방문 횟수, 언급된 메뉴나 상품, 사장님 답글을 받을 수 있습니다. | url | — | Sync 응답 | 카탈로그 값: defaultLimit=50, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | 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 |
Naver search 파라미터는 각각 무엇을 의미하나요?
키워드로 네이버 블로그와 카페 게시물을 검색하며, 블로그, 카페 또는 둘 다로 범위를 지정할 수 있습니다. 작성자, 카페 이름, 카테고리, 반응 수, 광고 여부 플래그를 받을 수 있습니다. 네이버 검색 결과에는 홍보성 게시물이 많으므로 is_sponsored로 걸러 내세요.
Naver post 파라미터는 각각 무엇을 의미하나요?
url로 네이버 블로그 게시물을 JSON으로 가져옵니다. 본문 전체, 작성자, 카테고리, 태그, 이미지 링크, 언급된 장소를 받을 수 있습니다. 카페 게시물도 지원합니다. 게시물 페이지에 표시되는 내용만 반환되며, 비공개 콘텐츠는 가져올 수 없습니다.
Naver comments 파라미터는 각각 무엇을 의미하나요?
url로 네이버 블로그 또는 카페 게시물의 댓글을 가져옵니다. 각 댓글 작성자의 이름, 내용, 작성 시각과 답글 여부를 나타내는 is_reply 플래그가 포함됩니다. 댓글을 게시하지는 않으며, 전체 답글 계층 구조는 보장되지 않습니다.
Naver reviews 파라미터는 각각 무엇을 의미하나요?
네이버 플레이스 음식점이나 업체의 방문자 리뷰를 가져옵니다. 평점, 리뷰 내용, 방문일, 리뷰어의 방문 횟수, 언급된 메뉴나 상품, 사장님 답글을 받을 수 있습니다. url은 /restaurant/ 또는 /place/와 업체 ID가 포함된 네이버 플레이스 링크여야 합니다. 방문일은 작성일과 별도로 제공됩니다.
Naver 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":"naver","action":"search","params":{"keyword":"<keyword>"}}'
Naver API 자주 묻는 질문
Naver API로 무엇을 가져올 수 있나요?
platform을 naver 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 게시물 상세 정보, 댓글 및 리뷰입니다. 각 액션 이름은 서로 다른 Naver 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Naver search 요청에는 어떤 입력이 필요한가요?
search 액션에서 네이버 블로그와 네이버 카페 콘텐츠를 조회할 한국어 또는 기타 언어 검색 키워드를 지정합니다. reviews 액션의 지도 매장 리뷰에 대한 전문 검색은 수행하지 않습니다. params 안의 keyword 필드로 전달하세요.
Naver search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 source, title, text 및 author_name입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Naver 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.