uruads.ai

Get the current uruads user account, plan, credit balances (videos, images, avatar, research scrapes) and brand scope (active brand or all accessible brands).

List every brand this API key can act on — brands the user owns plus brands shared with a team they belong to — and which one is active for this session.

Pin this session to one brand (id from list_brands) so every later tool call is scoped to it — required for generate_content_plan.

List connected social accounts (TikTok, Instagram, LinkedIn).

Search trending content and viral hook formulas.

Account-level research, the way the dashboard works: searches the inspiration corpus for a brand handle, hashtag or keyword on one platform, reports when that search was last scraped, and — with refresh "auto" (default) — triggers a NEW scrape as the authenticated account when the search is unscraped or older than 24h, charging 1 research credit (see account → usage.research).

Deprecated: use get_job.

List the tracked competitor accounts for the active brand (requires use_brand / X-Brand-Id): platform, handle, followers, tracking state, last_scraped_at, content_count, plus the plan's tracking limits.

Track a competitor account for the active brand.

Pause (is_tracked:false) or resume (true) a tracked competitor account without deleting its scraped content.

Stop tracking a competitor account (deletes the tracking row; scraped posts stay in the corpus).

Scrape a tracked competitor account NOW (synchronous, up to ~2 minutes) instead of waiting for the cron: pulls their latest posts into the corpus, recomputes outliers and updates last_scraped_at.

Us-vs-them benchmark for the active brand: followers, average views, posting cadence and best posting hours for the brand's connected accounts versus its tracked competitors.

Top outlier posts (highest outlier_score) for one tracked competitor account — what is over-performing for them right now.

The user's own social accounts whose post performance is tracked: user-owned discovered accounts plus connected publishing accounts (ids like tiktok_<uuid> usable in get_post_performance / refresh_performance).

Per-post analytics for one of the user's own accounts (views, likes, comments, shares, engagement metrics, outlier score) over a date range.

Re-scrape one of the user's own accounts so get_post_performance reflects the latest numbers (throttled to once per hour per account).

The publishing calendar: scheduled, draft-ready, posting and posted items across platforms for the active scope.

Publish a provider draft (status DRAFT_READY) created by schedule_content in draft mode.

Cancel a scheduled (not yet posted) item from the publishing calendar.

Create a content plan from items you supply — use generate_content_plan instead unless you specifically need hand-authored items.

PREFERRED way to build a plan: runs the research-grounded planner, which writes items from this brand's corpus — pre-validated hooks (outlier >=2 or 50k+ views), your own organic winners, hook formulas, the curated backlog, competitor gaps and live trends — then applies a strategy relevance gate, 90-day semantic de-duplication and format quotas.

List the user's content plans (brand-scoped when the session carries X-Brand-Id).

Get one content plan with all its items (topics, hooks, captions, statuses, planned dates).

Bulk-update plan items — the approval gate.

Kick off generation for all APPROVED items in a plan (each becomes a generation job; completed assets auto-schedule to the plan's account targets at 09:00 on their planned date).

Model catalogue with costs, abilities, transition support and the house routing criteria — call once per session before generating anything.

List the Higgsfield Soul style catalogue ({id, name, description}).

List reusable characters (locked face + voice identities).

Create a reusable character (locked face + optional voice) for consistent-character content across satellites.

List satellite / hosted UGC accounts: persona, provider (tokportal = human-operated hosted account, manual, zernio), lifecycle status (provisioning → warming_up → active), warmup progress and posting stats.

Spin up ONE hosted satellite UGC account (TokPortal: real device, niche-warmed, human-published).

Generate an OAuth connect link for a social account (instagram, tiktok, linkedin, youtube, facebook, x, threads, pinterest…).

THE research primitive: pre-validated winning content.

Spy on one competitor profile: scrapes/loads their account, finds their outlier posts, and computes deterministic gaps vs your own posting (cadence gaps, formats they win with that you never post).

Generate a narrated video from a SCRIPT (TTS voice + visuals + word-synced subtitles), processed async — poll get_generation_status.

Generate an AI image.

Deprecated: use get_job.

Pull a remote file (Dropbox/Google Drive share link or any direct URL) into the uruads asset library.

List/search the user's asset library (uploads, generated media, b-roll).

List editing style presets for the auto-edit pipeline: built-ins (Ali Abdaal, Hormozi Bold, Split Screen, VOX Explainer, Clean Minimal) plus the user's saved custom presets.

Save a reusable editing style preset — either from a style guide extracted from a reference video, or from a base preset plus overrides (captions/zooms/broll/overlays).

Step 1 of auto-editing a talking-head video: transcribes it and plans zoom punch-ins, b-roll cutaway moments (with AI generation prompts), and text callouts per an edit preset.

Step 2 of auto-editing (after user approval): assembles the composition (base video + zooms + b-roll + callouts + word-synced captions) and renders it.

Deprecated: use get_job.

Plan an edit of LONG-FORM raw footage (multi-take recordings, podcasts — any length).

Render an approved long-form edit (or one shorts clip — pass its single range + aspect "9:16"): ranges are word-boundary-snapped and rendered as one video with word-synced captions.

Generate branded motion-graphic b-roll clips (kinetic typography, animated shapes) via the HyperFrames engine — one clip per scene prompt, 2-10s each, max 5 scenes.

Create a review-canvas project for a talking-head video.

List the user's review-canvas edit projects (title, source, latest version, open-note count), newest first.

Get one edit project: the project row, version summaries (number, status, output_url, review_url, parent) and its notes (open + resolved).

Get one rendered version: editor_notes (one per change, "0:05.8 — WITH · AI now sits on ink pills" headline + what/why), open_decisions, beat_map, qa (measured LUFS / music-bed delta / first-5s check) and output_url.

List every version of an edit project in order (V1, V2, …) with status, parent_version_id, output_url, review_url and open-note counts.

Pin a note to a timestamp on the current (or given) version of an edit project — the same thing the user does in the review canvas with C.

Revise an edit from its notes: applies the open notes on the source version (or just note_ids) plus an optional free-text instruction, re-renders as V(n+1) — the parent is kept intact — and writes one editor's note per input note.

Regenerate the editor's notes, beat map and QA for a rendered version (e.g.

Turn a reference into a composition graph you can recreate: a competitor talking-head/launch video, a static ad (ads-table ad_id or Meta Ad Library url), a TikTok photo post or LinkedIn document carousel.

Spin sibling variants of a rendered cut without re-planning: swaps[] of { hook } / { cta } / { language } / { voiceId } / { product: { name, imageUrl } } / { character } — one object per variant (count cycles through them, max 12).

Look at a rendered version: one at_ms timestamp returns the frame as an image block (plus review_url); several timestamps or grid "RxC" (max 4x4, evenly spaced) return JSON frames [{ atMs, url | dataUrl }].

Composition templates: built-ins (hormozi shorts, launch, static ad, carousel…) plus the brand's own content_templates that carry a composition, each with its declared slots (hook, product, character, language…).

THE poller: one call for any job id — generation jobs (generate_video / generate_image / generate_motion_broll), render jobs (render_auto_edit, render_longform_edit, edit versions), satellite provisioning (provision_satellite_account) and scrape cache keys (search_inspiration).

Publish or schedule a content asset to a social account from list_social_accounts.