100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
100 크레딧 무료, 카드 등록 없이

Facebook Adlibrary Search Ads API

API 한 번의 호출로 Facebook Adlibrary Search Ads 데이터를 받아 가세요. Searches the Facebook Ad Library for ads matching a keyword. Returns matching ads with creative text, images, sponsor info, and status.

2026년 7월 업데이트

Facebook Adlibrary Search Ads API, 직접 써 보세요

코드 한 줄 짜기 전에, 실제 데이터부터

GET/v1/facebook/adlibrary/search/ads

Search keyword or phrase to find ads in the Facebook Ad Library

선택 파라미터 10개

Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.

If you want to search by exact phrase or not

Search for all ads or only political and issue ads

This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.

Status of the ad. Defaults to ACTIVE.

Media type of the ad. Defaults to ALL. Meme just means the ad has text and an image. No clue why they call it meme.

Impressions start date. Needs to be in YYYY-MM-DD format.

Impressions end date. Needs to be in YYYY-MM-DD format.

Cursor to paginate through results

Set to true for a trimmed down version of the response

44개 플랫폼을 한 번에 살펴봐요

·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Google Finance logoGoogle Finance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Google Finance logoGoogle Finance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Google Finance logoGoogle Finance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Google Finance logoGoogle Finance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility·Universal Search logoUniversal Search
Facebook API

Adlibrary Search Ads API로 무엇을 할 수 있을까요

Adlibrary Search Ads 엔드포인트가 통합 스키마와 계산 필드를 담은 Facebook 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.

요청 예시

curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/facebook/adlibrary/search/ads?query=artificial+intelligence"
import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/facebook/adlibrary/search/ads",
    params={
    'query': 'artificial intelligence',
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)

data = response.json()
const response = await fetch(
  "https://www.socialcrawl.dev/v1/facebook/adlibrary/search/ads?query=artificial+intelligence",
  {
    headers: { "x-api-key": "YOUR_API_KEY" },
  },
);

const data = await response.json();

파라미터

파라미터필수설명
querySearch keyword or phrase to find ads in the Facebook Ad Library
sort_by아니오Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions. (total_impressions | relevancy_monthly_grouped)
search_type아니오If you want to search by exact phrase or not (keyword_unordered | keyword_exact_phrase)
ad_type아니오Search for all ads or only political and issue ads (all | political_and_issue_ads)
country아니오This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.
status아니오Status of the ad. Defaults to ACTIVE. (ALL | ACTIVE | INACTIVE)
media_type아니오Media type of the ad. Defaults to ALL. Meme just means the ad has text and an image. No clue why they call it meme. (ALL | IMAGE | VIDEO | MEME | IMAGE_AND_MEME | NONE)
start_date아니오Impressions start date. Needs to be in YYYY-MM-DD format.
end_date아니오Impressions end date. Needs to be in YYYY-MM-DD format.
cursor아니오Cursor to paginate through results
trim아니오Set to true for a trimmed down version of the response
응답 예시

Facebook Adlibrary Search Ads API는 무엇을 돌려주나요

모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.

응답 예시 보기
{
  "success": true,
  "platform": "google",
  "endpoint": "/v1/google/search",
  "data": {
    "items": [
      {
        "title": "My Top 50 London Restaurants (26 Jan-9 Feb 2025)",
        "url": "https://anguscolwell.substack.com/p/my-top-50-london-restaurants-26-jan",
        "description": "Feb 9, 2025 · 1) Bouchon Racine, Farringdon. I'm completely obsessed with it, I love it more than anywhere else, it's operating on a level above any other ..."
      },
      {
        "title": "The 38 Best London Restaurants According to Eater's Local Dining ...",
        "url": "https://www.eater.com/maps/best-london-restaurants-eater-38",
        "description": "The best meals in London, from Michelin fine dining to beloved street food, according to a longtime restaurant editor."
      },
      {
        "title": "LONDON by The MICHELIN Guide",
        "url": "https://guide.michelin.com/us/en/travel-guide/london",
        "description": "Discover the beloved restaurants and exciting new openings that everyone is talking about: London's bustling pubs, MICHELIN-Starred restaurants that are among ..."
      }
    ]
  },
  "dropped": 0,
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_example000000",
  "cached": false,
  "pagination": {
    "next_cursor": "sc.eyJ2IjoyLCJjIjoiMiIsInAiOiJwYWdlIn0",
    "has_more": true,
    "page_size": 10
  }
}

통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.

API 상세

Facebook Adlibrary Search Ads API는 어떻게 동작하나요

API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.

메서드

GET

응답 형식

JSON

왜 SocialCrawl인가요

Facebook Adlibrary Search Ads 데이터는 왜 SocialCrawl로 가져올까요

Facebook 데이터 추출에서 까다로운 부분은 SocialCrawl이 가려 드려요. 통합 스키마, AI 인리치먼트, 그리고 코드에 남지 않는 플랫폼 로직까지.

개발자 우선

소셜 미디어 데이터를 몇 초 만에 수집하는 방법

개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 44개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.

모든 플랫폼을 하나의 스키마로

동일한 응답 구조로 44개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.

단순 수집을 넘어 계산된 필드 제공

모든 응답에 engagement_rate, estimated_reach, content_category, language가 포함되어 바로 활용할 수 있습니다.

코드 한 줄 쓰기 전에, 데이터부터

Visual Data Explorer — URL만 붙여넣으면 결과 카드, 정형화된 테이블, CSV 내보내기 기능을 제공합니다.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 44개 플랫폼
자주 묻는 질문

궁금한 점이 있으신가요? 답변해 드립니다

SocialCrawl의 API, 요금제, 기능에 대한 자주 묻는 질문을 확인하세요.

문의하기

AI에게 SocialCrawl을 물어보세요

Facebook Adlibrary Search Ads 데이터, 가져올 준비 되셨어요?

API 키 받고 60초 안에 Facebook 데이터를 받아 가세요.

무료로 시작하기