API 목록으로 돌아가기
독립형 공개 광고 데이터

LinkedIn Ad Library API

구조화된 검색 입력으로 공개 LinkedIn 광고를 찾고, 정확한 상세 URL로 선택한 공시 레코드를 가져와 리서치, 검토, 아카이빙에 활용합니다.

사용할 수 있는 LinkedIn Ad Library API

기업, 기업 ID, 키워드로 공개 레코드를 찾을 때는 Ad Search, 이미 알고 있는 레코드 하나를 정확한 공개 URL로 가져올 때는 Ad Details를 사용합니다.

어떤 LinkedIn Ad Library 데이터를 가져올 수 있나요?

SocQ는 공개 공시 필드를 정규화하며 비공개 캠페인 분석 데이터인 것처럼 보이게 하지 않습니다. 제공되지 않는 원본 값은 null이나 빈 값으로 남습니다.

광고와 광고주 식별 정보

노출된 경우 안정적인 광고 ID, 공개 상세 URL, 광고주 ID, 이름, 기업 URL, 로고를 가져옵니다.

크리에이티브와 도착 주소 정보

제공되는 광고 텍스트, 형식, 이미지·동영상 자산, 게재 위치, 랜딩 페이지 도착 주소를 수집합니다.

공개 게재 공시

원본이 제공하는 게재 기간, 국가, 플랫폼, 노출 수, 수집 시각을 보존합니다.

SocQ vs LinkedIn Campaign Manager

SocQ는 공개 Ad Library 공시를 수집합니다. Campaign Manager는 권한이 부여된 광고주가 자신의 캠페인을 관리하는 LinkedIn의 별도 제품입니다.

기능SocQLinkedIn Campaign Manager
주요 용도공개 광고 레코드 탐색과 정규화권한이 부여된 캠페인 생성·관리
입력기업 또는 키워드 검색, 또는 정확한 상세 URL 하나권한이 부여된 계정·캠페인 식별자
인증SocQ API 키LinkedIn 계정과 광고 권한
출력공개 공시 필드비공개 캠페인 설정과 리포트

LinkedIn Ad Library API 작동 방식

두 엔드포인트 모두 SocQ의 비동기 제출, 폴링, 읽기 흐름을 따릅니다. Search는 여러 페이지를 반환할 수 있고, Ad Details는 최대 1건을 반환합니다.

  1. 1. 엔드포인트 선택

    Search에는 기업, 기업 ID, 키워드를, Ad Details에는 정확한 공개 Ad Library 상세 URL 하나를 제출합니다.

  2. 2. 작업 제출과 추적

    요청을 POST하고 task_id를 저장한 뒤, 처리가 끝날 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 정규화된 레코드 읽기

    data.results.items를 처리하고 has_more가 true인 동안 next_cursor를 따라갑니다. 상세 요청은 0건 또는 1건을 반환합니다.

공개 LinkedIn 광고 검색

SocQ API 키로 인증합니다. Search의 기본 결과 수는 24건이며, Ad Details는 정확한 상세 URL 하나를 받고 페이지네이션하지 않습니다.

curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"Microsoft","countries":["US"],"results_limit":24}'

# Or retrieve one known record:
# POST /v1/linkedin-ad-library/ad
# {"url":"https://www.linkedin.com/ad-library/detail/666281156"}
# Poll GET /v1/tasks/{task_id}

LinkedIn Ad Library API 주요 활용 사례

경쟁사 광고 탐색

선택한 기업과 연결된, 확인 가능한 공개 광고를 찾고 검토용으로 공시 정보를 보존합니다.

크리에이티브 검토

선택한 레코드를 가져와 제공되는 텍스트, 미디어, 형식, 도착 주소, 광고주, 게재 기간을 확인합니다.

공개 광고 데이터셋

분석용으로 정규화된 광고 식별 정보, 광고주, 크리에이티브, 게재, 출처, 수집 필드를 저장합니다.

제한 사항과 공개 데이터 정책

결과는 수집 시점에 확인 가능한 공개 색인과 레코드 노출 상태를 반영하며, 비공개 Campaign Manager 데이터가 아닙니다.

  • Search는 company, keyword, company_id 중 하나 이상이 필요하며, 여러 필드를 함께 쓰면 원본의 매칭 방식을 따릅니다.
  • countries는 두 글자 코드를 받고, 날짜는 유효한 범위여야 하며, results_limit은 24부터 1,992까지 24의 배수입니다.
  • 완료된 검색 결과에 항목이 없거나 원본 행이 중복될 수 있고, 조회할 수 없는 상세 URL은 레코드를 반환하지 않을 수 있습니다.
  • 광고주, 크리에이티브, 게재, 노출, 도착 주소, 형식, 미디어 필드는 없을 수 있으며 0으로 해석해서는 안 됩니다.

LinkedIn Ad Library API 자주 묻는 질문

어떤 값을 제출할 수 있나요?

Search는 기업 이름, 기업 ID, 키워드 또는 지원하는 조합을 받습니다. Ad Details는 정확한 공개 LinkedIn Ad Library 상세 URL 하나를 받습니다.

비공개 캠페인 분석 데이터도 반환하나요?

아니요. 제공되는 공개 공시만 반환하며, Campaign Manager의 지출, 클릭, 전환, 타기팅 규칙, 계정 데이터는 제공하지 않습니다.

엔드포인트가 반환할 수 있는 레코드 수는 얼마인가요?

Search의 기본값은 24건이며 1,992건까지 24의 배수로 지정할 수 있습니다. Ad Details는 0건 또는 1건을 반환합니다.

결과 요금은 어떻게 되나요?

반환된 광고 레코드 1건당 0.5 크레딧입니다. 레코드가 없는 성공한 작업에는 결과 요금이 부과되지 않습니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.