linkedin-ad-library/
ad

정확한 상세 URL로 LinkedIn Ad Library의 공개 레코드 하나를 조회하고, 공개된 경우 정규화된 광고주, 크리에이티브, 게재, 연결 페이지, 노출 수, 미디어 필드를 반환합니다.

LinkedIn Ad Library Ad API

정확한 상세 URL
공개 광고 정보
null 가능한 투명성 필드
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

LinkedIn Ad Library Ad

LinkedIn Ad Library 상세 페이지는 LinkedIn에서 집행된 광고에 대해 기간이 정해진 공개 정보로, 확인 가능한 경우 크리에이티브, 광고주, 게재, 연결 페이지, 노출 수, 미디어 정보를 담고 있습니다. 수집된 레코드는 그 시점에 확인할 수 있던 내용을 기록한 것이며, 보관 기간, 제한, 원본 상황이 바뀌면 일부만 남거나 사용할 수 없게 될 수 있습니다.

LinkedIn Ad Library Ad API 주요 기능

  • 정확한 상세 URL 조회경로에 /ad-library/detail/이 포함된 linkedin.com URL 하나를 최대 하나의 정규화된 공개 광고 레코드로 조회합니다.
  • 크리에이티브·광고주 정보확인 가능한 광고 식별 정보, 텍스트, 광고주 참조, 포맷, 연결 페이지, 미디어를 안정적인 SocQ 광고 형식으로 보존합니다.
  • 공개된 게재 정보확인 가능한 최초·최근 게재일, 국가, 게재 위치와 안전하게 정규화한 단일 노출 수 값을 반환하며, 비공개 타겟팅을 재구성하지 않습니다.
  • 제한된 레코드의 안전한 처리광고주, 텍스트, 연결 페이지, 노출 수, 미디어 값을 사용할 수 없으면, 원본이 공개하지 않은 정보를 추측하지 않고 null로 둡니다.

LinkedIn Ad Library Ad API 매개변수

매개변수필수설명
url필수필수 값인 공개 LinkedIn Ad Library 상세 URL입니다. 스킴은 http 또는 https여야 하고, 호스트는 linkedin.com으로 끝나야 하며, 경로에 /ad-library/detail/이 포함되어야 합니다.

LinkedIn Ad Library Ad API 사용 방법

정확한 공개 LinkedIn Ad Library 상세 URL 하나를 제출하고, 비동기 작업을 따라간 뒤, 가능한 경우 정규화된 레코드를 읽습니다.

  1. 경로에 /ad-library/detail/이 포함된 http 또는 https LinkedIn Ad Library URL 하나를 복사합니다.
  2. url을 /v1/linkedin-ad-library/ad로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽습니다. 상세 조회는 레코드를 최대 하나만 반환하며, 사용할 수 없는 URL을 검색으로 확장하지 않습니다.
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/ad-library/detail/666281156"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

LinkedIn Ad Library Ad API 추천 활용 사례

  • 발견한 LinkedIn 광고 정보 보강: 알고 있는 공개 상세 URL에 대해 확인 가능한 크리에이티브, 광고주, 게재, 연결 페이지, 노출 수, 미디어 필드를 가져옵니다.
  • 공개 정보 스냅샷 보존: 기간이 정해져 있거나 제한된 공개 항목이 바뀌거나 사라지기 전에 정규화된 레코드와 collected_at 값을 저장합니다.
  • 공개 크리에이티브 근거 비교: 선택한 광고들의 메시지, 포맷, 에셋, 공개된 게재 정보를 검토하되, 레코드를 캠페인 성과 데이터로 취급하지 않습니다.

LinkedIn Ad Library Ad API 활용 팁

  • 광고 ID만 있는 값, 회사 페이지, 검색 URL, URL 목록이 아니라 전체 상세 URL을 제출하세요.
  • 사용할 수 있는 항목이 없는 성공 작업과 제공처 실패를 구분하세요. 어느 쪽도 해당 광고가 존재한 적이 없다는 증거가 아닙니다.
  • 제한되었거나 만료된 레코드는 광고주, 미리보기, 비용 지불자, 텍스트, 미디어, 게재 정보를 의도적으로 생략할 수 있으므로 null 가능한 필드를 그대로 보존하세요.
  • 광고 탐색에는 LinkedIn Ad Library Search를 사용하세요. 이 작업은 제출한 정확한 상세 URL만 조회합니다.

LinkedIn Ad Library Ad API 외에 LinkedIn Ad Library의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • LinkedIn Ad Library Search API — 회사, 회사 ID, 키워드로 공개 LinkedIn 광고를 검색하며, 국가, 날짜, 결과 수 제한을 지정할 수 있습니다.

다른 플랫폼 둘러보기

LinkedIn Ad Library 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

LinkedIn Ad Library Ad API — 자주 묻는 질문

LinkedIn Ad Library Ad API는 정확한 상세 URL로 LinkedIn Ad Library의 공개 레코드 하나를 조회하는 프로그래밍 인터페이스입니다. 공개 레코드에 노출된 경우 정규화된 광고주, 크리에이티브, 게재, 연결 페이지, 노출 수, 미디어 필드를 반환합니다.

경로에 /ad-library/detail/이 포함된 linkedin.com의 http 또는 https URL 하나를 제출합니다. 광고 ID만 있는 값, 회사 페이지, 검색 URL, URL 목록은 받지 않습니다.

일부 지역에서는 원본이 더 풍부한 정보를 노출할 수 있지만, 안정적인 사양에서는 비용 지불자 정보, 타겟팅 규칙, 국가별 노출 수 구분, 행동 유도 문구, 제한 상태를 제공한다고 보장하지 않습니다.

광고가 삭제되었거나, 공개 보관 기간이 지나 만료되었거나, 제한되었거나, 원본에서 형식이 잘못되었거나, 현재 제공처를 통해 조회할 수 없는 경우일 수 있습니다. 이 작업은 다른 광고로 대체하지 않습니다.

반환된 레코드 1건당 0.5 SocQ 크레딧이 차감됩니다. 성공했지만 결과가 비어 있는 경우에는 설정된 기본 요금 0 크레딧만 적용됩니다.