User Guide — Ads Library Hunter
Download extension
📘 User Guide

Hunt winning products in minutes

From installation to downloading your competitors' creatives — all in one easy-to-follow, step-by-step guide.

1 Install the extension

Ads Library Hunter installs in "Load unpacked" mode (not yet on the Chrome Web Store) — about 30 seconds.

1

Unzip the folder

Unzip AdsLibraryHunter.zip into a permanent folder (avoid Downloads, which is easy to clear).

2

Open the Extensions page

Type chrome://extensions into the Chrome address bar and press Enter.

3

Enable Developer mode

Toggle Developer mode in the top-right corner to ON.

4

Load unpacked

Click Load unpacked → select the folder you just unzipped → an orange magnifier icon appears in the toolbar.

5

Pin the icon

Click the puzzle-piece icon 🧩 → pin "Ads Library Hunter" so the button is always visible.

💡 TipWhenever there's a new update, go back to chrome://extensions and click Reload (🔄) on the extension card.

2 Open the panel

Click the orange magnifier icon in the toolbar. The extension automatically opens the Facebook Ads Library page and shows the control panel on the right side of the screen.

Why does it have to be on facebook.com?The panel is a content script that only runs inside the Facebook Ads Library — where it can call Facebook's internal API to scan. If you don't see the panel, make sure you're on facebook.com/ads/library.

Click the _ button in the panel corner to collapse/expand it. Choose your language (🇬🇧/🇻🇳/🇨🇳/🇪🇸) from the dropdown at the top of the panel.

3 Scan products

The heart of the tool. Enter keywords → choose countries → click Silent scan (API).

A

KeywordsEnter multiple keywords separated by commas — the tool scans them one at a time. Example: posture corrector, neck massager.

B

CountriesTwo-letter country codes separated by commas (US, GB, DE), or type ALL to scan globally.

C

PagesHow many API "pages" to scan (~30 ads each). Start with 20; raise it to dig deeper.

D

⚡ Silent scan (API)Scans quietly through Facebook's internal API — fast, no manual scrolling. The orange progress bar moves in real time.

E

ResultsEach row is a product with its score on the right. Click a row to open details, view & download the creative.

⚠️ Silent scan vs Scrape pageSilent scan (API) is the main method. If Facebook changes its API or results come back empty, use the Scrape page button to gather data directly from what's currently displayed — then scroll the page to collect more.

4 Filters & tuning

Turn on the filter "chips" to keep only the products worth your attention. An active chip turns cyan.

FilterMeaning & how to use it
Active onlyShow only ads that are currently running — hides paused ads. Almost always worth enabling.
Variations ≥Number of creative versions from the same advertiser. Many variations = they're scaling and testing hard → a winning signal. Set ≥ 3.
Days running ≥The longer an ad runs, the more likely it's profitable. Set ≥ 14 days to filter out new, unproven ads.
Score ≥Keep only products above a minimum score (see Scoring). Set ≥ 60 to focus on quality.
Exclude scanned pagesSkip pages you already saw in a previous scan — avoids duplicates when scanning many keywords.
💡 Recommended winning comboActive only + Variations ≥ 3 + Days running ≥ 14 + Score ≥ 70. This combo surfaces products the market has already validated.

5 Understand the score (Winning Score)

Each product is scored 0–100 based on signals like: number of creative variations, days running, active status, how many advertisers repeat it, and engagement metrics. The higher the score, the stronger the winning signal.

80–100 · Winning

Very strong signal. Green badge. Research & test these first.

60–79 · Promising

Worth watching. Gold badge. Review more angles/creatives before deciding.

< 60 · Weak

Weak signal or too new. Gray badge. Usually skip.

The score is a signal, not a promise.Always validate yourself by reviewing the creative, the price point, market saturation and supply before spending money.

6 Download video & content

Click a result row to open the details panel. From there you can:

  • Download the video / image creative at original resolution.
  • Copy the ad content (ad copy, headline) for angle reference.
  • View the destination landing page the competitor drives to.
  • See the number of variations and run time to gauge maturity.
💡 Research tipDownload the 3–5 top-scoring creatives of the same product to understand which angle they're testing — the fastest way to learn the sales formula that's working.

7 Spy on competitor targeting

Click the Group by competitor button (the people icon) to group results by each advertiser/page instead of by individual ad.

  • Instantly see which competitor is running the most ads for a niche.
  • Compare each page's average score — which page is the strongest.
  • Spot the big players to learn their creative strategy and scaling cadence.

8 Export CSV

Click Export CSV to download all results (name, score, variations, days running, links…) as a .csv file — open it in Excel / Google Sheets for deeper analysis, filtering and archiving.

9 Activate a license key

1

Open the key field

Click the 🔑 Enter key label at the top of the panel.

2

Paste & activate

Paste the license key you received → click Activate. The status changes to PRO.

3

Free trial

New users get a full 30-day trial of all features — no key required.

Need a key?Contact us on Telegram to buy or renew.

? FAQ & Troubleshooting

I clicked the icon but don't see the panel?
Make sure you're on facebook.com/ads/library and logged into Facebook. If you just updated, go to chrome://extensions, click Reload, then reopen it.
The silent scan returns empty results?
Facebook occasionally changes its internal API. Try again after a few seconds, lower the page count, or switch to the Scrape page button and scroll to gather data directly.
How many pages should I scan?
Start with 20. For large niches where you want to dig deep, gradually raise it to 30–50. Scanning too much at once can trigger a temporary Facebook rate limit — if so, take a few minutes' break.
Is my data sent anywhere?
Scan results and settings are stored locally in the browser (chrome.storage.local). The extension only contacts the server to validate a license key.
Is this extension affiliated with Meta/Facebook?
No. Ads Library Hunter is an independent tool, not affiliated with, sponsored by, or endorsed by Meta. "Facebook" and "Meta" are trademarks of Meta Platforms, Inc.

Ready to hunt winning products?

Install the extension, enter your first keyword and let the tool do the rest.

⚡ Download Ads Library Hunter — v1.0.0