플랫폼 가용성
- 24시간 상태
- 99%
최근 30일
제공 기능
각 Yandex 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
Yandex 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 도시 내 키워드로 Yandex Maps의 업체와 장소를 찾습니다. 주소, 전화번호, 웹사이트, 카테고리, 평점, 리뷰 수, 좌표, 현재 영업 여부를 가져옵니다. | keyword | category, lang, language, location, max_price, min_price, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · name · text · address · city · country · categories · rating · rating_scale · review_count · phone · website · lat · lng · is_open_now · platform |
market마켓 검색어로 Yandex Market 상품을 비교합니다. 가격, 평점, 리뷰 수와 구매 수, 상점 이름과 평점, 재고를 가져옵니다. | keyword | city, max_price, min_price, region, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · price · currency · rating · rating_scale · rating_count · review_count · purchase_count · category · shop_name · shop_rating · stock · is_available · image_url · platform |
reviews리뷰 Yandex Maps에서 업체 리뷰를 호출당 최대 200개까지 수집합니다. 각 리뷰에는 텍스트, 점수, 날짜, 좋아요와 싫어요, 업체 측 답변이 포함됩니다. Market 상품 링크가 아닌 지도 장소 링크나 업체 ID를 전달합니다. | url | language, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · text · rating · rating_scale · posted_at · language · like_count · dislike_count · comment_count · author_name · owner_reply · business_id · business_name · business_rating · business_review_count · platform |
Yandex search 파라미터는 각각 무엇을 의미하나요?
도시 내 키워드로 Yandex Maps의 업체와 장소를 찾습니다. 주소, 전화번호, 웹사이트, 카테고리, 평점, 리뷰 수, 좌표, 현재 영업 여부를 가져옵니다. location의 기본값은 모스크바이며, category로 장소 유형을 좁힙니다. 평점은 이용 가능 여부나 품질을 보장하지 않습니다.
keyword필수- Yandex 액션의 검색어를 지정합니다. search에서는 지역 장소를, market에서는 이커머스 상품을 대상으로 합니다. 지도 장소 목록과 상품 카탈로그는 서로 다른 데이터셋을 조회합니다.
category선택- Yandex search 액션의 장소 카테고리를 필터링합니다(예: restaurants, cafes, coffee_shops, hotels, 해제하려면 none). 이 파라미터는 Yandex Market 상품 카테고리에는 적용되지 않으며, 지정한 keyword 및 city와 일치해야 합니다.허용 값:
atmsauto_repairbanksbars_pubsbeauty_salonsburgerscafescar_washcinemascoffee_shopsdentistsdry_cleaningfast_foodfitness_clubsgas_stationsgovernment_servicesgrocery_storeshookah_barshospitalshotelskindergartensmuseumsnonepharmaciespizzarestaurantsschoolsshopping_mallssports_facilitiessushi_rollsveterinary_clinicsYandex Maps: 비즈니스 프로필 카드, 카테고리, 평점 — 공식 프로필 카드 문서는 업종 카테고리, 주소, 평점, 리뷰 수, 영업 정보를 설명합니다. 이는 지도 객체를 설명하기 위한 것이며, 프로필 카드에 버튼이 있다고 해서 이 API가 예약이나 지도 편집 기능을 제공한다는 의미는 아닙니다. · 확인일 lang선택- Yandex search 액션의 응답 언어를 설정하며, ru, en, kk, tr, uk를 받습니다. 검색 인터페이스 로캘을 제어하며, 사용자가 작성한 리뷰 콘텐츠의 번역을 보장하지는 않습니다.허용 값:
enkkrutruk language선택- Yandex 액션에서 다른 언어가 지정되지 않았을 때 사용할 인터페이스 언어를 설정합니다. 기본값은 search에서 ru, reviews에서 en입니다. search 액션에서 lang을 명시적으로 전달하면 이 파라미터보다 우선합니다.
location선택- Yandex search 액션의 대상 도시를 설정하며, 기본값은 Moscow입니다. 이 파라미터는 도시 이름을 받으며 숫자형 Yandex Market 지역 ID와는 다릅니다.
max_price선택- min_price와 함께 사용할 때 대상 Yandex 액션의 가격 상한을 설정합니다. 사용자 평점 최댓값으로 필터링하지는 않습니다. 필터링은 정수 단위로 이루어지며 소수점은 올림 처리됩니다(145.98은 146).
min_price선택- Yandex 액션의 가격 하한을 설정합니다. market에서는 상품 가격을, search에서는 지역 장소의 가격대를 나타냅니다. 이 값은 API 사용 요금이 아니라 대상 플랫폼의 가격입니다. 필터링은 정수 단위로 이루어지며 소수점은 내림 처리됩니다(39.81은 39).
sort선택- Yandex 액션별 정렬 순서를 제어합니다. search는 relevance 또는 distance, market은 popular 또는 top_rated, reviews는 newest(기본값), relevance, top_rated, lowest_rated를 받습니다. 값을 다른 액션에 섞어 쓸 수 없습니다.허용 값:
distancerelevance
Yandex market 파라미터는 각각 무엇을 의미하나요?
검색어로 Yandex Market 상품을 비교합니다. 가격, 평점, 리뷰 수와 구매 수, 상점 이름과 평점, 재고를 가져옵니다. city나 숫자 region 코드로 도시를 설정하며, 기본값은 모스크바입니다. 실제로 주문하지 않으며, 재고를 보장하지 않습니다.
keyword필수- Yandex 액션의 검색어를 지정합니다. search에서는 지역 장소를, market에서는 이커머스 상품을 대상으로 합니다. 지도 장소 목록과 상품 카탈로그는 서로 다른 데이터셋을 조회합니다.
city선택- Yandex market 액션의 대상 도시 slug를 지정합니다(예: moscow, saint_petersburg). 허용된 enum 값과 일치해야 하며, 지도 검색의 location 대신 사용할 수 없습니다.허용 값:
chelyabinskkazankrasnodarkrasnoyarskmoscownizhny_novgorodnovosibirskomskpermrostov_on_donsaint_petersburgsamaraufavolgogradvoronezhyekaterinburgYandex Market: 도시와 상품에 따라 달라지는 배송 조건 — Yandex Market 공식 배송 약관은 배송 방법, 일정, 요금을 도시와 개별 상품에 직접 연동하며, 정확한 조건은 상품 페이지와 결제 페이지에 표시됩니다. 이를 통해 상품 검색 단계의 초기 가격이 최종 배송 포함 총액이나 배송 약속을 보장하지 않는다는 점을 분명히 합니다. · 확인일 max_price선택- min_price와 함께 사용할 때 대상 Yandex 액션의 가격 상한을 설정합니다. 사용자 평점 최댓값으로 필터링하지는 않습니다. 필터링은 정수 단위로 이루어지며 소수점은 올림 처리됩니다(145.98은 146).
min_price선택- Yandex 액션의 가격 하한을 설정합니다. market에서는 상품 가격을, search에서는 지역 장소의 가격대를 나타냅니다. 이 값은 API 사용 요금이 아니라 대상 플랫폼의 가격입니다. 필터링은 정수 단위로 이루어지며 소수점은 내림 처리됩니다(39.81은 39).
region선택- Yandex market 액션의 숫자형 도시 지역 코드를 받으며, 기본값은 213(모스크바)입니다. RU 국가 코드가 아닌 내부 지역 식별자입니다. city 파라미터를 명시적으로 지정하면 이 설정보다 우선합니다.
sort선택- Yandex 액션별 정렬 순서를 제어합니다. search는 relevance 또는 distance, market은 popular 또는 top_rated, reviews는 newest(기본값), relevance, top_rated, lowest_rated를 받습니다. 값을 다른 액션에 섞어 쓸 수 없습니다.허용 값:
populartop_rated
Yandex reviews 파라미터는 각각 무엇을 의미하나요?
Yandex Maps에서 업체 리뷰를 호출당 최대 200개까지 수집합니다. 각 리뷰에는 텍스트, 점수, 날짜, 좋아요와 싫어요, 업체 측 답변이 포함됩니다. Market 상품 링크가 아닌 지도 장소 링크나 업체 ID를 전달합니다. sort를 lowest_rated로 설정하면 불만 리뷰를 먼저 표시할 수 있습니다.
url필수- reviews 액션에 사용할 전체 Yandex Map 장소 URL 또는 businessId 문자열을 지정합니다. Yandex Market 상품 링크는 받지 않습니다.
language선택- Yandex 액션에서 다른 언어가 지정되지 않았을 때 사용할 인터페이스 언어를 설정합니다. 기본값은 search에서 ru, reviews에서 en입니다. search 액션에서 lang을 명시적으로 전달하면 이 파라미터보다 우선합니다.Yandex Maps: 리뷰 원문과 UI 번역 — Yandex 공식 문서에 따르면 인터페이스 언어와 다른 언어로 작성된 리뷰에는 번역문과 함께 원문으로 전환하는 옵션이 표시될 수 있습니다. 따라서 이 API의 언어 파라미터를 리뷰 원문 작성 언어에 대한 직접 필터나 번역 보장으로 간주할 수 없습니다. · 확인일
sort선택- Yandex 액션별 정렬 순서를 제어합니다. search는 relevance 또는 distance, market은 popular 또는 top_rated, reviews는 newest(기본값), relevance, top_rated, lowest_rated를 받습니다. 값을 다른 액션에 섞어 쓸 수 없습니다.허용 값:
lowest_ratednewestrelevancetop_rated
Yandex 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":"yandex","action":"search","params":{"keyword":"<keyword>"}}'
Yandex API 자주 묻는 질문
Yandex API로 무엇을 가져올 수 있나요?
platform을 yandex 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 마켓 및 리뷰입니다. 각 액션 이름은 서로 다른 Yandex 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Yandex search 요청에는 어떤 입력이 필요한가요?
Yandex 액션의 검색어를 지정합니다. search에서는 지역 장소를, market에서는 이커머스 상품을 대상으로 합니다. 지도 장소 목록과 상품 카탈로그는 서로 다른 데이터셋을 조회합니다. params 안의 keyword 필드로 전달하세요.
Yandex search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 name, text, address 및 city입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Yandex 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.