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, 게재 시작일, 게재 플랫폼, 같은 소재를 쓰는 광고 수, 문구, 이미지나 동영상, 랜딩 페이지, 행동 유도 버튼이 담기고, 조건에 맞는 전체 광고 수도 함께 옵니다. 결과는 웹훅이나 폴링으로 받습니다.
soundcoreSponsored
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입니다.
키워드나 광고주로 검색
query는 광고 문구에 든 단어를 순서와 관계없이 찾고, searchType keyword_exact_phrase를 주면 정확한 구문으로 찾습니다. pageId는 한 광고주의 광고를 모읍니다. country로 광고가 게재된 국가를 정하고 ALL로 모든 국가를 검색하며, limit으로 한 번에 최대 500개를 받습니다. 응답의 nextCursor를 cursor로 보내면 이어지는 광고를 받습니다.
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"pageId": "266556540473351",
"country": "US",
"limit": 500
}
}limit: 500광고 1–500번38.1초cursor: "eyJ2IjoxLCJoIj…"광고 501–855번28.7초
응답 두 번에 광고 855개, 모두 한 번씩totalCount: 855
광고주 이름으로 페이지 ID 찾기
action advertisers는 이름이 query와 맞는 Facebook 페이지를 라이브러리 검색창이 제안하는 순서대로 돌려주고, 페이지마다 pageId, 카테고리, 좋아요 수, 인증 배지, Instagram 계정을 담습니다. 고른 pageId를 보내면 그 광고주의 광고를 받습니다.
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"action": "advertisers",
"query": "soundcore",
"country": "US"
}
}
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상태, 형식, 플랫폼, 기간으로 좁히기
activeStatus로 게재 중, 종료, 전체 광고를 고르고, mediaType으로 이미지, 동영상, 밈 광고를, publisherPlatforms로 Facebook, Instagram, Audience Network, Messenger, WhatsApp, Threads 광고를 고릅니다. contentLanguages와 startDate, endDate로 언어와 게재 기간을 좁히고, sortBy로 노출 순이나 최신 순으로 정렬합니다.
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"pageId": "266556540473351",
"country": "US",
"mediaType": "video",
"publisherPlatforms": [
"instagram"
],
"startDate": "2026-11-01"
}
}activeStatusall903active856inactive47
mediaTypememe761video98image0
publisherPlatformsfacebook856instagram856threads340audience_network202whatsapp176messenger0
이 요청98
AI가 추천한 제품과 그 광고주
쇼핑 질문을 답변 엔진에 보내고 추천받은 제품을 이름 그대로 Meta 광고 라이브러리에서 검색하면, 어떤 브랜드가 AI 추천 제품에 광고를 붙이고 어떤 광고주가 그 이름으로 광고하는지 확인합니다.
Soundcore Liberty 5 Pro211건광고주 2곳
soundcore210
Apple AirPods Pro 3464건광고주 90곳
Cosmopolitan63
James Martin Jewelers55
BILL27
Technics EAH-AZ800건
Nothing Ear (3)1건광고주 1곳
Sony WF-1000XM51건광고주 1곳
광고 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원 기준입니다.







