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 하나를 제출하고, 비동기 작업을 따라간 뒤, 가능한 경우 정규화된 레코드를 읽습니다.
- 경로에 /ad-library/detail/이 포함된 http 또는 https LinkedIn Ad Library URL 하나를 복사합니다.
- url을 /v1/linkedin-ad-library/ad로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 itemLinkedIn Ad Library Ad API 추천 활용 사례
- 발견한 LinkedIn 광고 정보 보강: 알고 있는 공개 상세 URL에 대해 확인 가능한 크리에이티브, 광고주, 게재, 연결 페이지, 노출 수, 미디어 필드를 가져옵니다.
- 공개 정보 스냅샷 보존: 기간이 정해져 있거나 제한된 공개 항목이 바뀌거나 사라지기 전에 정규화된 레코드와 collected_at 값을 저장합니다.
- 공개 크리에이티브 근거 비교: 선택한 광고들의 메시지, 포맷, 에셋, 공개된 게재 정보를 검토하되, 레코드를 캠페인 성과 데이터로 취급하지 않습니다.
LinkedIn Ad Library Ad API 활용 팁
- 광고 ID만 있는 값, 회사 페이지, 검색 URL, URL 목록이 아니라 전체 상세 URL을 제출하세요.
- 사용할 수 있는 항목이 없는 성공 작업과 제공처 실패를 구분하세요. 어느 쪽도 해당 광고가 존재한 적이 없다는 증거가 아닙니다.
- 제한되었거나 만료된 레코드는 광고주, 미리보기, 비용 지불자, 텍스트, 미디어, 게재 정보를 의도적으로 생략할 수 있으므로 null 가능한 필드를 그대로 보존하세요.
- 광고 탐색에는 LinkedIn Ad Library Search를 사용하세요. 이 작업은 제출한 정확한 상세 URL만 조회합니다.
관련 API
LinkedIn Ad Library Ad API 외에 LinkedIn Ad Library의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- LinkedIn Ad Library Search API — 회사, 회사 ID, 키워드로 공개 LinkedIn 광고를 검색하며, 국가, 날짜, 결과 수 제한을 지정할 수 있습니다.