# Collect a brand’s social account. Know what is available to read Start from a brand and a platform, prove which account belongs to it, then collect only when needed. Your agent follows the provider job and reads the posts when they are available. - For: Brand, social and creative teams - Providers: 1 (Adspy.sh), 6 tools - Example (One TikTok brand lookup, up to three account searches and 20 posts from an already-collected account. New collection is a separate scenario below): at most $0.05, computed from the live catalog - Updated: 2026-10-24 ## One provider, the complete research job Adspy supplies this job's observations and research tools through one Agentik connection and one prepaid balance. - **Adspy.sh** (4 tools, at most $0.05): Observed public posts, reports and the source evidence for this research task. ## Give this to your agent ```text Use my connected Agentik MCP server for this job: collect a brand’s social account. Find the official account of my brand on the platform I choose. Ask for the website and profile if missing. Read account evidence and ask me to confirm a probable match. Use at most three account searches, respect retryAfterSeconds, stop when ready and tell me that every new search check can be billed. If a collection is needed, tell me its separate maximum and wait for approval. Poll its real job ID with the free status tool, respecting retryAt and pollAfterSeconds. Do not start a second collection to poll. Finish with its actual history coverage and up to 20 posts. An account ID permits post reads; offer a brand report only after a real brand key and association exist. Use these Agentik tools for the written steps: adspy/get-context, adspy/search-brands, adspy/search-social-accounts, adspy/request-social-fetch, adspy/get-fetch-job, adspy/list-social-posts. Reuse identifiers from actual earlier results, never the illustrative page inputs. Keep identity confirmation, a new collection's quote and its actual job status distinct. Do not invent a handle, move an account attached to another brand, or treat a waiting job as failed. Keep platform, period, observation dates, coverage, sample size, denominator, uncertainty and source links. Preserve the provider's no_clear_gap and insufficient-data conclusions. Do not infer spend, reach, conversions, ROAS or causal performance from public posts. Before running anything, inspect each tool with inspect_tool, ask me for any input you don’t have instead of inventing it, and tell me the total price. Wait for my go. At the end, tell me what Agentik charged. ``` ## You provide - Brand and website - TikTok, Instagram or YouTube - Exact profile link or handle if known ## Before this job - A brand name and platform; provide its website or exact profile when you know it. - Confirm a probable account before collection. Instagram collection supports professional accounts. ## What you get: a verified account, collection status and a first post sample - Account candidates and their identity evidence - A quoted collection only when needed - Progress, waiting state and the history actually obtained - A first sample of posts and the settled charge ## How to collect a brand’s organic social posts in Claude or ChatGPT Prices are the most each call can reserve for this example: One TikTok brand lookup, up to three account searches and 20 posts from an already-collected account. New collection is a separate scenario below. ### 1. Check the brand and available data Read the current coverage, resolve the brand and keep accounts known only through organic posts. Use the returned brand key and the platforms actually collected. - [Adspy.sh ad and organic coverage](/tools/adspy/get-context.md) `adspy/get-context` (Adspy.sh): free - [Find brands in Adspy.sh](/tools/adspy/search-brands.md) `adspy/search-brands` (Adspy.sh): at most $0.001 ### 2. Identify the account Use the platform's candidates and identity evidence. TikTok searching may need another billed check; stop after three searches. A probable Instagram account needs confirmation. - [Find a brand’s TikTok, Instagram or YouTube account](/tools/adspy/search-social-accounts.md) `adspy/search-social-accounts` (Adspy.sh, up to three search checks): at most $0.006 ### 3. Collect only if needed A known or in-progress account can be reused. Quote a new collection separately, then follow its real job ID. Waiting is a live state; do not relaunch it. - [Collect a brand’s organic social account](/tools/adspy/request-social-fetch.md) `adspy/request-social-fetch` (Adspy.sh, optional): at most $0.80 - [Adspy.sh brand or social collection progress](/tools/adspy/get-fetch-job.md) `adspy/get-fetch-job` (Adspy.sh, optional): free ### 4. Read the available posts Use the returned account or brand identity when the collected batch is ready. Keep partial history visible; completion does not promise exhaustive platform coverage. - [Adspy.sh organic brand posts](/tools/adspy/list-social-posts.md) `adspy/list-social-posts` (Adspy.sh): at most $0.04 Example total: at most $0.05. Each call is billed for measured usage; unused reservations are released. ## Alternative cost scenarios ### New account collection The example plus one new account collection. Its posts are included for the paying workspace for 30 days, tags included, so the settled amount can be below this summed reservation. At most $0.85, computed from the catalog's maximum reservations. ## Ask it your way - Keep the research to one platform and show the evidence behind each conclusion. - Explain what the available sample cannot establish. ## Why through Agentik - Use one Agentik connection and the existing prepaid balance. - Read the report and the posts behind it in the same conversation. - Inspect the tools, approve the quote and see the amount actually charged. ## Good to know - These are observed public posts. Missing counts stay unknown; rounded counts and incomplete history stay labelled. - TikTok and YouTube engagement is per view; Instagram engagement is per follower. Keep those bases separate. - Suspected paid-reach posts are shown separately and excluded from the organic figures as the provider reports them. - Post tags may come from video, a cover and caption, or a linked ad. Keep that provenance and do not invent a missing transcript. - Instagram may wait for provider capacity. Respect retryAt and assess isTerminal and isComplete rather than a processed percentage. - A TikTok search check can be billed even while searching. Progress reads are free. A known or pending collection does not incur a new collection charge. ## When to use something else For private reach, conversions or paid account performance, use your connected account's reporting tools. Public posts provide a different and incomplete set of observations. ## Collect a brand’s social account: questions ### What does the example cost? At most $0.05 for the example described. New account collection and any larger volume are quoted separately. You pay the settled usage; repeated or included items can cost less. ### Are AI tags billed separately? No. Available post tags are included with the post. A missing analysis stays missing, and a cover-based analysis is identified as such. ### Can the result prove business performance? No. Public engagement, posting activity and creative reuse are observed signals. They do not establish spend, conversions, profitability or causal lift. ## Keep going - [Organic social audit](/organic-social-audit.md): A brand’s posting cadence, formats and typical engagement, with platform-specific reports, uncertainty and the posts behind the findings. - [Organic social benchmark](/organic-social-benchmark.md): Two to five brands on one platform over the same period, with medians, intervals, sample sizes and the differences the data supports. - [Weekly brand social review](/weekly-brand-social-watch.md): A dated briefing of a brand’s latest collected social posts, with source links, observation dates and an honest account of what is fresh. - [Social tools for your agent](/tools/social.md) - [Advertising tools for your agent](/tools/advertising.md) [All playbooks](/playbooks.md) · [Connection guides](/docs/clients.md) · [Billing](/docs/billing.md) --- [HTML page](/collect-brand-social-account) · [Agent index](/llms.txt)