Threads Ads Library Scraper | Meta Ad Creatives
Pricing
from $0.30 / 1,000 ad results
Go to Apify Store
Threads Ads Library Scraper | Meta Ad Creatives
Collect ads with Threads placements from the Meta Ad Library by keyword, country, status, media type, or Facebook advertiser page. Export ad copy, images, videos, CTAs, reported placements, and optional advertiser details to an Apify Dataset.
Pricing
from $0.30 / 1,000 ad results
Rating
0.0
(0)
Developer
DataScraperES
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
a day ago
Last modified
Categories
Share
Collect ads published on Threads from Meta Ads Library. Search a keyword or a Facebook advertiser page and export ad copy, media references, links and available advertiser information. Every delivered ad includes Threads among its reported placements.
What this Actor does
This Actor requests Threads placements and checks each returned record before delivering it. One Dataset row represents one unique Meta ad archive ID. It preserves the original snapshot and adds normalized creative text, titles, CTAs, image and video URLs, carousel cards and advertiser-page fields. Optional enrichment adds transparency information when Meta supplies it.
Use cases
- Research the advertising messages used by competitors on Threads.
- Collect image and video creative references by keyword and country.
- Compare advertisers' current ads and available transparency information.
How to use
- Enter a keyword such as
ikea, or choose a Facebook advertiser page. - Choose the country, status and maximum number of ads.
- Click Start and open the Dataset to download JSON, CSV or Excel.
This small input and the complete output below come from the same successful run:
Input
Provide at least one search target: query, pageId or pageUrl. Page targeting uses the Facebook advertiser page associated with the ads. Threads profile URLs are unsupported. The platform is fixed; an explicitly supplied publisherPlatforms field is rejected.
| Input | Default | Meaning |
|---|---|---|
query | empty | Brand, advertiser, product or phrase to search. |
pageId / pageUrl | empty | Numeric Facebook Page ID, public page URL or page alias as alternative targets. |
country | ES | Two-letter market code or ALL. |
activeStatus | ACTIVE | ACTIVE, INACTIVE or ALL. |
mediaType | ALL | IMAGE, VIDEO, NONE or ALL. |
adType | ALL | Supported employment, financial, housing or political category; availability depends on market. |
contentLanguages | empty | Select supported language codes; empty includes all languages. |
startDate / endDate | empty | Optional ad start-date boundaries in YYYY-MM-DD. |
maxAds | 100 | Maximum unique records, from 1 to 5,000. |
maxPages | 100 | Pagination safety limit, from one to five hundred pages. |
includeDetails | false | Request optional advertiser and transparency details. |
detailsLimit | 25 | Limit detail requests to 1 to 5,000 ads; failed or unavailable requests count toward this limit. |
Output
Results are stored in the Dataset. creative contains normalized copy, media URLs, CTA and landing link; snapshot preserves the original creative record. collection.publisherPlatforms records the fixed Threads filter. The full original publisher_platform list remains intact: a matching ad may also run on Facebook or Instagram. The Key-value Store run summary reports delivered counts, collection completeness and optional enrichment outcomes.
creative.videoUrls contains video file URLs. Video preview images remain available in creative.media, the original video records and snapshot.
This is the complete Dataset item from a real successful run:
Pricing
Pricing is pay per event. Each delivered ad creates an ad event and a creative_details event. A successfully returned optional enrichment also creates an advertiser_details event. The following USD amounts are equivalents per 1,000 events; billing applies to each event, without a 1,000-result minimum.
| Apify plan | Ad results | Creative details | Optional advertiser details | Ads with creative details |
|---|---|---|---|---|
| FREE | $0.40 | $0.10 | $0.40 | $0.50 |
| BRONZE | $0.36 | $0.09 | $0.36 | $0.45 |
| SILVER | $0.32 | $0.08 | $0.32 | $0.40 |
| GOLD | $0.30 | $0.075 | $0.30 | $0.375 |
| PLATINUM | $0.30 | $0.075 | $0.30 | $0.375 |
| DIAMOND | $0.30 | $0.075 | $0.30 | $0.375 |
For example, 1,000 delivered ads cost $0.50 on FREE; if all 1,000 also receive optional advertiser details, the event total is $0.90. Empty searches, discarded records, failed requests and unavailable details do not create these events. Check the Pricing tab for current amounts and the spending limit before running the Actor.
Related Actors
| Actor | Best for |
|---|---|
| Meta Ads Library Scraper | All Meta Platforms | Researching ads across multiple Meta platforms with a placement selector. |
| Google Ads Transparency Center Creative Scraper | Comparing Threads advertising with public Google advertiser creatives. |
| TikTok Commercial Content Library Ads Scraper | Comparing creative messages with ads from TikTok's Commercial Content Library. |
Limits and data quality
The Actor returns public records made available by Meta Ads Library. Coverage and available fields vary by advertiser, market and category. A placement match does not prove a unique Threads creative variant or provide separate performance metrics for that placement. Media links can expire. Historical ads are limited to what the source retains.
Reaching maxPages before the ad limit or source end produces incomplete collection. Temporary source restrictions, delivery failures or failed optional details can also leave an incomplete run; already delivered rows remain available. Compatible restarts preserve confirmed output. An incompatible or uncertain saved state stops rather than silently replacing existing data.
Frequently asked questions
Are the results exclusive to Threads?
Each delivered record includes Threads. Its original placement list can include other Meta platforms, and its creative is the source's shared ad record.
Can I supply a Threads profile URL?
Use a keyword or the advertiser's Facebook page ID, URL or alias. Threads profiles, posts and replies are outside this Actor's scope.
Does zero output always mean there are no matching ads?
A successful, complete empty search means the source returned no matches. A failed or partial run has not established complete coverage; inspect the run status and summary.
Responsible use
Use the data in accordance with applicable laws, source terms and privacy obligations. Public availability does not remove your responsibility for how you use or share the records.
Support
Open an issue in the Actor's Issues tab with the reproducible input and run ID.
For Python, JavaScript, cURL, and CSV examples, see the Threads Ads Library Scraper integration repository.
