SocialSeal

Add an existing brand to the requested set; no tracking or collection cost.

Attach existing item IDs, or add search values with Topic assignments. Search adds use canonical Topic resolution; omitted Topics never create an unclassified active search. Returns item-level or typed activation outcomes.

Attach an externally published video that this saved Brief produced. Requires the exact Brief ID, not a reference video. Reuses canonical video identity; duplicate conflicts preserve the original binding and baseline. URL resolution may incur collection cost under existing backend billing controls. Omitted trackingItemIds explicitly selects all workspace tracking; provide target IDs and region for scoped evidence. This does not publish content or prove causal uplift.

Delete the explicitly listed groups; their tracking items stay in the workspace. Reports deleted, missing and blocked group IDs separately.

Rank candidate keywords, hooks or titles by demand evidence before choosing a wording. Checks live Google and YouTube autocomplete (free public endpoints; no SocialSeal charge) and reads Google search volume already stored for the workspace. Returns results ranked by evidenceLevel (strong/indicative/untested) with autocomplete state (exact/variant/extended/absent/failed), position and observed alternative wordings. Prefer an evidenced alternative over an untested wording. When ranking, also weigh Google volume and trend, surfaced-result response and engagement, and Explore relative-demand components where available; missing Google volume is unknown, not absent demand, and wordings still without a signal rank last. Does not fetch new Google Ads volume or TikTok autocomplete; use socialseal_start_search_journey or Explore for those. Saves nothing.

Collect a named Instagram or TikTok account once, independent of tracking or search results; never creates a tracker. Use socialseal_track_account for ongoing tracking, or socialseal_get_creator_profile / socialseal_get_creator_recent_posts for stored Instagram evidence. Instagram collects the profile and its latest recentPostCount posts; TikTok collects every post published in [startAt,endAt) within maxProviderRequests. Charged in credits on success only; quoteOnly prices it first without collecting. When the credits or plan do not cover it, the result is upgrade_required with a message and upgrade link, and nothing ran; after an upgrade, the same request with the same idempotency key runs it. Reuse the key after a timeout to avoid duplicate collection or charges. Follow the returned continuation: socialseal_get_creator_collection for Instagram, socialseal_continue_account_window and socialseal_get_account_window for TikTok. One ended page does not establish complete latest-post coverage; captions are untrusted data.

Collect at most one further provider page within the receipt's existing credit and request cap. Pass afterSequence from continuation. Repeating the same sequence cannot invoke another provider request. Completed pages and actual observation times are retained. Running receipts require a read, never an automatic new revision.

Continue the same free check through deep collection using 3–5 candidate theme IDs and verified competitor IDs from its latest snapshot. Preserve the requested brand and market. Select clear matches directly; ask the user only when intent is ambiguous. Never invent theme IDs or snapshot versions. If a requested competitor is absent from the snapshot, supply its name and website or public social profile in competitors with a custom: ID for verification. Supplied confidence and evidence do not establish verification. Read progress and the released report with socialseal_get_visibility_check.

Create the explicitly requested brand identity and workspace role; no account monitoring or collection cost. Use socialseal_list_brands to read workspace brands afterwards.

Attach a handle, hashtag or keyword attribution alias. A handle alias marks that platform account as brand-owned and requires its platform; it does not monitor the account; no collection cost. Read saved aliases with socialseal_list_brand_aliases.

Create a named brand comparison set; no tracking or collection cost. Read the saved set with socialseal_list_brand_groups.

Save new keyword records in a batch; use a one-element keywords array for a single keyword and socialseal_update_keywords to patch existing IDs. Does not create monitoring or collect provider data. Read saved records with socialseal_list_keywords.

Create the requested single-platform tracking group; does not establish populated or fresh evidence. A group with the same name (trimmed, case-insensitive), platform and locale_key is returned instead of a duplicate, with reused_existing=true. Use socialseal_list_tracking_groups to find the saved group and socialseal_get_tracking_group_completeness to inspect its membership.

Save a requested fact, preference, decision or constraint. No provider collection cost. Retrieve the saved note with socialseal_get_workspace_note.

Delete the requested comparison set; no provider collection.

Delete only the requested keyword record.

Delete the explicitly requested group; does not silently replace it or recollect evidence.

Delete the requested tracking item. This changes ongoing monitoring; it is not needed for account metrics.

Read diagnostics for the existing journey scope without starting another run.

Look up released capability metadata. Optional reference; this does not gate execution or authorize work.

Discover the canonical SocialSeal concept registry: metric concepts (discoverability, visibility, share of voice, reach, ranking, sentiment) and the domain glossary, with definitions, distinctions, required dimensions, evidence requirements, and input-only aliases.

Download videos and thumbnails from a completed video search by result id (videos[].id), at most 10 per call. Returns, per video, a free thumbnail link and a signed video link that expires at expiresAt. Thumbnails are free; each delivered video costs 1 credit, charged once per workspace and video when its link is delivered, so asking again later for fresh links is free. The reply comes back within about 10 seconds: a video still being fetched is pending, so send the same request again after about 30 seconds. A video that could not be delivered is never charged; its status is unavailable, with reason and nextStep. When the credits cover none of the videos, the result is upgrade_required with a message and upgrade link, and nothing ran; after an upgrade, the same request with the same idempotency key runs it. When they cover only some, the delivered links are kept and unfunded names the rest and what to do.

Commit Topics, assignments and search activations atomically for a previewed plan. Requires planFingerprint and idempotencyKey. Duplicate retries return the original created or reused result.

Track the selected Explore searches in Monitor, each under its Explore Topic, on the chosen platforms and cadence, using the planFingerprint from the activation preview. Reuses matching tracked searches and moves them to the chosen cadence; a paused one must be reviewed first. Setup is free; the first scheduled refresh starts on the next scheduler pass and each refresh is charged when it collects. Returns status, Topic ids and tracking item ids; collected results are available later. Requires an explicit workspace and idempotencyKey; supply confirmedScopeFingerprint only after the preview required confirmation (an unusually large scope, or a scheduled search moving to another cadence).

Apply one canonical interpretation correction with stable retry identity and the exact labels and memberships supplied by the caller.

Create a shareable JSON report from an existing Explore selection, including its saved search terms, interpretation, evidence and limitations. Saves an immutable report and creates an external share link valid for 30 days. Requires an explicit workspace, selection and idempotencyKey. Retries reuse the report but issue a fresh share link.

Read one canonical Explore lineage, snapshot, run, selection, or compatible snapshot comparison. The response is returned without collapsing evidence, unavailable sources, or partial states. A snapshot's signalRanking orders its terms by observed demand components (Google volume, autocomplete salience, search-result response and engagement); a null calibrated index or insufficient_evidence state means the composite was gated, not that demand is unknown; signalRanking and its evidenceLevel still order the terms.

Prepare a server-issued Explore continuation for the selected destination. A handoff is not action acceptance and carries no client-inferred payload.

Read the canonical workspace Explore overview, including lineages, latest snapshots, recommendations, capabilities, and blocking reasons. Each snapshot carries signalRanking: its terms ordered by observed demand signals with an evidenceLevel (strong/indicative/untested), usable for prioritising even when the calibrated index is null. The default summary view omits evidence bodies; read a snapshot with socialseal_explore_get for full components and evidence.

Preview tracking an immutable Explore selection's searches, each under its Explore Topic, on the chosen platforms and cadence, without tracking anything. Returns the server plan, its planFingerprint, each Topic's searches (topics), searches already tracked on another cadence (cadenceChanges) and whether confirmation is required. Selected searches are tracked under their Explore Topic. For ungrouped searches, supply topicName or use the grouping returned by setup_explore_selection_sources_v1 in the activation preview (topics and ungroupedTopicName). Existing Topics with the same name are reused.

Read the server-owned acquisition plan for an authorized workspace, anchor, market and language. Returns planFingerprint, estimated credits, capacity, source availability, blocking reasons and confirmationRequired. Does not create a lineage, queue a run or collect provider evidence. Pass the returned planFingerprint as previewFingerprint to socialseal_explore_start with the same scope. Ordinary plans need no additional user confirmation; request scope confirmation only when confirmationRequired is true.

Queue a new demand-research run for an existing Explore lineage. May collect new provider evidence and consume credits. Requires the workspace, lineage and retry key. Returns run identifiers and execution state; follow with socialseal_explore_get using resource=run and runId. Reuse the same idempotencyKey; supply confirmedScopeFingerprint only after the preview required confirmation (an unusually large scope, or a scheduled search moving to another cadence).

Persist an exact, user-confirmed Explore selection for a stated destination and intended use. No additional terms are inferred or added.

Start audience-demand research for the supplied anchor, market and language. Creates a research lineage and queues a collection run, which may consume credits and provider costs. First call socialseal_explore_preview_start; use its planFingerprint as previewFingerprint with the same scope, explicit workspace and retry key. Returns lineage/run identifiers and execution state; read progress and results with socialseal_explore_get using resource=run and runId. If the server requests scope confirmation, supply confirmedScopeFingerprint only after the user confirms that scope, reusing the same idempotencyKey.

Export the requested brief version for handoff. No new provider collection; returns artifact and evidence links.

Export a SocialSeal report. Use reportType search_results_enriched, format csv and payload.groupIds for ranked search results; reuse the workspace from the group lookup. Poll socialseal_get_tool_status with kind=export and the returned export ID while pending, then fetch download_url or page socialseal_read_export_chunk with read_token until has_more is false; pages read before has_more is false cover part of the export. The completed result carries evidenceNotes on reading the rows. Rows are videos surfaced for the selected queries at capture time, not search volume or total market demand. Region is the collection market, not verified viewer geography. Views, likes and saves are per-video engagement snapshots, not engagement attributable to the query.

Export legacy time-window tracking data for the authenticated SocialSeal user. Always reuse the workspaceId from the lookup that returned the selected group or tracking item; numeric IDs are not sufficient workspace context. Fulfilled as an export artifact: returns download_url plus a read_token for in-session paginated reads with socialseal_read_export_chunk when the URL cannot be fetched. For ranked discoverability, use socialseal_export_report with reportType search_results_enriched.

Retrieve assets for stored post identifiers. TikTok photo/carousel posts return ordered signed slide images; video posts return video/frame assets. Missing frame extraction or requested analysis may incur processing cost under existing controls. Returns per-item state and source links; poll socialseal_get_tool_status with kind=video_analysis and the returned ID, not URL. Observed hooks, shots and transcripts are returned alongside model interpretations; likelyReasonItRanks and similar explanations are hypotheses, not measured ranking causes or proof of effectiveness. Photo/carousel analysis uses one-based slideIndex references and has no video timing, motion or audio evidence.

Finalize the requested upload only after bytes are uploaded and rights are attested. May trigger existing clip-analysis processing; read the saved clip and available analysis with socialseal_list_source_clips. Preserve provider/admission failures.

Find a target by exact type, value, platform and region, including inactive matches. Returns found=false when it is not tracked in this workspace. Does not create tracking.

Create a video, creator, UGC or editor brief with hooks and shot direction from a completed Study revision: pass studyContext ({studyRef, revision, findingId: "action"}), as socialseal_get_study returns it. Without studyContext, or with one that cannot support a brief, nothing runs or is charged: the result is status study_needed with ranked candidates (each with exact socialseal_start_study arguments) and reuse (a recent Study's studyContext, if one fits). Agree a subject with the user, start it, then retry. Carry approved audience/product facts and constraints in brandContext; do not assume project documents are loaded. Read existing work with socialseal_get_brief, edit with socialseal_update_brief, and export with socialseal_export_brief before formatting as Word/PDF. May consume credits under existing controls. Generated status does not establish factual accuracy, executable timing or creative quality; the result carries its evidence and missing-data states.

Free stored evidence read. Page both posts and unresolvedPosts with offset/limit until pagination.hasMore=false. To archive immutable raw provider pages, request each sequence from captureManifest using captureSequence. Preserve null metrics, source IDs, observation times, partial coverage and cost uncertainty. No provider call or new charge.

Read the published content Strategy for a Brand (default: the Workspace's primary Brand): offer, wanted and unwanted audiences, frictions, messaging and production rules, angle ledger and decision tests, plus any pending draft. Call before content strategy, ideas, briefs, calendars, captions or interpreting demand/performance data, and apply it as described in its guidance. state=missing (no Strategy yet) and state=no_brand (no primary Brand yet) are normal results, not failures: proceed with the user's request on stated assumptions and follow the returned guidance.

Read an exact saved briefId, or a version and evidence by opportunityId (or the deprecated opportunityKey). Brand/strategy setup is not required to retrieve it.

Read outcomes only for posts actually linked to the specified brief: per post, the Monitor's Share of Voice and Discoverability for the Brief's topic before and after publication (monitor, with method and missingReasons; a post absent from tracked results is not_observed and unknown views stay null), plus legacy weekly search rank as a secondary line. Observational, not causal; this sample is not total account reach.

Check readiness for creative brief generation or editing. Briefs are generated from a Study revision: pass studyContext to check that revision (its studyRef, revision and video count); without one the outcome asks for a Study (socialseal_start_study). This check does not gate unrelated reads, account metrics or Studies.

Read progress, result and failure evidence for an existing brief run.

Read core context, building its stored cache from existing notes if absent. No provider collection or model cost.

Read the status and evidence of one caller/workspace-scoped creator collection receipt. No provider call, charge or new tracker. Running receipts return continuation; complete and failed are terminal. Preserve partial metrics and brand evidence.

Read stored Instagram profile identity, biography and follower metrics, plus workspace brand context for brand-fit assessment, from a supplied profile URL or handle. For the post timeline, captions and engagement aggregates use socialseal_get_creator_recent_posts. Stored Instagram evidence only. To collect any account, Instagram or TikTok, use socialseal_collect_account. No resolver, skill or tracked-search setup prerequisite. Stored evidence only: no provider requests, credits, or persistent tracker. A fresh request returns FRESH_COLLECTION_REQUIRED and existing evidence. Synchronous response; collection.continuation=null, no polling. coverage.latestClaim says whether the latest account posts are covered; a partial timeline does not establish them. Missing brand evidence does not block metrics. Public views do not establish demographics or unique reach.

Read stored Instagram timeline posts (images, carousels and videos), publication dates, captions and metrics, with average views and engagement rates including formulas and denominators. For profile identity and brand-fit context use socialseal_get_creator_profile. Stored Instagram evidence only. To collect any account, Instagram or TikTok, use socialseal_collect_account. No resolver, skill or tracked-search setup prerequisite. Stored evidence only: no provider requests, credits, or persistent tracker. A fresh request returns FRESH_COLLECTION_REQUIRED and existing evidence. Synchronous response; collection.continuation=null, no polling. coverage.latestClaim says whether the latest account posts are covered; a partial timeline does not establish them. Missing brand evidence does not block metrics. Public views do not establish demographics or unique reach.

Get the current workspace before a workspace-scoped action when the user has not named one. Hosted MCP returns the sole workspace the user can reach, or none when there are several: then ask the user which one. Local MCP returns the workspace selected in environment/configuration.

Read stored Google AI, ChatGPT, Gemini and Claude answers and citations, preserving the actual query and historical capture scope; each answer's run names its engine. Filter with engine to compare one engine's answers. Paginate offset/limit.

Read a saved operation's status, price, retained result and receipt. Polling and retrieving prior results are free.

Read SocialSeal's public panel for one market (US, SG or GB) and vertical: rising topics with a search-demand label (strong, indicative or untested), reference videos ("x usual" only for a creator outlier, otherwise views per day against the cell median), Video DNA structure stats with their sample size and an indicative flag, creators to watch, and the latest captures of each panel search. Each section carries its collection date; a stale section is left out and named in hiddenSections. Free, needs no workspace, and never charges credits. Only panel searches' own videos and creators are listed; other data appears only as aggregates.

Read a selected existing journey and optionally its latest execution.

Read status and available results of the returned journey run; do not restart it to poll.

Return download URLs for the full SocialSeal agent-skills repository (zip/tarball) plus the install command, so the agent or user can download every skill at once.

Read a Study revision: findings, coverage and per-video evidence (Video DNA hooks, CTAs, shots, beats, style and metrics), plus collection and Video DNA progress. A start reference reports status collecting while its saved request is processed, or failed with retry guidance. Once a Study is published, the same reference reads its current revision. status enriching means analysis is still running; read again later. briefContext, when present, is the studyContext for socialseal_generate_brief or socialseal_start_brief_run.

Poll a known async run or export ID; for a tracking group ID use socialseal_get_tracking_group_refresh_status. Wait pollAfterSeconds before checking again when it is returned. UUID auto ids are journey runs; numeric auto ids are AI answer runs (Google AI, ChatGPT, Gemini or Claude). Both are workspace-scoped, as are google_ai_run, journey_run, explore_run, and video_analysis. Pass the workspaceId from the lookup that returned the run. MCP-host errors such as "No approval received" occur before SocialSeal executes this tool; they are not SocialSeal billing, workspace approval, or job-status errors.

Read an existing tracking group's configuration by ID. Reads stored data; does not refresh evidence or create tracking. No new collection cost.

Compare expected memberships with stored items in the authorized tracking group, including missing/extra items, platform mismatches and optional stored refresh-job status. Omit expected_items to inspect current membership. Reads existing configuration/jobs only; no collection, refresh, mutation or new cost. Completeness does not establish fresh evidence. Reuse the workspace from socialseal_list_tracking_groups; for the workspace-wide total use socialseal_get_tracking_inventory.

Read collection queue state for a known tracking group ID after socialseal_refresh_tracking_group; does not start another refresh. Use socialseal_get_tool_status for other async run or export IDs.

Read the workspace's canonical tracked-item total and breakdown: one item per search in one market on one platform, hashtag or account, counted once however many groups include it, with paused items separate. This is the tracked total of searches, hashtags and accounts; summed group item counts or a page of list results overcount or undercount it. Pass includeItems for a page of items, including paused items, with platform, market, frequency, last and next collection, latest refresh outcome and Monitor report inclusion. The summary always covers the whole workspace. Use socialseal_list_tracking_groups for group organization, socialseal_list_tracking_items for filtered item records, or socialseal_get_tracking_group_completeness for one group's membership gaps. To read every item, repeat with offset=pagination.nextOffset while pagination.hasMore is true.

Read one existing tracked search, hashtag or account.

Read status, available results or a typed failure for an existing video search. Pass its canonical jobId and workspaceId. Read-only; no collection or charge. Poll this action instead of starting the search again. A completed result has videos[] (one normalised row per video on every platform: id, rank, thumbnailUrl, creator handle and followers, postedAt, views, likes, comments, shares, saves, viewsPerDay, engagementRate with its formula, and vsCreatorMedian, which has a ratio only when views are at least 3× the creator's median over at least 10 stored posts) and a summary (median views, top outliers, top views per day, date spread). Null values are unknown; videos[].unknown says why. If videos is null, videosUnavailable says why and the raw result is still complete. Results carry coverage, provider limitations and evidenceNotes. Rows are videos surfaced for the selected queries at capture time, not search volume or total market demand. Region is the collection market, not verified viewer geography. Views, likes and saves are per-video engagement snapshots, not engagement attributable to the query.

Retrieve progress, candidate themes or the released complete Visibility Check. Read the same operation after reconnecting; polling costs nothing. Return evidence, scope, freshness and limitations honestly. A report awaiting review is not yet released, and a partial report is not a complete outcome.

Read the workspace's credit balance, its plan and, when there is one, the link to its Usage page, plus complimentaryVisibilityCheck (whether this user can still start the free Visibility Check, and the business website it would check). Read it before promising that an action fits within the balance.

Read an existing note by its returned ID.

Read known attribution aliases for an accessible brand.

Read named sets of existing brands. These are not tracking groups.

Retrieve existing brand context before asking the user for brand identifiers. Returns canonical brands and workspace roles.

Read Google AI, ChatGPT, Gemini and Claude run status and progress, scoped to the requested run or tracking item. Each run names its engine.

Read existing keyword records and their evidence/strategy associations. Each keyword carries demandSignals: evidenceLevel (strong/indicative/untested), the demand signals present, and googleSearchVolume.state (not_collected means never fetched, not zero). Listing keywords does not start searches.

List existing journey identities and optionally their latest runs.

Discover optional task-specific SocialSeal guidance after identifying the requested work. For a content calendar or posting schedule, select socialseal-social-plan-builder; for video/editor/UGC briefs, select socialseal-creator-briefing. Loading guidance does not execute generation tools. Skills are not prerequisites for basic operations. Returns each skill's name and frontmatter description (so you can route without reading every SKILL.md), file paths, shared references, the install command, and the archive download info.

Read existing source clips, rights metadata and available clip analysis; expiring media URLs are not permanent assets.

Read the monitored items in an existing tracking group, paginated by page and limit. Stored membership is not fresh search evidence. No collection or new collection cost; no setup prerequisite.

Find group IDs and organization across configured platforms; use socialseal_list_tracking_items for individual tracked records. Reads stored configuration without collection, refresh or setup; no new collection cost. Use the returned group ID and workspace for subsequent reads. Groups overlap, so summed items_count is not the tracked total; socialseal_get_tracking_inventory returns that total.

Read existing tracked items and their actual platform/market scope. Results are paged; for how many items are tracked, use socialseal_get_tracking_inventory.

Read active Topics with stable IDs, names and descriptions before assigning searches. No collection cost.

List workspaces visible to the authenticated SocialSeal user. List order and owner role do not identify the default; use defaultWorkspaceId/isDefaultWorkspace, or call socialseal_get_current_workspace before a write when the user did not name a workspace.

Merge the requested source groups into the target group: the target keeps the union of their items (a shared item is still collected once) and the source groups are deleted. All groups must use the target's platform; a source group still referenced elsewhere blocks the whole merge without changes.

Change whether the specified note is included in core context. No provider collection cost.

Create the requested source clip upload and return signed upload fields. Upload the bytes using those fields, then call socialseal_finalize_source_clip_upload; no assembled-video output.

Return the exact Topics to create or reuse, per-search assignments, conflicts, credits and planFingerprint without activating. Use execute_search_activation with that fingerprint to commit.

Save a draft Strategy revision for user review. Pass the complete Strategy and expectedBaseRevisionId (the published revision you read, or null when none exists). Drafts do not affect agents or generation until published. Use it when the user asks to create or change the Strategy, or after they confirm a correction that should persist.

Publish a draft Strategy revision so agents and brief generation apply it. Call only after the user has explicitly approved this exact draft in the conversation. Fails with BRAND_STRATEGY_STALE_BASE when the published Strategy changed after the draft was proposed.

Read rows of a previously generated SocialSeal export artifact in-session, paginated as JSON. Use this when the export tool returns a download_url you cannot fetch (e.g. sandbox egress limits or web_fetch cannot render a CSV attachment). Pass the short download token (the `t` query param from download_url) plus offset and limit. Each call returns { export_history_id, headers, rows, offset, limit, next_offset, total, has_more }. Rows are packed by serialized char budget (not a fixed row count), so `limit` reflects the actual number of rows returned and may be smaller than requested. To page: if has_more is true, call again with offset = next_offset. Repeat until has_more is false. Prefer limit=200 as the max-rows cap. The data stays inside the MCP tool channel, so no URL fetch is required.

Read the full instructions for one SocialSeal skill. Provide skill (and optional file, defaulting to SKILL.md) to read within skills/<skill>/, or provide path to read a repo-relative file under skills/, references/, docs/, templates/, or examples/.

Rebuild the core context from existing notes; does not collect social content.

Queue collection for the existing group. May incur collection cost. Poll socialseal_get_tracking_group_refresh_status with the group ID; no completion or freshness claim before status/evidence confirms it.

Request fresh collection for an already monitored item. May incur collection cost; follow any returned continuation and retain job/status information. Use socialseal_get_tracking_item with item_id to inspect collected state; do not duplicate starts.

Remove membership in the requested set; no provider collection.

Remove only the requested group membership.

Resume collection for a paused item. The result's collection field says what will collect it: monitor or subscription (collected from the next scheduled run), or manual (only on request). Items whose platform cannot collect in their region (TikTok in CN or HK) stay paused and return UNSUPPORTED_PLATFORM_REGION; report that reason rather than retrying.

Retry the existing run under backend context-fingerprint and idempotency checks. May consume credits. Poll socialseal_get_brief_run; do not silently force a full rerun.

Start a bounded video search for a query, platform and region, paid in credits. Returns jobId when admitted; a search answered from the cache returns its result at once (cacheOnly, no jobId). A completed result has videos[] (one normalised row per video on every platform: id, rank, thumbnailUrl, creator handle and followers, postedAt, views, likes, comments, shares, saves, viewsPerDay, engagementRate with its formula, and vsCreatorMedian, which has a ratio only when views are at least 3× the creator's median over at least 10 stored posts) and a summary (median views, top outliers, top views per day, date spread). Null values are unknown; videos[].unknown says why. If videos is null, videosUnavailable says why and the raw result is still complete. Results carry coverage, provider limitations and evidenceNotes. When the credits or plan do not cover it, the result is upgrade_required with a message and upgrade link, and nothing ran; after an upgrade, the same request with the same idempotency key runs it. Poll socialseal_get_video_search for admitted legacy jobs. Concurrent equivalent searches coalesce. No ongoing tracker is created. Rows are videos surfaced for the selected queries at capture time, not search volume or total market demand. Region is the collection market, not verified viewer geography. Views, likes and saves are per-video engagement snapshots, not engagement attributable to the query.

Find existing brand facts, constraints and decisions in authorized workspace notes.

Change the active state of one attribution alias; no collection cost.