본문으로 건너뛰기

Meta 광고 라이브러리 API: Facebook, Instagram 광고를 JSON으로

키워드나 광고주로 Meta 광고 라이브러리를 검색해 Facebook, Instagram, Messenger, WhatsApp, Threads에 게재 중인 광고를 하나의 비동기 API에서 JSON으로 받습니다. 광고마다 문구, 이미지와 동영상, 랜딩 페이지, 행동 유도 버튼, 게재 시작일, 게재 플랫폼을 담습니다.

2026년 11월 20일에 실행한 Meta 광고 라이브러리 검색을 응답의 광고로 그렸습니다.

광고주가 Meta에 게재한 광고 전부

taskType ADS에 payload.platform meta_ad_library를 보내고, pageId에 광고주의 Facebook 페이지 ID를, 또는 query에 키워드를 넣습니다. 광고마다 라이브러리 ID, 게재 시작일, 게재 플랫폼, 같은 소재를 쓰는 광고 수, 문구, 이미지나 동영상, 랜딩 페이지, 행동 유도 버튼이 담기고, 조건에 맞는 전체 광고 수도 함께 옵니다. 결과는 웹훅이나 폴링으로 받습니다.

Active
Library ID: 2033461067351971
Started running on Nov 14, 2026
Platforms
This ad has multiple versions
5 ads use this creative and text
See summary details
soundcoreSponsored
🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.
libraryId2033461067351971
Meta 광고 라이브러리의 광고 ID입니다. libraryUrl로 라이브러리에서 엽니다.
startDateisActive2026-11-14 · true
광고 게재 시작일과 지금 게재 중인지 여부입니다.
platformsFACEBOOK, INSTAGRAM
광고를 노출하는 Meta 앱입니다.
versionsformat5 · DCO
같은 소재와 문구를 쓰는 광고 수입니다. DCO는 Meta가 카드를 조합해 만드는 광고입니다.
pageNamepageLikeCountsoundcore · 147919
광고주 페이지와 좋아요 수입니다. pageId로 그 광고주의 다른 광고를 검색합니다.
body🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.
이미지 위에 보이는 광고 문구입니다.
cards2
카드마다 이미지나 동영상, 문구, 링크를 담습니다. 라이브러리는 첫 번째 카드를 보여 줍니다.
titlectaTextlinkUrlAeroClip 2 Open-Ear · Shop now
이미지 아래 링크 영역의 제목, 설명, 버튼과 linkUrl입니다.
2026년 11월 20일에 ADS로 soundcore 페이지의 미국 광고를 검색해 받은 첫 번째 광고를 라이브러리 카드로 그렸습니다.
단계 1

키워드나 광고주로 검색

query는 광고 문구에 든 단어를 순서와 관계없이 찾고, searchType keyword_exact_phrase를 주면 정확한 구문으로 찾습니다. pageId는 한 광고주의 광고를 모읍니다. country로 광고가 게재된 국가를 정하고 ALL로 모든 국가를 검색하며, limit으로 한 번에 최대 500개를 받습니다. 응답의 nextCursor를 cursor로 보내면 이어지는 광고를 받습니다.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "pageId": "266556540473351",
    "country": "US",
    "limit": 500
  }
}
  1. limit: 500광고 1–500번38.1초
  2. cursor: "eyJ2IjoxLCJoIj…"광고 501–855번28.7초

응답 두 번에 광고 855개, 모두 한 번씩totalCount: 855

2026년 11월 20일에 soundcore 페이지의 미국 광고를 ADS로 두 번 검색했습니다. 두 번째 요청은 첫 응답의 nextCursor를 cursor로 보냈습니다.
단계 2

광고주 이름으로 페이지 ID 찾기

action advertisers는 이름이 query와 맞는 Facebook 페이지를 라이브러리 검색창이 제안하는 순서대로 돌려주고, 페이지마다 pageId, 카테고리, 좋아요 수, 인증 배지, Instagram 계정을 담습니다. 고른 pageId를 보내면 그 광고주의 광고를 받습니다.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "action": "advertisers",
    "query": "soundcore",
    "country": "US"
  }
}
USsoundcore
"soundcore"Search this exact phrase
Advertisers
soundcore@soundcoreaudio · 148K follow this · Electronics@soundcoreaudio · 154K followers266556540473351
AnkerSoundcoreuk@ankersoundcoreUK · 1.8K follow this · Information Technology Company328639343660125
Anker soundcore Polska@AnkersoundcorePL · 1.4K follow this · Electronics@anker_soundcore_polska · 2.9K followers613865685153030
soundcore Deutschland1.2K follow this · Music & Audio@soundcore_de · 17.8K followers265641373306592
2026년 11월 20일에 미국에서 “soundcore”로 실행한 advertisers 액션입니다. 받은 페이지 15개 중 처음 4개를 라이브러리 검색창이 제안하는 순서대로 pageId와 함께 그렸습니다.
단계 3

상태, 형식, 플랫폼, 기간으로 좁히기

activeStatus로 게재 중, 종료, 전체 광고를 고르고, mediaType으로 이미지, 동영상, 밈 광고를, publisherPlatforms로 Facebook, Instagram, Audience Network, Messenger, WhatsApp, Threads 광고를 고릅니다. contentLanguages와 startDate, endDate로 언어와 게재 기간을 좁히고, sortBy로 노출 순이나 최신 순으로 정렬합니다.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "pageId": "266556540473351",
    "country": "US",
    "mediaType": "video",
    "publisherPlatforms": [
      "instagram"
    ],
    "startDate": "2026-11-01"
  }
}
activeStatus
  • all903
  • active856
  • inactive47
mediaType
  • meme761
  • video98
  • image0
publisherPlatforms
  • facebook856
  • instagram856
  • threads340
  • audience_network202
  • whatsapp176
  • messenger0

이 요청98

2026년 11월 20일에 soundcore 페이지의 미국 광고에 필터를 하나씩 걸어 받은 라이브러리 집계입니다. mediaType과 publisherPlatforms는 게재 중인 광고를 셉니다.

AI가 추천한 제품과 그 광고주

쇼핑 질문을 답변 엔진에 보내고 추천받은 제품을 이름 그대로 Meta 광고 라이브러리에서 검색하면, 어떤 브랜드가 AI 추천 제품에 광고를 붙이고 어떤 광고주가 그 이름으로 광고하는지 확인합니다.

ChatGPT 추천 · “What are the best wireless earbuds under $200?”제품명이 들어간 Meta 집행 광고, 미국
  1. Soundcore Liberty 5 Pro211건광고주 2곳soundcore210
  2. Apple AirPods Pro 3464건광고주 90곳Cosmopolitan63James Martin Jewelers55BILL27
  3. Technics EAH-AZ800건
  4. Nothing Ear (3)1건광고주 1곳
  5. Sony WF-1000XM51건광고주 1곳
ChatGPT가 2026년 11월 19일에 추천한 제품입니다. 2026년 11월 20일에 ADS로 미국에서 집행 중인 광고를 제품명 그대로 검색했고, 막대는 검색마다 받은 광고 수입니다. 광고주 중 브랜드는 이름을 적었습니다.

광고 30개당 0.5크레딧

검색은 받은 광고 30개마다 0.5크레딧이고 최소 0.5크레딧입니다. 기본 요청(광고 30개)은 0.5크레딧, 광고 500개 검색은 최대 8.5크레딧입니다. 광고주 검색은 0.5크레딧입니다. 완료된 요청에만 과금됩니다.

요금제 확인 →
플랜별 요청 비용
플랜1,000회
Basic약 1,750원
Max약 700원

월 포함 크레딧을 모두 사용했을 때의 환산 단가입니다. 원화는 $1 ≈ 1,400원 기준입니다.

함께 살펴보기

무료 크레딧 500으로 시작하세요

Playground에서 첫 태스크를 실행하거나, API 키로 바로 호출하세요.