joshu

Search Facebook ad library ads by keyword

From ScrapeCreators, through Joshu Data Bodega.

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

Price
$0.00207 per call$2.07 per 1,000 calls

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

  • trimboolean, optional

    Set to true for a trimmed down version of the response

  • querystring, required

    Keyword to search for

  • cursorstring, optional

    Cursor to paginate through results

  • statusstring, optional

    Status of the ad. Defaults to ACTIVE.

  • ad_typestring, optional

    Search for all ads or only political and issue ads

  • countrystring, optional

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

  • sort_bystring: total_impressions, relevancy_monthly_grouped, optional

    Order only. One of: total_impressions | relevancy_monthly_grouped. Defaults to impressions ranking (total_impressions). Controls result ORDER, not verified performance — does not guarantee non-null spend, impressions_text, or a positive impressions_index. Those fields are often null / -1 for commercial ads and are not verified performance metrics.

  • end_datestring, optional

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

  • media_typestring, optional

    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.

  • start_datestring, optional

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

  • search_typestring, optional

    If you want to search by exact phrase or not

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": "scrapecreators.x.v1-facebook-adlibrary-search-ads",
    "params": {
      "query": "running"
    }
  }'

Channels

The router buys each call through one channel. It picks the cheapest one that is available when the call is made.

  • Via the provider directlyNot available now
  • Via treg$0.00207 per call