Facebook Hashtag Scraper - Ad Library Search by Hashtag

Search the Facebook (Meta) Ad Library by hashtag and turn each match into one structured dataset record. This Actor accepts an array of hashtags and returns the advertiser identity, ad copy, CTA, creative media URLs, delivery dates, active status, publisher platforms, and disclosed impressions or spend where Meta provides them. One record means one matched ad, which makes the dataset easy to review, compare, and pass into the next workflow step. It is an Apify Actor and usable through Apify MCP.

Best fit and connected workflows

This Actor fits workflows where the starting point is a hashtag and the goal is to inspect the ads attached to that tag:

• Creative research on seasonal or product hashtags such as #blackfriday or #skincare
• Advertiser discovery for a niche, category, or campaign theme
• Live monitoring of ads across one or more hashtags
• Review of disclosed reach, impressions, and spend where Meta provides them
• Agent-driven research through Apify MCP with structured ad records returned in one step

A constructive workflow path looks like this: start with this Actor to identify the ads behind a hashtag, then use the returned advertiser or ad references to continue into Facebook Post Comments Scraper or Facebook Likes Scraper - Public Reactions & Profiles when the next question is about engagement signals around a returned Facebook record.

Practical scenario

Maya works on paid social research for a cosmetics brand. She starts with #skincare and wants a quick view of which advertisers are running ads around that term, what they are saying, and where the ads lead.

She runs the Actor with a hashtag list and a country filter. The dataset returns fields such as pageName, title, bodyText, ctaText, mediaType, publisherPlatforms, startDate, endDate, and adLibraryUrl. Maya uses pageName and bodyText to identify recurring advertisers, then opens adLibraryUrl on the most relevant records to review the creative in Meta's Ad Library and decide which brands to track next.

Input

Field	Type	Description
hashtags	array[string]	Required. Hashtags to search in the Facebook Ad Library. The leading # is optional, and spaces inside a tag are removed. Each hashtag is searched independently.
maxResultsPerHashtag	integer	Maximum ads returned for each hashtag. This also acts as the per-hashtag cost cap.
country	string	Two-letter ISO country code for delivery scope, or ALL.
status	string	Ad status filter: ACTIVE, INACTIVE, or ALL.
mediaType	string	Creative format filter such as ALL, IMAGE, VIDEO, MEME, or IMAGE_AND_MEME.
searchType	string	Match mode: keyword_unordered or keyword_exact_phrase.
sortBy	string	Ordering: total_impressions or relevancy_monthly_grouped.
startDate	string	Lower bound for impressions delivery date in YYYY-MM-DD format.
endDate	string	Upper bound for impressions delivery date in YYYY-MM-DD format.
includeRaw	boolean	Attaches the unmodified provider payload under raw for each ad when enabled.
providerOrder	string	Provider order control for testing and fallback handling.

Focused input example

{
  "hashtags": ["#blackfriday", "#skincare"],
  "maxResultsPerHashtag": 100,
  "country": "US",
  "status": "ACTIVE",
  "mediaType": "ALL",
  "searchType": "keyword_unordered",
  "sortBy": "total_impressions"
}

Output

The dataset contains one record per Facebook (Meta) Ad Library ad matching a searched hashtag. The overview views highlight advertiser, copy, status, media, and links. The full record includes delivery details, media URLs, disclosure fields, and provider provenance.

Field	Type	Description
recordType	string	Always ad.
inputHashtag	string	The hashtag as entered by the user.
query	string	Normalized hashtag query sent to the Ad Library.
resultIndex	integer	Zero-based position within that hashtag's result set.
adArchiveId	string or null	Meta Ad Library archive ID.
adLibraryUrl	string or null	Direct Ad Library link for the ad.
pageId	string or null	Facebook page ID of the advertiser.
pageName	string or null	Advertiser page name.
pageProfileUrl	string or null	URL of the advertiser's Facebook page.
isActive	boolean or null	Whether the ad is currently running.
startDate	string or null	ISO 8601 delivery start date.
endDate	string or null	ISO 8601 delivery end date when known.
totalActiveDays	integer or null	Approximate number of active days.
publisherPlatforms	array[string]	Platforms where the ad ran.
displayFormat	string or null	Raw creative format reported by Meta.
mediaType	string or null	Derived creative type.
title	string or null	Ad headline.
bodyText	string or null	Primary ad copy.
caption	string or null	Link caption under the creative.
ctaText	string or null	CTA button label.
ctaType	string or null	CTA button type.
linkUrl	string or null	Destination URL.
imageUrls	array[string]	Creative image URLs, including carousel cards.
videoUrls	array[string]	Creative video URLs, including carousel cards.
cardCount	integer or null	Number of carousel cards.
categories	array[string]	Ad categories reported by Meta.
containsSensitiveContent	boolean or null	Meta sensitive-content flag.
currency	string or null	Currency for disclosed spend.
spend	number or null	Disclosed spend midpoint.
impressionsText	string or null	Disclosed impressions range as text.
reachEstimate	number or null	Estimated reach when disclosed.
collationCount	integer or null	Count of similar ads grouped with this one.
entityType	string or null	Advertiser entity type reported by Meta.
provider	string	Data provider that returned the record.
scrapedAt	string	ISO 8601 collection timestamp.

Illustrative output record

{
  "recordType": "ad",
  "inputHashtag": "#blackfriday",
  "query": "#blackfriday",
  "resultIndex": 0,
  "adArchiveId": "123456789",
  "adLibraryUrl": "https://www.facebook.com/ads/library/?id=123456789",
  "pageName": "Acme Store",
  "pageProfileUrl": "https://www.facebook.com/acmestore",
  "isActive": true,
  "startDate": "2026-01-01T00:00:00.000Z",
  "publisherPlatforms": ["facebook", "instagram"],
  "displayFormat": "video",
  "mediaType": "VIDEO",
  "title": "Black Friday Blowout",
  "bodyText": "Save on selected items this weekend.",
  "ctaText": "Shop Now",
  "ctaType": "SHOP_NOW",
  "linkUrl": "https://acme.example/sale",
  "videoUrls": ["https://video.example/1.mp4"],
  "impressionsText": "10K-15K",
  "provider": "scrapecreators",
  "scrapedAt": "2026-01-01T12:34:56.000Z"
}

How it works

The Actor searches the Meta Ad Library by hashtag and returns matched ad creatives as normalized dataset records. The live contract shows two data providers: ScrapeCreators as the primary route and SociaVault as the fallback. It uses cursor pagination and stops when it reaches the per-hashtag result cap or when no more results are available. The input schema also supports optional raw payload capture for records that need provider-level detail.

Pricing

Facebook Hashtag Scraper - Ad Library Search by Hashtag uses Pay per event pricing plus Apify platform usage. The live pricing tab shows the current rates for the Actor and the platform usage that applies to your run. In the event contract, Actor Start is charged when a run begins and Ad found is charged for each matched ad saved to the dataset.

A simple example in words: if you search three hashtags and each hashtag returns fifty ads, the execution processes one hundred fifty ad-found events, plus the run-start event. Your final cost follows the live Pricing tab and the number of returned ads.

Use with AI agents (MCP)

This Actor is available through Apify MCP as a tool for hashtag-based Meta Ad Library search. It accepts structured hashtag input and returns normalized ad records that an agent can read, summarize, compare, or hand off to another workflow.

Identity: khadinakbar/facebook-hashtag-scraper

Tool description: search the Facebook (Meta) Ad Library by hashtag and return matched ad creatives with advertiser, copy, media, delivery, and disclosure fields.

Find the ads running on #skincare in the US, return active results first, and summarize the advertiser names, CTA text, media type, and any disclosed impressions from the dataset records.

Output interpretation: each dataset item represents one matching ad. Use inputHashtag and query to trace the search term, pageName and pageProfileUrl to identify the advertiser, and adLibraryUrl to open the original ad. provider and scrapedAt describe where and when the record was collected. If includeRaw is enabled, the record also carries the provider's original payload in raw.

Scope: this tool searches hashtag-matched ads in the Meta Ad Library. It is designed for advertising research, not organic hashtag posts.

Pagination and cost guidance: the Actor paginates through results until it reaches maxResultsPerHashtag or exhausts available ads. Because charging is per returned ad, a smaller per-hashtag cap keeps the billed event count tightly aligned with the records you need.

Example with the Apify API

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({
  token: process.env.APIFY_TOKEN,
});

const input = {
  hashtags: ['#blackfriday'],
  maxResultsPerHashtag: 10,
  country: 'US',
  status: 'ACTIVE',
};

const run = await client.actor('khadinakbar/facebook-hashtag-scraper').call(input);

const dataset = client.dataset(run.defaultDatasetId);
const items = await dataset.listItems();

console.log('Dataset ID:', run.defaultDatasetId);
for (const item of items.items) {
  console.log(item.pageName, item.title, item.adLibraryUrl);
}

Best results and outcome guidance

Use a focused hashtag list when you want a clean comparison set. Add country when delivery scope matters, and pair startDate and endDate when you want a specific campaign window. Choose status: "ACTIVE" for live monitoring and sortBy: "total_impressions" when you want higher-reach ads near the top. Turn on includeRaw when you need provider payload detail for debugging or deeper inspection.

Continue the workflow

• Then use Facebook Likes Scraper to continue from Facebook Hashtag Scraper - Ad Library Search by Hashtag discovery into engagement data for the selected records.
• Then use Facebook Marketplace Scraper to continue from Facebook Hashtag Scraper - Ad Library Search by Hashtag discovery into content data for the selected records.

Design note

I found that the dataset contract is centered on one record per ad, and the visible overview view combines advertiser, hashtag, copy, status, and link fields into a compact review table. That made it clear that the README should foreground ad-level records rather than campaign-level aggregates.

FAQ

Is this Actor for organic Facebook hashtag posts or ads?
It searches the Facebook (Meta) Ad Library by hashtag and returns matching ads.

What input fits the workflow if I have several research terms?
Pass a hashtag array. Each hashtag is searched independently and capped independently.

How do I narrow results to a market?
Use the country field with a two-letter ISO code such as US, GB, or DE.

How do I separate live ads from completed ads?
Use status: "ACTIVE", status: "INACTIVE", or status: "ALL".

How can I review creative formats only?
Set mediaType to IMAGE, VIDEO, MEME, or IMAGE_AND_MEME.

Can I connect this Actor to comment or reaction workflows?
Yes. When a returned record has a usable Facebook page or post reference, you can pass it into Facebook Post Comments Scraper or Facebook Likes Scraper - Public Reactions & Profiles for downstream engagement review.

Responsible use

This Actor works with Meta's public Ad Library and returns ad transparency data. Use the results in line with applicable laws, Meta's terms, and your own data governance requirements. When you share or store dataset items, treat disclosed ad data, URLs, and advertiser details as sourced records and preserve provenance through adLibraryUrl, provider, and scrapedAt.