플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Yelp 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
Yelp 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 도시나 ZIP 코드로 Yelp의 지역 업체를 검색합니다. 평점, 리뷰 수, 가격대, 카테고리, 연락처, 영업시간, 소유권 확인 상태를 가져옵니다. 검색 기본값이 뉴욕이므로 항상 | keyword | location | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · name · url · rating · rating_scale · review_count · price_range · categories · image_url · platform · phone · website · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · images · amenities · highlights · hours |
profile상세 정보 /biz/ 링크로 Yelp 업체 페이지를 엽니다. 평점, 가격대, 카테고리, 연락처, 주소, 영업시간, 편의 시설, 주요 특징, 사진을 가져옵니다. | url | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · name · url · rating · rating_scale · review_count · price_range · phone · website · categories · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · image_url · platform · images · amenities · highlights · hours |
reviews리뷰 Yelp 업체 하나의 리뷰를 페이지당 10개씩 읽습니다. 각 리뷰에는 텍스트, 평점, 날짜, 작성자, 사진 수, Useful·Funny·Cool 투표 수가 포함됩니다. 다음 페이지는 | url | page_token | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=10. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 10까지만 적용됩니다. 다음 페이지를 가져오려면 next_page_token을 page_token으로 전달하고 다른 파라미터는 그대로 두세요. 페이지 하나당 호출 1회입니다. 한 페이지는 최대 100행입니다. 50행을 초과하면 mode=async로 페이지를 요청하세요. | 요청 1,000개당 $1.39 | id · text · rating · rating_scale · posted_at · author_name · useful_count · photo_count · business_name · business_url · platform · funny_count · cool_count |
Yelp search 파라미터는 각각 무엇을 의미하나요?
도시나 ZIP 코드로 Yelp의 지역 업체를 검색합니다. 평점, 리뷰 수, 가격대, 카테고리, 연락처, 영업시간, 소유권 확인 상태를 가져옵니다. 검색 기본값이 뉴욕이므로 항상 location을 설정해야 합니다. health_score는 음식점에만 표시됩니다.
keyword필수- Yelp search 액션의 지역 업체 또는 서비스 검색어를 정의합니다(예: coffee). 기본값인 뉴욕으로 검색되지 않도록 location을 명시적으로 함께 지정하세요.
location선택- 업체 검색에 사용할 도시, 동네 또는 우편번호를 설정합니다(예: Austin, TX 또는 78701). 리뷰 작성자의 위치가 아니라 업체 위치를 나타냅니다.
Yelp profile 파라미터는 각각 무엇을 의미하나요?
/biz/ 링크로 Yelp 업체 페이지를 엽니다. 평점, 가격대, 카테고리, 연락처, 주소, 영업시간, 편의 시설, 주요 특징, 사진을 가져옵니다. is_claimed로 확인할 수 있는 소유권 미확인 페이지는 정보가 오래되었을 수 있습니다. 여기 있는 정보는 소유권이나 인허가를 입증하지 않습니다.
url필수- profile 및 reviews 액션에서 업체 메타데이터나 사용자 리뷰를 가져올 때 사용할, /biz/ slug가 포함된 Yelp 업체 URL을 받습니다. 사용자 프로필 링크는 지원하지 않습니다.
Yelp reviews 파라미터는 각각 무엇을 의미하나요?
Yelp 업체 하나의 리뷰를 페이지당 10개씩 읽습니다. 각 리뷰에는 텍스트, 평점, 날짜, 작성자, 사진 수, Useful·Funny·Cool 투표 수가 포함됩니다. 다음 페이지는 next_page_token을 page_token으로 다시 전달해 가져옵니다. 토큰은 24시간 동안 유효합니다.
url필수- profile 및 reviews 액션에서 업체 메타데이터나 사용자 리뷰를 가져올 때 사용할, /biz/ slug가 포함된 Yelp 업체 URL을 받습니다. 사용자 프로필 링크는 지원하지 않습니다.Yelp: 추천되지 않은 리뷰와 종합 평점의 관계 — Yelp에 따르면 현재 추천되지 않은 리뷰는 업체의 종합 별점이나 리뷰 수에 반영되지 않습니다. 따라서 수집한 표본의 항목 수와 평균 점수를 공식 사이트의 집계 지표로 그대로 제시할 수 없습니다. · 확인일
page_token선택- 페이지네이션 토큰입니다. 다음 페이지를 가져오려면 이전 응답의 next_page_token을 다시 전달하고, 첫 페이지에서는 생략하세요. 다른 파라미터는 모두 그대로 유지하세요. 토큰은 24시간 동안 유효하며 각 페이지는 호출 1건입니다.
Yelp 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":"yelp","action":"search","params":{"keyword":"<keyword>"}}'
Yelp API 자주 묻는 질문
Yelp API로 무엇을 가져올 수 있나요?
platform을 yelp 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 상세 정보 및 리뷰입니다. 각 액션 이름은 서로 다른 Yelp 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Yelp search 요청에는 어떤 입력이 필요한가요?
Yelp search 액션의 지역 업체 또는 서비스 검색어를 정의합니다(예: coffee). 기본값인 뉴욕으로 검색되지 않도록 location을 명시적으로 함께 지정하세요. params 안의 keyword 필드로 전달하세요.
Yelp search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 name, rating, rating_scale 및 review_count입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Yelp 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.