linkedin-ad-library/
search

회사, 회사 ID 또는 키워드와 국가·날짜 필터로 공개 LinkedIn 광고를 검색하고, 정규화된 광고주, 크리에이티브, 게재, 연결 페이지, 노출 수, 미디어 필드를 반환합니다.

LinkedIn Ad Library Search API

회사·키워드 검색
24건 단위 페이지네이션
공개 광고 정보
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

탐색 필드를 최소 하나 고르고, 표본을 정의하는 필터만 추가한 뒤, 완료된 비동기 작업의 페이지를 읽습니다.

  1. company, keyword 또는 company_id를 제공합니다. 원본이 정의한 더 좁은 일치 결과를 원할 때만 함께 사용하세요.
  2. 필요하면 두 글자 countries, 유효한 날짜 범위, 24의 배수인 results_limit를 추가합니다.
  3. 요청을 /v1/linkedin-ad-library/search로 POST하고, 반환된 task_id를 저장합니다.
  4. /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 true

LinkedIn Ad Library Search API 추천 활용 사례

  • 광고주별 광고 탐색: 회사 이름이나 정확한 회사 ID로, 수집 시점에 확인할 수 있는 광고주 관련 공개 광고를 모읍니다.
  • 메시지·테마 리서치: 제품, 경쟁사, 테마 키워드를 검색해 반환된 크리에이티브 텍스트, 포맷, 미디어, 연결 페이지를 비교합니다.
  • 시장·기간별 비교: 국가와 날짜 필터를 통제한 채 같은 검색을 반복해, 정해진 표본 간 공개 광고 정보를 비교합니다.
  • 상세 조회 대상 선정: 반환된 광고 ID와 상세 URL로 개별 레코드를 골라, 별도의 상세 조회 작업으로 더 자세히 살펴봅니다.

LinkedIn Ad Library Search API 활용 팁

  • 탐색 필드 하나로 시작하고, 원본이 정의한 더 좁은 결과가 필요할 때만 company, keyword, company_id를 조합하세요.
  • 현재 검증기는 대소문자를 가리지 않지만, 저장하는 입력을 일관되게 유지하려면 국가 코드는 대문자로 쓰세요.
  • results_limit는 24건 단위로 고르고, 모든 칸이 일치 결과로 채워진다는 약속이 아니라 수집 상한으로 이해하세요.
  • 공개 정보와 보관 레코드는 달라질 수 있으므로, 실행 결과를 비교할 때는 검색어, 필터, collected_at 시각을 함께 보관하세요.
  • 누락된 광고주, 날짜, 국가, 노출 수, 연결 페이지, 포맷, 미디어 값은 0이 아니라 공개되지 않은 정보로 취급하세요.

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

  • LinkedIn Ad Library Ad API — 정확한 상세 URL로 알고 있는 공개 LinkedIn 광고 라이브러리 기록 하나를 가져오며, 정규화된 광고주, 크리에이티브, 게재, 랜딩, 노출, 미디어 필드를 포함합니다.

다른 플랫폼 둘러보기

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

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

LinkedIn Ad Library Search API는 회사 이름, 정확한 회사 ID, 키워드 또는 지원되는 조합으로 보관 중인 공개 LinkedIn 광고 레코드를 찾는 프로그래밍 인터페이스입니다. 확인 가능한 필드를 SocQ의 정규화된 광고 형식으로 반환합니다.

company, keyword, company_id 중 하나 이상을 제공해야 합니다. 여러 개를 함께 제출할 수 있지만, 정확한 일치와 교집합 방식은 업스트림 공개 검색이 정합니다.

이 엔드포인트는 두 글자 countries 목록과 선택 값인 start_date, end_date를 받습니다. 공개 정렬 옵션은 제공하지 않습니다.

레코드에는 광고·광고주 식별 정보, 공개 상세 URL, 크리에이티브 텍스트, 시작일과 종료일, 국가, 단일 노출 수, 포맷, 게재 위치, 연결 페이지, 미디어, 수집 시각이 확인 가능한 경우 포함될 수 있습니다.

수집 시점에 제출한 탐색 필드와 필터에 일치하는 보관된 공개 광고가 없을 수 있습니다. 결과가 비어 있다고 해서 해당 광고주가 광고를 집행한 적이 없다는 뜻은 아닙니다.

업스트림 원본은 페이지당 최대 24개의 광고를 반환합니다. SocQ는 results_limit에 도달하거나, 마지막 페이지, 빈 페이지, 누락된 토큰, 반복된 토큰이 나올 때까지 새 페이지네이션 토큰을 따라갑니다.

반환된 정규화 광고 1건당 0.5 SocQ 크레딧이 차감됩니다. 반환된 레코드가 없는 성공 작업에는 결과 요금이 부과되지 않습니다.