> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # 기업 광고 검색 > 지정된 조건에 맞는 기업이 운영하는 광고를 검색합니다. `facebook` 광고의 경우 `source_type` 은 Meta 광고 라이브러리 전체(Facebook, Instagram, Messenger, Threads, Audience Network)를 포함하며, `publisher_platforms` 로 노출 위치별로 좁힐 수 있습니다. `destination_url` 은 해석된 랜딩 페이지를 반환합니다(`fb.me` 같은 Facebook 클릭 래퍼는 실제 퍼널 URL로 펼쳐집니다). `raw_link_url` 은 수집된 원본 링크를 그대로 보존합니다. ## OpenAPI ````yaml ko-openapi POST /companies/advertisements/search openapi: 3.0.0 info: description: >- Pubrio API는 마켓 확장 인텔리전스를 제공합니다——기업의 신규 시장 진입을 포착하는 실시간 시그널과 그 기반이 되는 기업·인물 데이터. 계정과 연락처를 검색·조회·보강하고, 200+ 시장에 걸친 유형·날짜가 있는 움직임 시그널을 구독하세요. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ko/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ko/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: 워크스페이스 프로필 정보 및 사용량 통계 - name: Enrichment description: 상세한 B2B 데이터로 인물 및 기업 레코드를 보강 - name: Lookalike description: 지정된 기업과 유사한 기업 검색 - name: Search description: 필터를 사용하여 인물, 기업, 채용, 뉴스 및 광고 검색 - name: Lookup description: 특정 인물, 기업, 채용, 뉴스, 광고 및 기술의 상세 정보 조회 - name: LinkedIn description: LinkedIn 프로필 URL을 통한 인물 및 기업 데이터 조회 - name: Redeem description: 크레딧을 사용하여 인물 연락처 정보 잠금 해제 (단건 및 배치) - name: Channels description: 아웃리치 채널 템플릿 관리 (생성, 수정, 삭제, 목록) - name: Monitor description: 웹훅, 통계 및 처리를 포함한 데이터 모니터 생성 및 관리 - name: Filters description: 검색 매개변수에 사용 가능한 필터 값 조회 (기술, 지역, 버티컬 등) - name: API Keys description: API 키의 요청 로그 및 사용량 분석 조회 - name: Insights description: 회사의 신호 집계 인사이트(채용, 뉴스, 광고). - name: Export description: 대량 데이터 내보내기(크레딧 차감). - name: Expansion description: '회사 시장 확장 인텔리전스: 신호, 단계, 시장, 내보내기.' externalDocs: description: >- Pubrio API는 연락처와 계정 정보를 검색, 미리보기, 그리고 보강하는 데 사용됩니다. Pubrio 데이터베이스는 풍부한 B2B 연락처 및 영업 인텔리전스 데이터를 제공합니다. url: https://docs.pubrio.com paths: /companies/advertisements/search: post: tags: - Search summary: 기업 광고 검색 description: >- 지정된 조건에 맞는 기업이 운영하는 광고를 검색합니다. `facebook` 광고의 경우 `source_type` 은 Meta 광고 라이브러리 전체(Facebook, Instagram, Messenger, Threads, Audience Network)를 포함하며, `publisher_platforms` 로 노출 위치별로 좁힐 수 있습니다. `destination_url` 은 해석된 랜딩 페이지를 반환합니다(`fb.me` 같은 Facebook 클릭 래퍼는 실제 퍼널 URL로 펼쳐집니다). `raw_link_url` 은 수집된 원본 링크를 그대로 보존합니다. operationId: companies_search_advertisements parameters: [] requestBody: required: true content: application/json: schema: type: object properties: target_locations: $ref: '#/components/schemas/target_locations' exclude_target_locations: $ref: '#/components/schemas/exclude_target_locations' search_terms: $ref: '#/components/schemas/search_terms' headlines: $ref: '#/components/schemas/headlines' filter_conditions: $ref: '#/components/schemas/ads_filter_conditions' start_dates: $ref: '#/components/schemas/start_dates' end_dates: $ref: '#/components/schemas/end_dates' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' is_realtime_enrichment: $ref: '#/components/schemas/is_realtime_enrichment' source_types: $ref: '#/components/schemas/advertisement_source_types' enrichment_mode: $ref: '#/components/schemas/advertisement_enrichment_mode' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' profile_id: $ref: '#/components/schemas/profile_id' publisher_platforms: $ref: '#/components/schemas/advertisement_publisher_platforms' exclude_publisher_platforms: $ref: >- #/components/schemas/advertisement_exclude_publisher_platforms is_include_unlinked_companies: $ref: >- #/components/schemas/advertisement_is_include_unlinked_companies responses: '200': description: 회사 광고 검색 세부 정보가 포함된 성공적인 응답입니다. content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/data' example: data: pagination: page: 1 per_page: 25 total_entries: 694356 total_pages: 27775 total_display_pages: 250 is_timeout: false advertisements: - target_country_codes: - US - GB - SG advertisement_id: 3af8cb80-9a04-49a8-832d-333961d5f77a advertisement_search_id: 3af8cb80-9a04-49a8-832d-333961d5f77a created_at: '2026-03-03T01:46:35.909Z' last_modified: '2026-03-03T12:46:25.289Z' started_at: '2026-02-25T00:00:00.000Z' ended_at: '2026-03-02T00:00:00.000Z' title: Thuraya-4 Satellite Solutions for Energy source_type: linkedin advertisement_format: Single Image Ad video_url: null image_url: >- https://buckets.pubrio.com/images/public/cL1U5ghYPAy65qc4cu5wtmgzv8P9xJgrofNTwohPWsyT3S5ob2zNp6Jov1nM9aaDRy.jpg carousel_images: null destination_url: >- https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content companies: logo_url: >- https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg domain_search_id: fe3963dc-87a4-4016-8c95-217ea68cd57a company_name: Space42 linkedin_name: space42ai country_code: AE domain: space42.ai raw_link_url: null publisher_platforms: null - target_country_codes: - US - GB - SG advertisement_id: 47eb6229-e7aa-427f-bcd3-76e154fd5022 advertisement_search_id: 47eb6229-e7aa-427f-bcd3-76e154fd5022 created_at: '2026-06-03T22:00:33.035Z' last_modified: '2026-06-05T18:15:51.823Z' started_at: '2026-05-25T07:00:00.000Z' ended_at: '2026-06-03T07:00:00.000Z' title: Dubai Opportunities. One Exclusive Event source_type: facebook advertisement_format: DCO video_url: null image_url: >- https://buckets.pubrio.com/images/public/4snZgJwKCWEYwAUwxrkkK1ooEFEAMF92Xet6Bm16oAyqwUSoqekDjX8S9DmfixutuH.jpg carousel_images: null destination_url: >- https://promotions.damacproperties.com/en/event-in-egypt-social-specific/ raw_link_url: http://fb.me/ publisher_platforms: - facebook - instagram companies: logo_url: >- https://buckets.pubrio.com/company-logo/MjYwODA0MjRkYW1hY3Byb3BlcnRpZXMuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: 9da7386c-5bdc-42b2-8fee-456e91024a3a company_name: Damac Properties linkedin_name: damac-properties country_code: AE domain: damacproperties.com - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- 국가 코드를 사용하여 특정 위치를 타겟팅하는 광고를 필터링합니다. 특정 국가에서 표시되는 광고를 찾는 데 사용합니다. `filter_conditions`와 함께 OR 연산자를 사용합니다 - 광고는 지정된 위치 중 최소 하나를 타겟팅해야 합니다. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- 국가 코드를 사용하여 특정 위치를 타겟팅하는 광고를 제외합니다. 특정 국가에서 표시되는 광고를 필터링하여 제외합니다. `filter_conditions`에서 'or' 연산자와 함께 지정된 경우, 광고는 제외된 위치 중 어느 곳도 타겟팅하지 않아야 합니다. search_terms: type: array items: type: string example: - pubrio description: 검색 결과를 필터링하는 키워드 문자열 목록입니다. headlines: type: array items: type: string example: - ASUS - iPhone description: 검색 결과를 필터링하는 제목 목록입니다. ads_filter_conditions: type: array items: type: object properties: key: type: string enum: - target_locations - exclude_target_locations example: exclude_target_locations description: 연산자를 적용할 필터 키를 지정합니다. operator: type: string enum: - or - and example: or description: >- 적용할 논리 연산자입니다. 'or'을 사용하여 지정된 위치 중 어느 곳도 제외하지 않는 광고를 매치시키거나, 'and'를 사용하여 지정된 모든 위치를 제외하는 광고를 매치시킵니다. description: 광고 검색의 고급 필터링 옵션입니다. 광고 검색 엔드포인트의 검색 결과를 개선하기 위한 조건을 지정합니다. start_dates: type: array items: type: string format: date example: - '2025-12-01' - '2025-12-01' description: 검색 결과를 필터링하는 시작 날짜 목록입니다. end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: 검색 결과를 필터링하는 종료 날짜 목록입니다. company_locations: type: array items: type: string example: - US - SG - CN description: 회사 본사 위치입니다. 자세한 내용은 필터 탭의 `location` 엔드포인트를 참고하세요. companies: type: array items: type: string format: uuid description: 회사 및 인물 조회 작업을 위한 고유 식별자(domain_search_id) 목록. domains: type: array items: type: string example: - pubrio.com description: >- 회사 및 인물 조회 작업에 사용되는 회사 도메인 목록입니다. 입력된 주소가 `www.pubrio.com` 또는 `https://docs.pubrio.com/`인 경우, 시스템은 이를 자동으로 `pubrio.com`으로 변환하여 처리합니다. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- LinkedIn 회사 페이지의 전체 URL입니다. `http`로 시작하며 `linkedin.com/company/`를 포함해야 합니다. is_realtime_enrichment: type: boolean default: false example: true description: >- 단일 회사 범위 쿼리(즉, `domain_search_id`, `domains`, 또는 `linkedin_urls` 로 필터링됨)에서 실시간 보강을 활성화합니다. 초기 검색 결과가 0건일 때 엔드포인트가 소스를 스크랩해 레코드를 저장한 뒤 검색을 다시 실행하고 응답합니다. 라우트별 데드라인이 적용됩니다. advertisement_source_types: type: array items: type: string enum: - linkedin - facebook - google example: - linkedin - facebook description: >- 실시간 보강에 사용할 광고 소스 유형을 제한합니다. 생략하면 모든 소스가 기본값으로 사용됩니다. 실시간 보강이 실제로 실행될 때에만 적용됩니다 — 즉, `is_realtime_enrichment` 또는 `enrichment_mode: latest` 가 설정된 경우입니다. advertisement_enrichment_mode: type: string enum: - default - latest default: default example: latest description: >- 실시간 보강 동작을 제어합니다. `default` 는 데이터베이스에 이미 있는 데이터를 반환하며, 결과가 비어 있고 `is_realtime_enrichment` 가 설정된 경우에만 보강을 트리거합니다. `latest` 는 캐시를 우회하고 호출마다 최신 소스 레코드를 기준으로 재보강을 강제합니다 — 다른 플래그 없이도 `latest` 자체가 보강을 트리거합니다. per_page: type: integer example: 25 description: 페이지당 반환할 검색 결과 수입니다. 결과 수를 제한하면 API 성능이 향상됩니다. page: type: integer example: 1 description: 조회할 데이터 페이지 번호입니다. profile_id: type: integer description: >- 선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다. 자세한 내용은 팀 탭의 `user details` 엔드포인트를 참고하세요. advertisement_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - facebook - instagram description: >- 게재된 플랫폼 노출 위치로 Facebook/Meta 광고를 필터링합니다. 소문자이며 대소문자를 구분하지 않습니다. `facebook` 소스에만 적용됩니다(다른 소스는 단일 플랫폼). advertisement_exclude_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - audience_network description: 이 플랫폼 노출 위치에서 게재된 Facebook/Meta 광고를 제외합니다. advertisement_is_include_unlinked_companies: type: boolean default: false example: true description: >- 확인된 회사에 아직 연결되지 않은 광고(원시 계층 광고, 예: 사기 또는 일회용 페이지 광고)를 포함합니다. 기본값은 false이며 회사에 연결된 광고만 반환합니다. data: type: object nullable: true description: 응답 정보는 특정 API에 따라 다릅니다. responses: general_error: description: 잘못된 요청. 요청 형식이 올바르지 않거나 잘못된 매개변수가 포함되어 있습니다. 오류 코드와 메시지를 확인하세요. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: 오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요. type: string details: type: object rate_limit_error: description: 요청 속도 제한 초과. 주어진 시간 내에 너무 많은 요청이 전송되었습니다. 속도 제한 창이 재설정된 후 다시 시도하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요. type: string server_error: description: 내부 서버 오류. 서버에서 예기치 않은 오류가 발생했습니다. 오류가 지속되면 지원팀에 문의하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다. in: header ````