플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 SERP 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 웹 검색을 실행해 제목, URL, 스니펫, 순위, 게시일이 포함된 순위별 결과를 받습니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
SERP 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 웹 검색을 실행해 제목, URL, 스니펫, 순위, 게시일이 포함된 순위별 결과를 받습니다. 이미지와 하위 링크는 있을 때 함께 반환됩니다. | keyword | country, language | Sync 응답 | 카탈로그 값: maxLimit=10. 최종 행 수로 간주하기 전에 액션 참고 사항을 확인하세요. 더 큰 limit도 허용되지만 최대 10까지만 적용됩니다. | 요청 1,000개당 $1.39 | title · url · text · rank · published_at · image_url · sub_links |
SERP search 파라미터는 각각 무엇을 의미하나요?
웹 검색을 실행해 제목, URL, 스니펫, 순위, 게시일이 포함된 순위별 결과를 받습니다. 이미지와 하위 링크는 있을 때 함께 반환됩니다. country와 language는 선호 조건을 지정할 뿐, 모든 결과가 일치한다고 보장하지 않습니다. 페이지 전체를 가져오지는 않으며, published_at은 누락되거나 부정확할 수 있습니다.
keyword필수- 웹 검색 쿼리 표현식을 지정합니다. 결과 제목, URL, 스니펫을 반환하며, 검색 결과에 포함된 페이지의 전체 콘텐츠를 가져오거나 플랫폼 이름으로 필터링하지는 않습니다.Google: 검색 스니펫은 원본 웹페이지 텍스트와 다르다 — Google은 스니펫을 검색 결과에 표시되는 설명이나 요약으로 정의하며, 스니펫은 검색어에 따라 동적으로 바뀌거나 페이지의 메타 설명에서 가져올 수 있다고 설명합니다. 이 액션이 반환하는 텍스트는 대상 페이지의 전문이 아니므로, 사실을 인용할 때는 원본 페이지를 직접 확인해 검증해야 합니다. · 확인일
country선택- us 같은 코드로 검색 결과의 국가 또는 지역 선호도를 설정합니다. 호출하는 서버의 위치가 아니라 지리적 관련성에 영향을 주며, 모든 결과가 해당 국가에 있다고 보장하지는 않습니다.
language선택- 검색 인터페이스와 결과 언어 선호도를 설정합니다(예: en, zh-cn). 반환된 페이지 콘텐츠를 번역하지는 않습니다.
SERP 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":"web","action":"search","params":{"keyword":"<keyword>"}}'
SERP API 자주 묻는 질문
SERP API로 무엇을 가져올 수 있나요?
platform을 web 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색입니다. 각 액션 이름은 서로 다른 SERP 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
SERP search 요청에는 어떤 입력이 필요한가요?
웹 검색 쿼리 표현식을 지정합니다. 결과 제목, URL, 스니펫을 반환하며, 검색 결과에 포함된 페이지의 전체 콘텐츠를 가져오거나 플랫폼 이름으로 필터링하지는 않습니다. params 안의 keyword 필드로 전달하세요.
SERP search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, text, rank 및 published_at입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 SERP 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.