# Your competitors’ ads and organic posts, in your AI.

Research public ads from Meta, Google and TikTok and organic posts from brands’ TikTok, Instagram and YouTube accounts. Read the evidence, compare brands and connect posts to the ads that reused them. No Adspy.sh subscription: each call is paid from your Agentik balance.

Updated: 2026-11-17. Source: [/adspy](/adspy).

## Coverage and evidence

- Public ads: Meta, including Facebook and Instagram; Google, including YouTube; and TikTok, for ads shown in Europe, the UK, Switzerland, Turkey and Brazil.
- Organic posts: brand accounts on TikTok, Instagram and YouTube. Instagram requires a professional account and may ask for an exact profile link.
- Engagement is per view on TikTok and YouTube and per follower on Instagram. Keep these denominators separate; unavailable public counts remain unknown.
- Reports retain sample sizes, observation dates, confidence intervals and coverage. Posts flagged as paid reach stay apart from the organic figures.

## Organic social workflow

### 1. Find the right account

Resolve the brand, inspect its collected platforms and check the account’s identity evidence. Confirm a probable match before collecting it.

`adspy/search-brands`, `adspy/search-social-accounts`.

### 2. Collect only when needed

Your agent quotes a new collection first. Already-collected accounts can be reused. A new job can wait its turn, particularly on Instagram; follow its status until it is ready.

`adspy/request-social-fetch`, `adspy/get-fetch-job`.

### 3. Read the posts and their evidence

Open posts, observed counts and available AI tags. Read breakouts against the account’s baseline, with paid-reach posts kept separate.

`adspy/list-social-posts`, `adspy/get-social-posts`.

### 4. Report, compare and trace reuse

Read the brand’s report, compare two to five brands on one platform or trace the posts later reused as Meta or Google ads. A match is evidence of reuse, not proof of profit.

`adspy/get-brand-social`, `adspy/compare-social`, `adspy/find-posts-run-as-ads`.

Follow the returned collection job rather than launching it again. A post list can use a returned accountId; brand reports and benchmarks require the real brandKey and its account association. A collection’s completion describes the batch obtained, not exhaustive platform coverage.

## Prices and settlement

$0.002 per Adspy.sh credit, billed from what Adspy.sh settles for each call. Ad and post AI analysis is included with its item. Reused items can settle at zero within their 30-day window; reports for the same brand and period are reusable for 24 hours. A new paid account collection includes its posts for the paying workspace for 30 days, tags included.

The maximum reservation and final charge are different. Account discovery costs per call, including repeated checks of a TikTok search. Fetch-job progress is free. Quote a new account collection and any additional search checks separately; respect the returned retry time.

## Tools

### Find

Brands and ads, by name, keyword, meaning, hook or resemblance.

- [`adspy/search-brands`](/providers/adspy/search-brands.md): Find brands by name, including brands known only from collected organic accounts, with their available platforms. $0.001 per call.
- [`adspy/find-brand-by-domain`](/providers/adspy/find-brand-by-domain.md): The brands in the Adspy.sh library whose ads land on a domain or one of its subdomains, with the brandKey every brand tool needs. Accepts a bare domain or a full URL. A brand whose ads land elsewhere cannot be found this way: also try adspy/search-brands with its name. Agentik price: $0.001 per call. $0.001 per call.
- [`adspy/search-advertisers`](/providers/adspy/search-advertisers.md): Look a brand up directly in Meta Ad Library, Google Ads Transparency or TikTok Ad Library, even before it is in the library. $0.002 per call.
- [`adspy/search-creatives`](/providers/adspy/search-creatives.md): Search ad copy, transcripts, visual analysis or hooks; filter by brand, platform, format, status, language, AI tag or days running; newest, oldest or longest running first. $0.002 per new result.
- `adspy/search-creatives-by-meaning`: not in this catalog; inspect current availability before execution.
- [`adspy/search-ad-hooks`](/providers/adspy/search-ad-hooks.md): Ad creatives whose analysed hook (type or description of the opening) contains a phrase: find who opens with a question, a discount or a named pain. The same records and filters as adspy/search-creatives, reading only this field, billed per new ad read. A creative with no hook analysis cannot match. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. Reserves up to $0.002 per result (at most 50), the unused part refunded. $0.002 per new result.
- [`adspy/search-ad-copy`](/providers/adspy/search-ad-copy.md): Ad creatives whose headline or written ad text contains a phrase, leaving out transcripts and AI analysis: exact wording of offers and claims as published. The same records and filters as adspy/search-creatives, reading only this field, billed per new ad read. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. Reserves up to $0.002 per result (at most 50), the unused part refunded. $0.002 per new result.
- [`adspy/search-ad-transcripts`](/providers/adspy/search-ad-transcripts.md): Ad creatives whose spoken transcript contains a phrase: find the claims, offers and words used in video ads, which ad copy search misses. The same records and filters as adspy/search-creatives, reading only this field, billed per new ad read. An image ad or a video with no stored transcript cannot match. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. Reserves up to $0.002 per result (at most 50), the unused part refunded. $0.002 per new result.
- [`adspy/list-new-creatives`](/providers/adspy/list-new-creatives.md): Ad creatives first seen on or after a date, newest first: a brand's new launches, several brands at once, or the whole library, with the same filters and records as adspy/search-creatives. Billed per new ad read. First seen is when the ad appeared in public libraries as Adspy.sh read them, not a launch confirmed by the brand. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. Reserves up to $0.002 per result (at most 50), the unused part refunded. $0.002 per new result.
- [`adspy/count-creatives`](/providers/adspy/count-creatives.md): How many unique ads in the Adspy.sh library match a phrase, per field (all, ad copy, transcript, visual analysis, keywords, hooks), with the same filters as adspy/search-creatives, at a flat price instead of per ad read. Tells whether a search is worth paging and which field holds the matches. A count that does not finish in time is null: unknown, never zero. Agentik price: $0.001 per call. $0.001 per call.
- [`adspy/find-similar-creatives`](/providers/adspy/find-similar-creatives.md): Ads that resemble one ad, ranked by the traits they share: tags, format and messaging. $0.002 per new result.
- [`adspy/find-same-media`](/providers/adspy/find-same-media.md): Every brand in the Adspy.sh library holding the exact same image or video (same file hash): first seen, status, days active and number of source ads for each. Shows reuse across brands, resellers and agencies. An edited or re-encoded version is a different file and is not listed: for look-alikes use adspy/find-similar-creatives. Says nothing about who made it first or about performance. Agentik price: $0.001 per call. $0.001 per call.

### Read

The whole creative: copy, media, dates, variants, transcript and AI analysis.

- [`adspy/get-creatives`](/providers/adspy/get-creatives.md): Full records of ads: copy, media, source variants, dates, days active, tags and transcript. $0.002 per new creative.
- [`adspy/get-creative-analysis`](/providers/adspy/get-creative-analysis.md): Adspy.sh’s AI reading of an ad: hook, message, visual and audio breakdown, and tags. $0.002 per new creative.

### Understand

A brand’s creative strategy, alone or side by side.

- [`adspy/get-brand-xray`](/providers/adspy/get-brand-xray.md): A brand’s creative strategy over 30, 90 or 180 days or all time: formats, platforms, hooks, messaging, funnel stages, recipes, evolution and longevity. $0.12 per call, at most.
- [`adspy/get-brand-full-analysis`](/providers/adspy/get-brand-full-analysis.md): One report on a brand's public ads and organic posts: activity by month, format mix, how long creatives keep running and which traits stay running at this brand, hooks, landing pages, each social account (cadence, engagement, breakouts, paid reach apart), posts later run as ads and the delay, offer pressure and pace, and how far the data can be trusted. Every finding carries its n, 95% interval and test with multiple-testing correction; a finding the data cannot support is listed as withheld with its reason. Free again for 24 hours for the same brand and range, and the brand's adspy/get-brand-social is then free for 24 hours too; a brand with nothing collected costs nothing. Public evidence only: never spend, ROAS, targeting or results. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.18; reserved before the call, the unused part refunded. $0.18 per call, at most.
- [`adspy/compare-brands`](/providers/adspy/compare-brands.md): Brand X-Rays of two to five brands over the same period, side by side. $0.12 per brand compared.
- [`adspy/get-followed-brands-report`](/providers/adspy/get-followed-brands-report.md): What changed at this workspace's followed brands over the last day, 7 days or 30 days: new creatives, ads launched and ended, and each brand's signals, with the method. A call covers at most 8 brands; offset continues. Observed public ads: never spend, reach or results. Follow brands with adspy/follow-brand first. Agentik price: $0.02 per call. $0.02 per call.
- [`adspy/get-brand-findings`](/providers/adspy/get-brand-findings.md): The headline reading of a brand's public ads over a range: active and inactive counts, the median days running and what stands out, each finding with sample creatives. The quick answer to what a brand is doing before opening a whole report. Observed public ads, never spend, ROAS or results. 10 credits; all sections of a brand and range never cost more together than its Brand X-Ray (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-brand-hooks`](/providers/adspy/get-brand-hooks.md): Which hook types a brand's public ads open with over a range, and the creative patterns they recur in, as counts over its analysed ads. For writing a brief or comparing openings. Observed public ads, never spend, ROAS or results. 10 credits; all sections of a brand and range never cost more together than its Brand X-Ray (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-brand-formats`](/providers/adspy/get-brand-formats.md): How a brand's public ads split between formats (image, video, carousel) and between Meta and Google over a range, as counts. Observed public ads, never spend, ROAS or results. 10 credits; all sections of a brand and range never cost more together than its Brand X-Ray (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-brand-messaging`](/providers/adspy/get-brand-messaging.md): How a brand's public ads split on each AI-tagged messaging dimension over a range (angle, emotion, offer style and the others), with how many ads each dimension covers. Observed public ads, never spend, ROAS or results. 10 credits; all sections of a brand and range never cost more together than its Brand X-Ray (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-brand-funnel`](/providers/adspy/get-brand-funnel.md): How many of a brand's public ads sit at each AI-tagged funnel stage over a range, and what their messaging looks like at that stage: where the brand puts its creative effort. AI tags, not measured conversions. Observed public ads, never spend, ROAS or results. 10 credits; all sections of a brand and range never cost more together than its Brand X-Ray (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-brand-longevity`](/providers/adspy/get-brand-longevity.md): The distribution of days a brand's public ads ran over a range: median, bands, how many are still active and how many have no duration, with the comparisons between groups of ads. For the tested traits that stay running, use adspy/get-brand-staying-power. Running time is not proof of results. Observed public ads, never spend, ROAS or results. 10 credits; all sections of a brand and range never cost more together than its Brand X-Ray (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-brand-recipes`](/providers/adspy/get-brand-recipes.md): The combinations a brand repeats across its public ads over a range: recurring sequences of creative steps and pairs of traits that appear together, with their counts. For briefing a new ad on the brand's own structure. Observed public ads, never spend, ROAS or results. 10 credits; all sections of a brand and range never cost more together than its Brand X-Ray (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-brand-evolution`](/providers/adspy/get-brand-evolution.md): New public ads per month over a range and how the format mix moved each month, with the activity signals. For seeing when a brand pushed and what it switched to. Observed public ads, never spend, ROAS or results. 10 credits; all sections of a brand and range never cost more together than its Brand X-Ray (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-brand-shifts`](/providers/adspy/get-brand-shifts.md): The creative traits that rose or fell between a brand's recent ads and the period before, each with both counts, the change and sample creatives. The direct answer to what the brand changed lately. Observed public ads, never spend, ROAS or results. 10 credits; all sections of a brand and range never cost more together than its Brand X-Ray (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-brand-audience-signals`](/providers/adspy/get-brand-audience-signals.md): Age and gender estimates for a brand's public ads as AI reads them, kept apart from the audience distributions a provider publishes where it does (with how many variants they cover). Signals only: never targeting, reach or buyers. 10 credits; all sections of a brand and range never cost more together than its Brand X-Ray (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-brand-landing-pages`](/providers/adspy/get-brand-landing-pages.md): The landing pages a brand's public ads link to over a range, with how many ads use each, their call to action and sample creatives. For mapping its offers and funnels. Traffic and conversions are not known. 10 credits; all sections of a brand and range never cost more together than its Brand X-Ray (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-brand-organic-to-paid`](/providers/adspy/get-brand-organic-to-paid.md): Whether a brand turns its organic posts into ads: the tested share of posts run as ads with its 95% interval, the delay from post to ad, ads seen first, new videos that came from posts, how long those ads ran and which breakouts were reused, with the pairs. Findings the data cannot support are listed as withheld. 15 credits; all sections of a brand and range never cost more together than its Brand Full Analysis (90 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.03; reserved before the call, the unused part refunded. $0.03 per call, at most.
- [`adspy/get-brand-rhythm`](/providers/adspy/get-brand-rhythm.md): Whether a brand launches ads in waves, its new creatives per week over the last 13 weeks and how the last 30 days compare with the 60 days before (exact Poisson rate ratio), as findings with n and intervals. Findings the data cannot support are listed as withheld. Public evidence only, never budgets. 15 credits; all sections of a brand and range never cost more together than its Brand Full Analysis (90 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.03; reserved before the call, the unused part refunded. $0.03 per call, at most.
- [`adspy/get-brand-staying-power`](/providers/adspy/get-brand-staying-power.md): Which traits of a brand's ads keep running longer at this brand, compared in tests with n, 95% intervals and multiple-testing correction, with what is live now. Goes beyond adspy/get-brand-longevity's distribution. Longer running is not proof of results. 15 credits; all sections of a brand and range never cost more together than its Brand Full Analysis (90 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.03; reserved before the call, the unused part refunded. $0.03 per call, at most.
- [`adspy/get-brand-offer-pressure`](/providers/adspy/get-brand-offer-pressure.md): Whether a brand is pushing offers harder: the share of its new creatives tagged with an offer in the last 30 days against the 60 days before, with Fisher's exact test and the counts. Findings the data cannot support are listed as withheld. AI tags on public ads, never sales. 15 credits; all sections of a brand and range never cost more together than its Brand Full Analysis (90 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.03; reserved before the call, the unused part refunded. $0.03 per call, at most.
- [`adspy/get-brand-mix-changes`](/providers/adspy/get-brand-mix-changes.md): Which shifts in a brand's ad mix are statistically supported, with n, intervals and the test, and which are noise. For the raw before and after counts, use adspy/get-brand-shifts. Public evidence only. 15 credits; all sections of a brand and range never cost more together than its Brand Full Analysis (90 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.03; reserved before the call, the unused part refunded. $0.03 per call, at most.
- [`adspy/get-brand-organic-verdicts`](/providers/adspy/get-brand-organic-verdicts.md): The tested findings on a brand's organic posts across its accounts, with n, intervals and what was withheld, as sentences and numbers. The per-platform blocks are in the adspy/get-social- sections. Public posts only, never reach or conversions. 15 credits; all sections of a brand and range never cost more together than its Brand Full Analysis (90 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.03; reserved before the call, the unused part refunded. $0.03 per call, at most.

### Add a brand

A brand the library does not have yet, from Meta Ad Library or Google Ads Transparency.

- [`adspy/request-brand-fetch`](/providers/adspy/request-brand-fetch.md): Add a brand from its Meta Ad Library or Google Ads Transparency page: Adspy.sh collects, analyses, tags and transcribes its ads. $0.80 per call, at most.
- [`adspy/get-fetch-job`](/providers/adspy/get-fetch-job.md): The progress of a brand fetch or a social account collection, until it is ready to read. Free no charge.

### Organic posts

What a brand posts on its own social accounts, kept apart from its ads.

- [`adspy/search-social-accounts`](/providers/adspy/search-social-accounts.md): Find a brand’s TikTok, Instagram or YouTube account with identity evidence. Each search check is a priced call, including a repeated TikTok search. $0.002 per call.
- [`adspy/request-social-fetch`](/providers/adspy/request-social-fetch.md): Collect a brand account’s posts, aiming for the last twelve months. Already-collected or pending accounts are reused; Instagram collection may wait its turn. $0.80 per call, at most.
- [`adspy/list-social-posts`](/providers/adspy/list-social-posts.md): Organic posts and available public counts: newest, engagement or breakouts first, with each platform’s engagement basis and paid reach kept visible. $0.002 per new result.
- [`adspy/get-social-posts`](/providers/adspy/get-social-posts.md): Post details, available count snapshots, matched ads and AI tags on request. Tags are included; their video, cover or linked-ad provenance stays explicit. $0.002 per new post.
- [`adspy/find-posts-run-as-ads`](/providers/adspy/find-posts-run-as-ads.md): Organic posts the brand later reused as ads, with the delay and how long each ad ran. $0.002 per new result.
- [`adspy/get-brand-social`](/providers/adspy/get-brand-social.md): A brand’s organic activity over 30 or 90 days: engagement, views, cadence, formats and breakouts, with intervals. $0.12 per call, at most.
- [`adspy/compare-social`](/providers/adspy/compare-social.md): Two to five brands’ organic posts side by side, with verdicts, sample sizes and confidence intervals. $0.12 per brand compared.
- [`adspy/get-social-engagement`](/providers/adspy/get-social-engagement.md): Engagement and views of a brand's organic posts per platform over 30 or 90 days, medians with 95% CIs. Per view on TikTok and YouTube, per follower on Instagram: never compare them. Paid-reach posts are left out. 10 credits; all sections of a brand and range never cost more together than its social report (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-social-cadence`](/providers/adspy/get-social-cadence.md): A brand's posting cadence per platform over 30 or 90 days and how it changed. Observed public posts. 10 credits; all sections of a brand and range never cost more together than its social report (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-social-formats`](/providers/adspy/get-social-formats.md): The formats of a brand's organic posts per platform over 30 or 90 days, with their counts. Observed public posts. 10 credits; all sections of a brand and range never cost more together than its social report (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-social-breakouts`](/providers/adspy/get-social-breakouts.md): A brand's organic posts that broke out of their usual range per platform over 30 or 90 days, with the rule used, how many were evaluated and the posts listed. Paid-reach posts are kept apart. 10 credits; all sections of a brand and range never cost more together than its social report (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.
- [`adspy/get-social-paid-reach`](/providers/adspy/get-social-paid-reach.md): A brand's posts whose reach looks paid, per platform over 30 or 90 days: the count, the share with its 95% interval, the rule used and the posts, plus posts marked as promoted. A likely signal from public numbers, never confirmed spend. 10 credits; all sections of a brand and range never cost more together than its social report (60 credits) over 24 hours, and cost nothing while that report is held. A section with nothing to show is free. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per new creative, post or post-ad pair, its AI analysis included, 60 per X-Ray or social report, 400 per new brand fetch or account collection); items this workspace read in the last 30 days, reports from the last 24 hours, reused fetches and missing items cost nothing. At most $0.02; reserved before the call, the unused part refunded. $0.02 per call, at most.

### Keep

Collections, notes and followed brands in your own private workspace.

- [`adspy/follow-brand`](/providers/adspy/follow-brand.md): Follow a brand; its already-collected social accounts are read more often within each platform’s limits. Following does not schedule an Agentik report. Free no charge.
- [`adspy/unfollow-brand`](/providers/adspy/unfollow-brand.md): Stop following a brand in this workspace. Its ads and posts stay in the library; Adspy.sh only stops reading its accounts more often for this workspace. A brand that was not followed changes nothing. Agentik price: free. Free no charge.
- [`adspy/list-followed-brands`](/providers/adspy/list-followed-brands.md): The brands followed in this workspace, newest first, with their names and ad platforms. A brand Adspy.sh no longer knows keeps its brandKey with a null name. Agentik price: free. Free no charge.
- [`adspy/save-creatives`](/providers/adspy/save-creatives.md): Save ads to a new or existing collection. Saving twice is harmless. Free no charge.
- [`adspy/remove-creatives`](/providers/adspy/remove-creatives.md): Take creatives out of a saved collection, by hash. Their notes in this collection go with them; the creatives stay in the library. A hash that is not in the collection comes back under notInCollection. Agentik price: free. Free no charge.
- [`adspy/update-note`](/providers/adspy/update-note.md): Write your note on a saved ad. Free no charge.
- [`adspy/list-collections`](/providers/adspy/list-collections.md): Your collections, with their names, descriptions and counts. Free no charge.
- [`adspy/get-collection`](/providers/adspy/get-collection.md): A collection’s ads and notes, with each ad’s full record on request. $0.002 per result, with expand.
- [`adspy/update-collection`](/providers/adspy/update-collection.md): Change a saved collection's name, its description or both. Its creatives and notes are unchanged. Agentik price: free. Free no charge.
- [`adspy/delete-collection`](/providers/adspy/delete-collection.md): Delete a saved collection for this whole workspace: its list of creatives and their notes are gone for good. The creatives stay in the library. Confirm with the user first. Agentik price: free. Free no charge.

### Housekeeping

Coverage, availability and fresh media links.

- [`adspy/get-context`](/providers/adspy/get-context.md): Current ad and organic coverage, and whether collecting a brand or social account is available. Free no charge.
- [`adspy/get-brand-freshness`](/providers/adspy/get-brand-freshness.md): When a brand's newest ad was first seen, when its ads were last collected and how confident that collection was, and when each TikTok, YouTube or Instagram account was last read, to judge a report before paying for it. Unknown dates are null, never today. Counts describe the observed library, not the advertiser's whole activity. Agentik price: $0.001 per call. $0.001 per call.
- [`adspy/list-creative-tags`](/providers/adspy/list-creative-tags.md): The tags adspy/search-creatives filters on, by category (asset type, visual format, messaging angle, hook tactic and more), with what each category means. Tags read dimension:value and match exactly and case-sensitively, so copy them as listed. Stored tags can hold more values than these, and a listed value is not proof that any ad carries it. Agentik price: free. Free no charge.
- [`adspy/list-playbooks`](/providers/adspy/list-playbooks.md): Ready research jobs on ads and organic posts, grouped by goal: read a competitor's ad strategy, find the hooks that keep running, build a swipe file, write a brief from real ads, watch a competitor, compare brands, spot posts run as ads, scan a category. Each one gives its outcome, its steps in plain words and a ready prompt; pass brand to fill the prompts. Reads no ad data and bills nothing. Prices are not listed here: each step is billed at its tool's own price. Agentik price: free. Free no charge.
- [`adspy/renew-delivery-links`](/providers/adspy/renew-delivery-links.md): Fresh media links for an earlier result; links last 21 days. Free no charge.

## Example requests and reservation maxima

These are bounded examples, not executed results or a universal total for uncollected accounts. Your agent inspects each tool, asks for missing inputs and spending authority, and reports the final charge.

### A brand’s organic activity

“Audit Competitor A’s collected organic accounts over 90 days. Keep each platform’s engagement basis, sample and uncertainty visible.”

Tools: `adspy/search-brands`, `adspy/get-brand-social`.

Example reservation maximum: $0.121. For an already-collected brand. The same brand and period report is reusable for 24 hours; a new collection is quoted separately.

### Three brands on one platform

“Compare these three collected brands on TikTok over 90 days. Show sample sizes, confidence intervals and any comparison without a clear difference.”

Tools: `adspy/search-brands` ×3, `adspy/compare-social`.

Example reservation maximum: $0.363. One platform and a common period. A previously browsed post does not by itself make its brand’s report free.

### The posts they reused as ads

“Find up to 20 of Competitor A’s organic posts that later ran as ads. Show the match, delay and available pre-ad counts.”

Tools: `adspy/search-brands`, `adspy/find-posts-run-as-ads`.

Example reservation maximum: $0.041. Matched ads come from Meta and Google. No match means none was found in the available library, not that the brand never advertised.

### Collect an exact profile

“Collect this brand’s exact Instagram professional profile after showing its identity evidence and price, then follow the job until it is ready.”

Tools: `adspy/search-brands`, `adspy/request-social-fetch`, `adspy/get-fetch-job`.

Example reservation maximum: $0.801. This example uses a profile supplied by you. Discovery is extra if needed; every TikTok search check is priced. A new paid collection includes its posts for the paying workspace for 30 days, AI tags included.

### Your Monday competitor check

“What new ads did my three main competitors start this week? Follow them for me.”

Tools: `adspy/search-brands` ×3, `adspy/follow-brand` ×3, `adspy/search-creatives`.

Example reservation maximum: $0.103. Next week, ads you already pulled in the last 30 days cost nothing.

### The ads they keep running

“Show me the ads Competitor A has kept running the longest, then break down the hooks of the top five.”

Tools: `adspy/search-creatives`, `adspy/get-creative-analysis`.

Example reservation maximum: $0.05. Running time is a public signal, not proof of profit.

### A brand’s strategy in one call

“X-Ray Competitor A over the last 90 days: formats, hooks, funnel stages and what changed.”

Tools: `adspy/search-brands`, `adspy/get-brand-xray`.

Example reservation maximum: $0.121. The same X-Ray is free again for 24 hours.

### Your category, side by side

“Compare the creative strategies of these four brands over 90 days and tell me where we stand out.”

Tools: `adspy/search-brands` ×4, `adspy/compare-brands`.

Example reservation maximum: $0.484. Reused and included items may settle for less.

### A hook library in a minute

“Find 30 video ad hooks in skincare that have run for over 30 days and save them to a collection called Hooks.”

Tools: `adspy/search-creatives`, `adspy/save-creatives`.

Example reservation maximum: $0.06. Reused and included items may settle for less.

### Look-alikes of an ad you love

“Find 20 ads similar to this one and tell me what the best of them have in common.”

Tools: `adspy/find-similar-creatives`, `adspy/get-creative-analysis`.

Example reservation maximum: $0.05. Reused and included items may settle for less.

### Transcripts for your next script

“Pull the transcripts of the 10 longest-running video ads for protein powder and outline their structure.”

Tools: `adspy/search-creatives`.

Example reservation maximum: $0.02. Results already carry each ad’s transcript when there is one.

### A brand the library doesn’t have yet

“Add Competitor B from its Meta Ad Library page and tell me when its ads are ready to read.”

Tools: `adspy/search-advertisers`, `adspy/request-brand-fetch`, `adspy/get-fetch-job`, `adspy/search-creatives`.

Example reservation maximum: $0.842. A brand already in the library, or already being fetched, costs nothing to add.

## Adspy.sh playbooks

- [Collect a brand’s social account](/collect-brand-social-account.md): Identify the account, follow its collection and report the history actually obtained.
- [Audit a brand’s organic content](/organic-social-audit.md): Cadence, formats, engagement and cited posts, with each platform’s coverage.
- [Explain breakout posts](/organic-breakout-analysis.md): Read the posts above a brand’s baseline, with paid reach and uncertainty kept visible.
- [Compare brands on one platform](/organic-social-benchmark.md): Compare two to five brands over the same period, with sample sizes and intervals.
- [Find posts reused as ads](/organic-posts-run-as-ads.md): See post/ad pairs, match evidence, timing and available counts from before the ad.
- [Read paid and organic strategy](/paid-organic-brand-strategy.md): Combine the public-ad X-Ray and social report without mixing their metrics.
- [Review the latest social posts](/weekly-brand-social-watch.md): A dated brand briefing to request again when needed, with actual freshness and coverage.
- [Build a brief from real posts](/evidence-based-social-brief.md): Turn cited posts and relevant ad examples into a creative brief and test ideas.

## Questions

### Do I need an Adspy.sh subscription?

No. Your agent calls Adspy.sh through Agentik and each call is paid from your Agentik balance. There is no Adspy account, plan or key to manage.

### Is it really only on Agentik?

Yes. Agentik is the only place your agent can use Adspy.sh’s research pay per call, without an Adspy.sh plan. Adspy.sh’s own website subscriptions stay on adspy.sh.

### Which ads does it cover?

Public ads from Meta (Facebook and Instagram), Google’s Ads Transparency Center, YouTube included, and TikTok’s ad library for ads shown in Europe, the UK, Switzerland, Turkey and Brazil, with observed ads kept after they end. Its other TikTok tools read organic brand posts.

### Which organic accounts does it cover?

Brand accounts on TikTok, YouTube and Instagram. Instagram requires a professional account. An account is marked official only when the available evidence supports it; confirm a probable match before collection. Your agent asks for an exact profile link when needed.

### Is a new social collection instant?

It starts a job after your approval and price check. Already-collected or pending accounts are reused. A new collection aims for twelve months of history, without promising completeness. Instagram can wait its turn: your agent follows the job’s returned status and retry time instead of starting a second collection.

### Can I compare engagement across platforms?

Keep the platforms separate. Engagement is per view on TikTok and YouTube and per follower on Instagram. Comparisons use one platform and the same period, with sample sizes and confidence intervals. Unavailable counts stay unknown, and paid-reach posts remain separate from organic figures.

### Does a TikTok account search retry cost anything?

Yes. Each account-search call has its own published price, including a check of a TikTok search still in progress. Your agent waits for the returned delay and limits further checks. Fetch-job progress is a separate free tool.

### Does it show competitors’ spend or ROAS?

No. Spend, conversions and ROAS stay in each advertiser’s own account. Adspy.sh shows what is observable: the creatives, their dates and running time, formats, hooks, messaging and the patterns across a brand.

### Do I pay twice for the same ad or post?

An ad, post or post/ad pair already opened by your workspace in the last 30 days is reusable. AI analysis and tags come with their item. A new paid social collection includes that account’s posts for the paying workspace for 30 days. Reports for the same brand and period are reusable for 24 hours. Your agent sees the maximum reservation first; Agentik bills what Adspy.sh settles.

### Is my research private?

Yes. Each Agentik workspace gets its own isolated Adspy.sh workspace: collections, notes, follows and fetch jobs are never shared with anyone else.

### Does the $2 free credit cover it?

It covers low-cost calls such as brand searches, ad searches and AI analyses. Calls that can cost more, like Brand X-Ray, comparisons and new brands, need paid credit. Your first top-up of $10 or less has no platform fee.

### Which AI apps can use it?

Claude (desktop, web and Claude Code), ChatGPT through a custom app, Codex, Cursor and any app that supports remote MCP. Connect Agentik once and the Adspy.sh tools are there, starred in your catalog.

## Next steps

- [Connect Agentik](/connect.md).
- [Adspy.sh provider and exact tool contracts](/providers/adspy.md).
- [Public social data guide](/ai-agent-social-media-data.md).
- [All playbooks](/playbooks.md).
- [Adspy.sh](https://www.adspy.sh/).

Agentik’s partner tools do not include Adspy.sh’s native Brand Full Analysis or research exports. The console prepares prompts; it does not run provider tools. A weekly playbook is a request to rerun, not an Agentik scheduler or notification subscription.


---

[HTML page](/adspy) · [Agent index](/llms.txt)
