SerpApi

SerpApi를 통한 실시간 검색 엔진 결과입니다. 프록시, CAPTCHA 또는 파서를 관리하지 않고 Google, Bing, YouTube, Google Scholar 등을 긁어냅니다. SerpApi는 워크플로가 깨끗하고 구조화된 JSON을 받을 수 있도록 인프라를 처리합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스	클래스	Regions
Copilot Studio	Premium	다음을 제외한 모든 Power Automate 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD)
논리 앱	표준	다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD)
Power Apps	Premium	다음을 제외한 모든 Power Apps 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD)
파워 오토메이트	Premium	다음을 제외한 모든 Power Automate 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD)

Contact
이름	SerpApi
URL	https://serpapi.com
전자 메일	support@serpapi.com

커넥터 메타데이터
Publisher	SerpApi
웹 사이트	https://serpapi.com
개인 정보 보호 정책	https://serpapi.com/legal/privacy
카테고리	웹 사이트; 비즈니스 인텔리전스

SerpApi

SerpApi는 실시간 검색 엔진 결과 API입니다. 스크래핑 인프라를 관리하지 않고도 Power Apps 및 Power Automate 흐름이 깨끗하고 구조화된 JSON을 받을 수 있도록 프록시, CAPTCHA 및 구문 분석을 처리합니다.

Publisher: SerpApi

Prerequisites

SerpApi 계정입니다. serpapi.com 등록합니다.
유효한 SerpApi API 키입니다. 무료 요금제에는 매월 250개 검색이 포함됩니다. 유료 플랜은 더 높은 볼륨에 사용할 수 있습니다.

지원되는 작업

Google Search(`GoogleSearch`)

지정된 쿼리에 대한 구조적 Google Search 결과를 검색합니다. 유기적 결과, 광고, 지식 그래프 항목, 관련 질문, 로컬 결과, 상위 스토리 등을 반환합니다. 반환되는 정확한 필드는 쿼리 및 Google에서 표시되는 항목에 따라 달라집니다.

위치 가져오기(`GetLocations`)

검색 매개 변수에 전달할 location 수 있는 지원되는 지리적 위치 목록을 반환합니다. 검색을 실행하기 전에 도시 또는 지역의 정확한 위치 문자열을 조회하는 데 사용합니다.

계정 정보 가져오기(`GetAccount`)

현재 계획, 월별 검색 할당량, 나머지 검색 및 시간별 사용 통계를 포함하여 SerpApi 계정에 대한 정보를 반환합니다.

자격 증명 가져오기

serpapi.com SerpApi 계정에 로그인합니다.
serpapi.com/manage-api-key 이동합니다.
API 키를 복사합니다.
Power Apps 또는 Power Automate 연결을 만들 때 API 키를 API 키 필드에 붙여넣습니다.

API 키는 Power Platform에서 안전하게 저장되고 모든 요청에 자동으로 삽입됩니다. 연결이 설정된 후에는 다시 제공할 필요가 없습니다.

Getting Started

기본 사용법

이 GoogleSearch 작업은 하나의 필수 인수(검색 쿼리)와 추가 매개 변수의 선택적 레코드를 사용합니다.

Set(varJsonResponse, SerpApi.GoogleSearch("coffee"))

디버깅을 위해 HTML 텍스트 컨트롤에 원시 JSON 응답을 표시하려면 다음을 수행합니다.

$"<pre>{JSON(varJsonResponse, JSONFormat.IndentFour)}</pre>"

선택적 매개 변수 전달

선택적 매개 변수는 레코드(두 번째 인수)로 전달됩니다. 설정하려는 매개 변수만 포함합니다. 키를 생략하면 해당 매개 변수에 대해 아무 것도 보내지 않고 SerpApi에서 자체 기본값을 사용할 수 있습니다.

다음 예제에서 입력 형식 및 이름은 필수가 아닌 권장 사항입니다.

Set(varJsonResponse, SerpApi.GoogleSearch(
    searchQueryInput.Text,
    {
        location: locationInput.Text,
        gl: glInput.Text,
        hl: hlInput.Text,
        lat: latInput.Text,
        lon: lonInput.Text,
        radius: radiusInput.Text,
        uule: uuleInput.Text,
        google_domain: googleDomainInput.Text,
        cr: crInput.Text,
        lr: lrInput.Text,
        tbs: tbsInput.Text,
        nfpr: nfprCheckbox.Value,
        filter: filterCheckbox.Value,
        safe: safeDropdown.Selected.Value,
        device: deviceDropdown.Selected.Value,
        tbm: tbmDropdown.Selected.Value,
        start: startInput.Text,
        ludocid: ludocidInput.Text,
        lsig: lsigInput.Text,
        kgmid: kgmidInput.Text,
        si: siInput.Text,
        ibp: ibpInput.Text,
        uds: udsInput.Text,
        no_cache: noCacheCheckbox.Value
    }
))

컨트롤 형식 매핑:

매개 변수 형식	권장 Power Apps 컨트롤	값 참조
텍스트(문자열)	텍스트 입력	`controlName.Text`
Boolean	토글 또는 확인란	`controlName.Value`
열거형(고정 옵션)	드롭다운	`controlName.Selected.Value`
Number	텍스트 입력	`controlName.Text`

응답 데이터 액세스

응답은 JSON 개체입니다. 변수에서 직접 최상위 속성에 액세스합니다.

varJsonResponse.search_information.total_results

갤러리를 유기적 결과에 바인딩하려면 다음을 수행합니다.

varJsonResponse.organic_results

갤러리를 로컬 비즈니스 결과에 바인딩하려면 다음을 수행합니다.

varJsonResponse.local_results.places

응답 필드의 전체 목록은 SerpApi Google Search 설명서를 참조하세요.

유효한 위치 문자열 조회

전달할 정확한 위치 이름을 찾는 데 GetLocations사용합니다GoogleSearch. 매개 변수는 q 도시 또는 지역 이름을 기준으로 필터링하고 limit 반환된 결과 수를 제한합니다.

Set(varLocations, SerpApi.GetLocations("Austin", {limit: 5}))

갤러리에 결과를 바인딩하려면 다음을 수행합니다.

varLocations

컬렉션의 각 항목에는 name, canonical_name, country_codetarget_type, reach및 필드가 있습니다gps. 후속 canonical_name 호출에서 location 값을 매개 변수로 GoogleSearch 전달합니다.

Set(varResults, SerpApi.GoogleSearch(
    "coffee shops",
    {location: locationGallery.Selected.canonical_name}
))

계정 사용 현황 확인

현재 계획 세부 정보 및 할당량 사용량을 검색하는 데 사용합니다 GetAccount . 이는 월별 한도에 도달하기 전에 남아 있는 검색 수를 확인하는 데 유용합니다.

Set(varAccount, SerpApi.GetAccount())

응답에서 개별 필드에 액세스합니다.

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

응답 필드의 전체 목록은 SerpApi 계정 API 설명서를 참조하세요.

알려진 문제 및 제한 사항

변수 응답 구조: Google Search 응답에 있는 필드는 쿼리 및 Google이 반환하는 내용에 따라 달라집니다. 모든 필드가 모든 응답에 표시되는 것은 아닙니다. 가능한 응답 필드에 대한 전체 설명 은 SerpApi Google Search 설명서를 참조하세요.
속도 제한: 요청은 SerpApi 플랜의 월별 할당량 및 시간당 속도 제한의 적용을 받습니다. 둘 중 하나를 초과하면 오류 응답이 발생합니다 429 .
캐시된 결과: 기본적으로 SerpApi는 각 사용자와 관련된 중복 요청에 대해 캐시의 결과를 제공합니다(최대 1시간). 매개 변수를 no_cache 사용하여 새 결과를 강제로 적용합니다. 캐시된 검색은 월별 할당량에 포함되지 않습니다.

Support

이 커넥터 또는 SerpApi 계정에 대한 도움말은 SerpApi 지원 팀에 문의하세요.

Email:contact@serpapi.com
라이브 채팅: serpapi.com 24/7로 제공되며, SerpApi 지원 팀의 구성원과 직접 대화할 수 있습니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.


기본값	연결을 만들기 위한 매개 변수입니다.	모든 지역	공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름	Type	Description	필수
API 키	시큐어스트링 (보안 문자열)	SerpApi API 키입니다. 에서 찾기 https://serpapi.com/manage-api-key	True

actions

Google Search	지정된 쿼리에 대한 구조적 Google Search 결과를 검색합니다. 유기적 결과, 광고, 지식 그래프, 관련 질문, 상위 스토리, 로컬 결과 등을 반환합니다.
계정 정보 가져오기	계획 세부 정보, 나머지 검색 및 사용 통계를 포함하여 인증된 SerpApi 계정에 대한 정보를 반환합니다.
위치 가져오기	검색에서 위치 매개 변수와 함께 사용할 수 있는 지원되는 지리적 위치 목록을 반환합니다. 도시 또는 지역의 정확한 위치 문자열을 찾는 데 유용합니다.

Google Search

작업 ID:: GoogleSearch

지정된 쿼리에 대한 구조적 Google Search 결과를 검색합니다. 유기적 결과, 광고, 지식 그래프, 관련 질문, 상위 스토리, 로컬 결과 등을 반환합니다.

매개 변수

Name	키	필수	형식	Description
쿼리 검색	q	True	string	검색 쿼리입니다. 모든 표준 연산자(예: site:, inurl:, intitle:) 및 고급 매개 변수(예: as_dt 및 as_eq)를 지원합니다.
Location	location		string	검색이 시작되는 위치입니다. 최상의 정확도를 위해 도시 수준에서 지정합니다(예: 오스틴, 텍사스). uule, lat 또는 lon 매개 변수와 함께 사용할 수 없습니다. 지원되는 위치를 참조 https://serpapi.com/locations-api 하세요.
인코딩된 위치(UULE)	uule		string	Google의 인코딩된 위치 문자열입니다. 정확한 지리적 위치를 위해 위치 매개 변수 대신 사용합니다. 위치, 위도, lon 또는 반지름과 함께 사용할 수 없습니다.
위도	lat		number	검색 원본에 대한 GPS 위도입니다. lon 매개 변수를 사용할 때 필요합니다. 위치 또는 uule과 함께 사용할 수 없습니다.
경도	lon		number	검색 원본에 대한 GPS 경도입니다. 위도 매개 변수를 사용할 때 필요합니다. 위치 또는 uule과 함께 사용할 수 없습니다.
반경(미터)	radius		integer	검색 결과를 편향할 수 있는 미터 단위의 거리입니다. 이 지역 내의 결과는 순위가 더 높습니다. 위치 또는 위도/론과 함께 사용할 수 있습니다. 최대 반경: 데스크톱에서 199m; 태블릿 또는 모바일에서 1000m. uule과 함께 사용할 수 없습니다.
Google 도메인	google_domain		string	사용할 Google 도메인(예: google.com, google.co.uk, google.fr). 기본값은 google.com. 전체 목록을 참조 https://serpapi.com/google-domains 하세요.
Country	gl		string	검색에 대한 두 글자 국가 코드(예: us, gb, fr, de). 전체 목록을 참조 https://serpapi.com/google-countries 하세요.
Language	hl		string	두 글자 인터페이스 언어 코드(예: en, es, fr, de). 전체 목록을 참조 https://serpapi.com/google-languages 하세요.
국가 제한	cr		string	특정 국가에서 시작된 문서로 결과를 제한합니다. \|와 함께 country{CODE} 형식 사용 구분 기호로 지정합니다(예: countryFR\|countryDE).
언어 제한	lr		string	결과를 특정 언어로 제한합니다. \|에서 lang_{code} 형식 사용 구분 기호로 지정합니다(예: lang_fr\|lang_de).
고급 검색 필터	tbs		string	검색할 고급 검색 필터입니다. 날짜 범위, 콘텐츠 형식 등을 기준으로 필터링할 수 있습니다(예: 지난 날의 경우 qdr:d, 지난 주의 경우 qdr:w).
SafeSearch	safe		string	성인 콘텐츠 필터링 수준입니다. 필터링을 사용하도록 설정하거나 해제하여 사용하지 않도록 설정합니다.
자동 수정 결과 제외	nfpr		integer	원래 쿼리의 철자가 틀렸을 때 자동 수정된 쿼리에서 결과를 제외하려면 1로 설정합니다. 포함하려면 0으로 설정합니다(기본값).
콘텐츠 필터 복제	filter		integer	유사한 결과 및 생략된 결과 필터를 제어합니다. 사용하도록 설정하려면 1(기본값) 또는 사용하지 않도록 설정하려면 0으로 설정합니다.
검색 유형	tbm		string	수행할 Google 검색 유형입니다(일치할 대상). 일반 웹 검색을 생략합니다.
결과 오프셋	start		integer	페이지 매김 오프셋입니다. 지정된 결과 수를 건너뜁니다. 0은 첫 번째 페이지를 반환하고, 10은 두 번째 페이지를 반환합니다.
디바이스	device		string	시뮬레이션할 디바이스 유형입니다. 데스크톱(기본값), 태블릿 또는 모바일을 사용합니다.
캐시 바이패스	no_cache		boolean	SerpApi의 1시간 캐시를 무시하고 새 결과를 강제로 적용하려면 true로 설정합니다. 캐시된 검색은 무료이며 월별 할당량에 포함되지 않습니다. 비동기와 함께 사용하지 마세요.
비동기 모드	async		boolean	결과를 동기적으로 기다리는 대신 검색을 제출하고 나중에 검색 보관 API를 통해 결과를 검색하려면 true로 설정합니다. no_cache 함께 사용하지 마세요.
출력 형식	output		string	출력 형식 구조적 JSON의 경우 json(기본값) 또는 원시 HTML의 경우 html로 설정합니다. 디버깅에 html을 사용하거나 아직 완전히 지원되지 않는 결과 형식에 사용합니다.
CID 배치	ludocid		string	특정 위치의 Google CID(고객 식별자)입니다. 로컬 결과에서 place_id. 장소의 지식 그래프를 검색하는 데 사용됩니다.
지식 그래프 ID	kgmid		string	Google Knowledge Graph 엔터티의 KGMID입니다. 시작을 제외한 다른 검색 매개 변수를 재정의할 수 있습니다.
로컬 서명(lsig)	lsig		string	로컬 위치에 대한 지식 그래프 맵 뷰를 강제로 적용하는 데 사용됩니다. 로컬 팩 API 또는 Google 로컬 API를 통해 가져옵니다.
캐시된 검색 매개 변수(si)	si		string	기술 자료 그래프 탭에 대한 캐시된 암호화된 검색 매개 변수입니다. 시작을 제외한 다른 검색 매개 변수를 재정의할 수 있습니다.
레이아웃 확장(ibp)	ibp		string	Google 결과에서 레이아웃 확장을 제어합니다(예: gwp; 0,7).
필터 문자열(uds)	uds		string	결과 필터링을 위한 Google 제공 필터 문자열입니다.
0 추적	zero_trace		boolean	엔터프라이즈 계정만 해당합니다. 검색 매개 변수 및 메타데이터의 서버 쪽 스토리지를 건너뛰려면 true로 설정합니다.

반품

Name	경로	형식	Description
search_metadata	search_metadata	object	상태, 타이밍 및 SerpApi 식별자를 포함하여 검색 요청에 대한 메타데이터입니다.
search_parameters	search_parameters	object	이 검색에 사용되는 매개 변수는 요청에서 다시 에코됩니다.
search_information	search_information	object	총 결과 수 및 소요 시간과 같은 검색에 대한 개략적인 정보입니다.
organic_results	organic_results	array of object	Google에서 반환한 표준 유기 웹 결과입니다.
items	organic_results	object
광고	ads	array of object	유기적 결과 위 또는 아래에 표시된 유료 광고.
items	ads	object
knowledge_graph	knowledge_graph	object	쿼리에 대한 Google Knowledge Graph 패널 데이터(있는 경우)입니다.
related_questions	related_questions	array of object	사용자도 쿼리와 관련된 질문을 합니다.
items	related_questions	object
related_searches	related_searches	array of object	결과 페이지의 맨 아래에 표시된 관련 검색 제안입니다.
items	related_searches	object
local_results	local_results	object	로컬 팩 결과는 쿼리에 로컬 의도가 있을 때 표시됩니다.
top_stories	top_stories	array of object	쿼리와 관련된 주요 뉴스 기사입니다.
items	top_stories	object
페이지 매김	pagination	object	결과의 다음 및 이전 페이지에 대한 링크입니다.

계정 정보 가져오기

작업 ID:: GetAccount

계획 세부 정보, 나머지 검색 및 사용 통계를 포함하여 인증된 SerpApi 계정에 대한 정보를 반환합니다.

반품

인증된 SerpApi 계정에 대한 정보입니다.

몸: AccountInfo

위치 가져오기

작업 ID:: GetLocations

검색에서 위치 매개 변수와 함께 사용할 수 있는 지원되는 지리적 위치 목록을 반환합니다. 도시 또는 지역의 정확한 위치 문자열을 찾는 데 유용합니다.

매개 변수

Name	키	필수	형식	Description
검색어	q		string	사용 가능한 위치 목록(예: 오스틴)을 필터링할 도시 또는 지역 이름입니다.
한계	limit		integer	반환할 최대 위치 수입니다.

반품

response: array of Location

정의

Location

위치 검색 매개 변수와 함께 사용할 수 있는 지원되는 지리적 위치입니다.

Name	경로	형식	Description
id	id	string	이 위치에 대한 고유 식별자입니다.
name	name	string	위치의 전체 이름(예: 오스틴, 텍사스, 미국).
canonical_name	canonical_name	string	위치 매개 변수에 사용되는 정식 이름입니다.
country_code	country_code	string	두 글자 ISO 국가 코드입니다.
target_type	target_type	string	위치 유형(예: 도시, DMA 지역, 국가)입니다.
도달	reach	integer	이 위치에 대한 월별 예상 검색 볼륨 도달률입니다.
gps	gps	array of number	GPS 좌표는 [위도, 경도]입니다.

계정정보

인증된 SerpApi 계정에 대한 정보입니다.

Name	경로	형식	Description
account_id	account_id	string	계정의 고유 식별자입니다.
API 키	api_key	string	이 계정의 API 키입니다.
account_email	account_email	string	계정과 연결된 전자 메일 주소입니다.
plan_name	plan_name	string	현재 구독 계획의 이름입니다.
plan_monthly_price	plan_monthly_price	number	현재 플랜의 월별 가격(USD)입니다.
searches_per_month	searches_per_month	integer	현재 계획에 포함된 월별 총 검색 수입니다.
plan_searches_left	plan_searches_left	integer	현재 청구 기간에 남아 있는 검색 수입니다.
extra_credits	extra_credits	integer	플랜 외부에서 구매한 추가 검색 크레딧입니다.
account_rate_limit_per_hour	account_rate_limit_per_hour	integer	시간당 허용되는 최대 API 요청 수입니다.
this_month_usage	this_month_usage	integer	지금까지 이 청구 기간에 사용된 검색 수입니다.
this_hour_searches	this_hour_searches	integer	현재 시간에 수행한 검색 수입니다.
last_hour_searches	last_hour_searches	integer	이전 시간에 수행한 검색 수입니다.

SerpApi

SerpApi

Publisher: SerpApi

Prerequisites

지원되는 작업

Google Search(GoogleSearch)

위치 가져오기(GetLocations)

계정 정보 가져오기(GetAccount)

자격 증명 가져오기

Getting Started

기본 사용법

선택적 매개 변수 전달

응답 데이터 액세스

유효한 위치 문자열 조회

계정 사용 현황 확인

알려진 문제 및 제한 사항

Support

연결을 만드는 중

기본값

actions

Google Search

매개 변수

반품

계정 정보 가져오기

반품

위치 가져오기

매개 변수

반품

정의

Location

계정정보

Google Search(`GoogleSearch`)

위치 가져오기(`GetLocations`)

계정 정보 가져오기(`GetAccount`)