SpyWinAds

Read a public Shopify product page and return its title, prices, variants and images, plus a download link to a Shopify-import CSV (valid 24 hours) and the product's video ads if the SpyWinAds library has them.

Counts for the signed-in user's SpyWinAds account: videos in each tab (Win, potential, scale, cash-cow, followed, testing, waiting for deep dig), videos found in the last 30 days, stores, and the latest keyword scan.

Status of the SpyWinAds desktop app on the user's computer: no_app (not installed / not paired), app_off (not seen for 5+ minutes), fb_paused (Facebook temporarily limited the home network, with the time scanning resumes), scanning or idle, plus jobs running and waiting. Scans only run while the app is open on the user's computer.

See the video ads a Facebook Page runs: total and live ads, videos, top videos with real age, and the stores the Page sends traffic to. Input: Facebook Page link or Page ID.

Videos one of the user's keyword scans found (50 per page, strongest first): same fields as spywin_list_my_videos plus the keyword and the tab the video is in, if any.

Progress of a keyword scan (scan_id from spywin_queue_keyword_scan / spywin_list_my_scans: per keyword queued, running, done, failed or expired — not picked up by the app within 15 minutes — and ads found) or of a Page / store / ad scan (request_id from spywin_queue_page_scan). Includes the app status. When a keyword scan is done, read the videos with spywin_get_scan_results; when a Page / store / ad scan is done, call its lookup tool again.

Night-by-night history (up to 30 days) of one video in the user's account: Pages running it (live), stores running it (live), Win / scale / old ad counts, total ads, landing pages, and what changed from the night before.

Headline numbers from SpyWinAds Research 'Video Reuse Index': how often Facebook video ads are old videos brought back, how many stores share a video, and how fast a video spreads to 5 stores. With method link.

The user's keyword scans in the last 30 days, newest first: scan id, start time (Vietnam time), first keyword, number of keywords, still running or done. Use the scan id with spywin_get_scan_results.

Stores running videos from the user's tabs: domain, platform, Pages, which tabs, ads seen, when the store was last scanned and new videos found then.

List the videos in one tab of the user's SpyWinAds account (only videos the user's own app found). Each video: product line from the ad, the day the video file first appeared on Facebook (or first ad if unknown), age in days, live ads, total ads seen, stores running it now, first ad date, landing page. Max 50 per call.

Check how old a Facebook video ad really is and which stores run the same video. Input: a Meta Ad Library link or ad ID, or a SpyWinAds video_id (from spywin_list_my_videos, spywin_get_scan_results or other tools). Returns the day the video file was first uploaded to Facebook (accurate to 1-2 days), the first ad date, live ads, how many stores run the same video now and ever, and the earliest stores in the SpyWinAds library.

Start Facebook Ad Library keyword scans on the user's own SpyWinAds desktop app (it scans from the user's home network). Up to 10 keywords per call, 30 new keywords a day. Keywords someone scanned fully in the last 24 hours return at once from the library (status cached). If the app is closed, not installed, or Facebook is pausing the home network, nothing is queued and the status says so (app_off, no_app, fb_paused) with the next step. Returns a scan_id for spywin_get_scan_status and spywin_get_scan_results.

When spywin_get_page_ads, spywin_spy_store_ads or spywin_lookup_video_ad say the library does not have it yet, ask the user's own SpyWinAds desktop app to scan it from the user's home network. kind: page (Facebook Page link or ID), store (domain), ad (Ad Library link or ad ID). Uses the plan's daily competitor-research limit. If the app is closed, not installed, or Facebook is pausing the home network, nothing is queued and the status says so. Returns a request_id for spywin_get_scan_status; when done, call the lookup tool again.

See the Facebook video ads a Shopify / online store is running. Input: the store domain. Returns live ads, new ads in 7 days, number of videos, products and Pages, and the top videos with their real age and how many stores run each one.