joshu

Search the Meta ad library by keyword

From Meta Ad Library, through Joshu Data Bodega.

Part of Meta Ads (Facebook & Instagram) library search.

Price
$0 per call

No calls measured in the last 30 days.

Prices include the router's 10% markup and are paid from the usage wallet. Checked on November 11, 2026.

Inputs

  • afterstring, optional

    paging.cursors.after from the previous response

  • limitinteger, optional

    page size; 25 by default, a few hundred is the practical ceiling before Meta starts timing out

  • fieldsstring, required

    comma-separated; nothing but id comes back by default

  • ad_typestring, optional

    ALL (default) | POLITICAL_AND_ISSUE_ADS | HOUSING_ADS | EMPLOYMENT_ADS | FINANCIAL_PRODUCTS_AND_SERVICES_ADS

  • languagesarray, optional

    ISO 639-1 codes (plus CMN, YUE)

  • media_typestring, optional

    ALL | IMAGE | MEME | VIDEO | NONE

  • search_typestring, optional

    KEYWORD_UNORDERED (default, all words in any order) | KEYWORD_EXACT_PHRASE

  • search_termsstring, optional

    max 100 characters; matched against the ad's text. Required in practice unless you filter by search_page_ids instead

  • ad_active_statusstring, optional

    ACTIVE (default) | INACTIVE | ALL — ALL is what you want for creative research, since a competitor's best-performing ad may have finished

  • publisher_platformsarray, optional

    FACEBOOK | INSTAGRAM | AUDIENCE_NETWORK | MESSENGER | WHATSAPP | OCULUS | THREADS

  • ad_delivery_date_maxstring, optional

    YYYY-MM-DD

  • ad_delivery_date_minstring, optional

    YYYY-MM-DD; ads that were delivering on or after this date

  • ad_reached_countriesarray, required

    REQUIRED on every ads_archive call. JSON array of ISO country codes, URL-encoded — ["US"] — or ALL

  • estimated_audience_size_mininteger, optional

    one of the fixed buckets 100 | 1000 | 5000 | 10000 | 50000 | 100000 | 500000 | 1000000

Call it

Router call with a router API key
curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "meta-ad-library.meta-ads.library.search",
    "params": {
      "ad_reached_countries": [
        "US"
      ],
      "fields": "id,page_id,page_name,ad_creative_bodies,ad_creative_link_titles,ad_creative_link_captions,ad_snapshot_url,ad_delivery_start_time,ad_delivery_stop_time,publisher_platforms,languages,estimated_audience_size"
    }
  }'