기업 광고 검색
지정된 조건에 맞는 기업이 운영하는 광고를 검색합니다.
본문
국가 코드를 사용하여 특정 위치를 타겟팅하는 광고를 필터링합니다. 특정 국가에서 표시되는 광고를 찾는 데 사용합니다. filter_conditions와 함께 OR 연산자를 사용합니다 - 광고는 지정된 위치 중 최소 하나를 타겟팅해야 합니다.
["TW", "AE", "NO"]국가 코드를 사용하여 특정 위치를 타겟팅하는 광고를 제외합니다. 특정 국가에서 표시되는 광고를 필터링하여 제외합니다. filter_conditions에서 'or' 연산자와 함께 지정된 경우, 광고는 제외된 위치 중 어느 곳도 타겟팅하지 않아야 합니다.
["IS", "GB", "FR", "IE", "ES"]검색 결과를 필터링하는 키워드 문자열 목록입니다.
["pubrio"]검색 결과를 필터링하는 제목 목록입니다.
["ASUS", "iPhone"]광고 검색의 고급 필터링 옵션입니다. 광고 검색 엔드포인트의 검색 결과를 개선하기 위한 조건을 지정합니다.
검색 결과를 필터링하는 시작 날짜 목록입니다.
["2025-12-01", "2025-12-01"]검색 결과를 필터링하는 종료 날짜 목록입니다.
["2025-12-25", "2025-12-25"]회사 본사 위치입니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참고하세요.
["US", "SG", "CN"]회사 및 인물 조회 작업을 위한 고유 식별자(domain_search_id) 목록.
회사 및 인물 조회 작업에 사용되는 회사 도메인 목록입니다. 입력된 주소가 www.pubrio.com 또는 https://docs.pubrio.com/인 경우, 시스템은 이를 자동으로 pubrio.com으로 변환하여 처리합니다.
["pubrio.com"]LinkedIn 회사 페이지의 전체 URL입니다. http로 시작하며 linkedin.com/company/를 포함해야 합니다.
["https://www.linkedin.com/company/pubrio"]단일 회사 범위 쿼리(즉, domain_search_id, domains, 또는 linkedin_urls 로 필터링됨)에서 실시간 보강을 활성화합니다. 초기 검색 결과가 0건일 때 엔드포인트가 소스를 스크랩해 레코드를 저장한 뒤 검색을 다시 실행하고 응답합니다. 라우트별 데드라인이 적용됩니다.
true
실시간 보강에 사용할 광고 소스 유형을 제한합니다. 생략하면 모든 소스가 기본값으로 사용됩니다. 실시간 보강이 실제로 실행될 때에만 적용됩니다 — 즉, is_realtime_enrichment 또는 enrichment_mode: latest 가 설정된 경우입니다.
linkedin, facebook, google ["linkedin", "facebook"]실시간 보강 동작을 제어합니다. default 는 데이터베이스에 이미 있는 데이터를 반환하며, 결과가 비어 있고 is_realtime_enrichment 가 설정된 경우에만 보강을 트리거합니다. latest 는 캐시를 우회하고 호출마다 최신 소스 레코드를 기준으로 재보강을 강제합니다 — 다른 플래그 없이도 latest 자체가 보강을 트리거합니다.
default, latest "latest"
페이지당 반환할 검색 결과 수입니다. 결과 수를 제한하면 API 성능이 향상됩니다.
25
조회할 데이터 페이지 번호입니다.
1
선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.
자세한 내용은 팀 탭의 user details 엔드포인트를 참고하세요.
응답
회사 광고 검색 세부 정보가 포함된 성공적인 응답입니다.
응답 정보는 특정 API에 따라 다릅니다.

