LinkedIn Ad Library Search
LinkedIn Ad Library Search는 회사 이름, 정확한 회사 ID, 키워드 또는 이들의 조합으로 보관 중인 공개 광고 정보를 찾아냅니다. 반환된 레코드는 확인 가능한 광고주 정보, 크리에이티브 텍스트, 원본 URL, 게재 기간, 국가, 노출 수, 포맷, 연결 페이지, 미디어를 정규화하며, 공개되지 않은 필드를 0으로 취급하지 않습니다.
LinkedIn Ad Library Search API 주요 기능
- 세 가지 탐색 입력회사 이름, 키워드, 정확한 LinkedIn 회사 ID 또는 이 중 여러 개를 한 요청에 넣어 검색하며, 최소 하나는 필수입니다.
- 국가·날짜 필터두 글자 국가 코드와 선택 사항인 YYYY-MM-DD 형식의 게재 날짜 범위(양 끝 포함)로 공개 색인을 좁힙니다.
- 정규화된 공개 광고 레코드공개된 경우 안정적인 광고 식별 정보, 광고주 참조, 크리에이티브 텍스트, 상세 URL, 날짜, 시장, 포맷, 연결 페이지, 노출 수, 미디어를 반환합니다.
- 토큰 기반 페이지네이션과 수집 상한24건의 배수로 24~1,992건을 수집하며, SocQ가 새 업스트림 페이지네이션 토큰을 따라 제한 개수나 마지막 유효 페이지까지 이어서 가져옵니다.
- 검색에서 상세 조회로 연결발견한 레코드 하나의 상세 보기가 필요하면, 반환된 /ad-library/detail/ URL을 LinkedIn Ad Library Ad에 전달합니다.
LinkedIn Ad Library Search API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
company | 필수(하나 이상) | 회사 또는 광고주 이름입니다. company, keyword, company_id 중 하나 이상이 필요합니다. |
keyword | 필수(하나 이상) | 공개 광고 검색에서 일치시킬 텍스트입니다. 일치 방식은 공개 원본이 정합니다. |
company_id | 필수(하나 이상) | 검색 입력으로 사용하는 정확한 LinkedIn 회사 ID입니다. |
countries | 선택 | 두 글자 알파벳 국가 코드의 선택 목록으로, 대문자를 권장합니다. 예: US, CA. |
start_date | 선택 | 공개 게재 날짜 필터의 시작일로, YYYY-MM-DD 형식의 선택 값입니다. |
end_date | 선택 | 공개 게재 날짜 필터의 종료일로, YYYY-MM-DD 형식의 선택 값이며 start_date보다 앞설 수 없습니다. |
results_limit | 선택 | 요청할 최대 레코드 수입니다. 기본값은 24이며, 24~1,992 사이의 24의 배수를 받습니다. |
LinkedIn Ad Library Search API 사용 방법
탐색 필드를 최소 하나 고르고, 표본을 정의하는 필터만 추가한 뒤, 완료된 비동기 작업의 페이지를 읽습니다.
- company, keyword 또는 company_id를 제공합니다. 원본이 정의한 더 좁은 일치 결과를 원할 때만 함께 사용하세요.
- 필요하면 두 글자 countries, 유효한 날짜 범위, 24의 배수인 results_limit를 추가합니다.
- 요청을 /v1/linkedin-ad-library/search로 POST하고, 반환된 task_id를 저장합니다.
- /v1/tasks/{task_id}를 폴링한 뒤 data.results.items를 읽고, has_more가 true인 동안 next_cursor를 따라가며 가져옵니다.
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}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Ad Library Search API 추천 활용 사례
- 광고주별 광고 탐색: 회사 이름이나 정확한 회사 ID로, 수집 시점에 확인할 수 있는 광고주 관련 공개 광고를 모읍니다.
- 메시지·테마 리서치: 제품, 경쟁사, 테마 키워드를 검색해 반환된 크리에이티브 텍스트, 포맷, 미디어, 연결 페이지를 비교합니다.
- 시장·기간별 비교: 국가와 날짜 필터를 통제한 채 같은 검색을 반복해, 정해진 표본 간 공개 광고 정보를 비교합니다.
- 상세 조회 대상 선정: 반환된 광고 ID와 상세 URL로 개별 레코드를 골라, 별도의 상세 조회 작업으로 더 자세히 살펴봅니다.
LinkedIn Ad Library Search API 활용 팁
- 탐색 필드 하나로 시작하고, 원본이 정의한 더 좁은 결과가 필요할 때만 company, keyword, company_id를 조합하세요.
- 현재 검증기는 대소문자를 가리지 않지만, 저장하는 입력을 일관되게 유지하려면 국가 코드는 대문자로 쓰세요.
- results_limit는 24건 단위로 고르고, 모든 칸이 일치 결과로 채워진다는 약속이 아니라 수집 상한으로 이해하세요.
- 공개 정보와 보관 레코드는 달라질 수 있으므로, 실행 결과를 비교할 때는 검색어, 필터, collected_at 시각을 함께 보관하세요.
- 누락된 광고주, 날짜, 국가, 노출 수, 연결 페이지, 포맷, 미디어 값은 0이 아니라 공개되지 않은 정보로 취급하세요.
관련 API
LinkedIn Ad Library Search API 외에 LinkedIn Ad Library의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- LinkedIn Ad Library Ad API — 정확한 상세 URL로 알고 있는 공개 LinkedIn 광고 라이브러리 기록 하나를 가져오며, 정규화된 광고주, 크리에이티브, 게재, 랜딩, 노출, 미디어 필드를 포함합니다.