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의 별도 제품입니다.
| 기능 | SocQ | LinkedIn Campaign Manager |
|---|---|---|
| 주요 용도 | 공개 광고 레코드 탐색과 정규화 | 권한이 부여된 캠페인 생성·관리 |
| 입력 | 기업 또는 키워드 검색, 또는 정확한 상세 URL 하나 | 권한이 부여된 계정·캠페인 식별자 |
| 인증 | SocQ API 키 | LinkedIn 계정과 광고 권한 |
| 출력 | 공개 공시 필드 | 비공개 캠페인 설정과 리포트 |
LinkedIn Ad Library API 작동 방식
두 엔드포인트 모두 SocQ의 비동기 제출, 폴링, 읽기 흐름을 따릅니다. Search는 여러 페이지를 반환할 수 있고, Ad Details는 최대 1건을 반환합니다.
1. 엔드포인트 선택
Search에는 기업, 기업 ID, 키워드를, Ad Details에는 정확한 공개 Ad Library 상세 URL 하나를 제출합니다.
2. 작업 제출과 추적
요청을 POST하고 task_id를 저장한 뒤, 처리가 끝날 때까지 /v1/tasks/{task_id}를 폴링합니다.
3. 정규화된 레코드 읽기
data.results.items를 처리하고 has_more가 true인 동안 next_cursor를 따라갑니다. 상세 요청은 0건 또는 1건을 반환합니다.
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 크레딧입니다. 레코드가 없는 성공한 작업에는 결과 요금이 부과되지 않습니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
Reddit API
알고 있는 URL에서 공개 Reddit 게시물과 댓글을 가져오고, 서브레딧의 새 글·인기 글·핫 게시물을 둘러보거나, 키워드와 게시 기간으로 토론을 검색합니다.
Pinterest API
공개 Pinterest 프로필 데이터를 가져오고, 알고 있는 핀을 확인하고, 선택한 프로필의 핀을 수집하거나 키워드로 검색해 크리에이터, 콘텐츠, 비주얼 트렌드를 리서치합니다.
Threads API
공개 Threads 프로필을 가져오고, 알고 있는 게시물을 확인하거나, 선택한 프로필의 게시물을 수집합니다. 식별 정보, 콘텐츠, 미디어, 참여도, 타임스탬프 필드가 정규화되어 제공됩니다.
Bluesky API
공개 Bluesky 프로필을 가져오고, 알고 있는 게시물 URL을 확인하거나, 계정 게시물 한 페이지를 수집해 정규화된 신원 정보, 콘텐츠, 미디어, 타임스탬프, 공개된 참여 필드로 받아 봅니다.
Snapchat API
알고 있는 공개 Snapchat Spotlight 하나를 크리에이터, 캡션, 미디어, 오디오, 타임스탬프, 길이, 참여도 필드가 포함된 정규화된 레코드로 가져옵니다.
Twitch API
알고 있는 공개 Twitch 사용자 이름을 정규화된 프로필로 확인하거나 공개 동영상 목록을 수집하고, 클립 하나를 내려받을 수 있는 동영상과 함께 가져와 크리에이터 리서치, 카탈로그 정보 보강, 비교, 스냅샷 모니터링에 활용합니다.

