{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://artifacts.apis.io/clippingalpha-com/json-schema/clippingalpha-com-mcp-tool-schemas.json", "title": "ClippingAlpha MCP tool input/output schemas", "description": "Extracted verbatim from the inputSchema/outputSchema of each tool returned by an anonymous tools/list call to https://clippingalpha.com/mcp (HTTP 200, serverInfo.name clippingalpha) on 2026-11-04.", "x-generated": "2026-11-04", "x-method": "derived", "x-source": "json-schema/clippingalpha-com-mcp-tools-list.json", "$defs": { "search_campaigns_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "query": { "description": "Only a brand, campaign or creator name to look up, for example lovable or MrBeast. Leave it out for what the user does or wants (fashion videos, join without applying, high pay): use type, niche, platforms, min_rate_per_1k_usd and open_join_only for those. If no name matches, the other filters still answer.", "type": "string", "maxLength": 80 }, "platforms": { "description": "Only campaigns that pay for at least one of these social apps.", "maxItems": 9, "type": "array", "items": { "type": "string", "enum": [ "tiktok", "instagram", "youtube", "x", "facebook", "twitch", "kick", "threads", "snapchat" ] } }, "type": { "description": "One campaign type: clipping cuts clips from the footage the campaign provides, ugc films your own content about the product, logo puts the brand's logo on your own niche content, music uses the artist's track as the sound.", "type": "string", "enum": [ "clipping", "ugc", "logo", "music" ] }, "min_rate_per_1k_usd": { "description": "Minimum pay per 1,000 views in USD (CPM campaigns only).", "type": "number", "minimum": 0, "maximum": 100 }, "niche": { "description": "One content niche.", "type": "string", "enum": [ "podcast", "streams", "gaming", "sports", "film-and-tv", "music", "brand-ads", "ugc-and-apps", "behind-the-scenes", "gambling", "prediction-markets", "crypto-trading" ] }, "board": { "description": "Only campaigns listed on this clipping platform.", "type": "string", "enum": [ "content-rewards", "promote-fun", "clipster", "clipstake", "vyro", "evangelist" ] }, "agency": { "description": "Only campaigns posted by this clipping agency, by name or profile slug, for example Clip Farm or clip-farm.", "type": "string", "maxLength": 80 }, "min_tier": { "description": "Lowest Alpha tier to include. alpha is the top 10 percent of the market.", "type": "string", "enum": [ "alpha", "solid", "fair" ] }, "open_join_only": { "description": "Only campaigns anyone can join now, with no application.", "type": "boolean" }, "new_within_hours": { "description": "Only campaigns new in this many hours: discovered by ClippingAlpha, on Content Rewards launched there. 24 is New today. A new round of an older campaign is new.", "type": "integer", "minimum": 1, "maximum": 720 }, "sort": { "description": "Order. Default alpha, the Alpha Score.", "type": "string", "enum": [ "alpha", "newest", "rate", "budget_left" ] }, "limit": { "description": "How many to return, default 10.", "type": "integer", "minimum": 1, "maximum": 25 }, "cuttable": { "description": "True to plan or cut clips: then only clipping campaigns whose footage ClippingAlpha has read and can cut into clips are listed, each with its moments. Leave it out to find or compare campaigns.", "type": "boolean" }, "for_clips": { "description": "The same as cuttable, kept for earlier calls.", "type": "boolean" }, "for_you": { "description": "Rank for the signed-in user's connected social account: fit, an estimate at their recent views and Alpha Score. Default true when signed in. False for the usual order.", "type": "boolean" } } }, "search_campaigns_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "total": { "type": "number" }, "membersLocked": { "type": "number" }, "cpm": { "type": "object", "properties": { "medianUsd": { "type": "number" }, "p25Usd": { "type": "number" }, "p75Usd": { "type": "number" }, "n": { "type": "number" }, "basis": { "type": "string", "const": "listed" }, "url": { "type": "string" } }, "required": [ "medianUsd", "p25Usd", "p75Usd", "n", "basis", "url" ], "additionalProperties": {} }, "campaigns": { "type": "array", "items": { "type": "object", "properties": { "campaignId": { "type": "string" }, "title": { "type": "string" }, "brand": { "type": "string" }, "brandSlug": { "type": "string" }, "seriesSlug": { "type": "string" }, "board": { "type": "string" }, "boardSlug": { "type": "string" }, "agency": { "type": [ "string", "null" ] }, "agencySlug": { "type": [ "string", "null" ] }, "state": { "type": "string" }, "campaignType": { "type": "string", "enum": [ "clipping", "ugc", "logo", "music" ] }, "payModel": { "type": "string" }, "platforms": { "type": "array", "items": { "type": "string" } }, "ratePer1kUsd": { "type": [ "number", "null" ] }, "budgetLeftUsd": { "type": [ "number", "null" ] }, "budgetTotalUsd": { "type": [ "number", "null" ] }, "alphaScore": { "type": [ "number", "null" ] }, "tier": { "type": "string", "enum": [ "alpha", "solid", "fair", "low", "scoring" ] }, "drainP50": { "type": [ "string", "null" ] }, "openJoin": { "type": "boolean" }, "exclusive": { "type": "boolean" }, "access": { "anyOf": [ { "type": "string", "enum": [ "exclusive", "apply" ] }, { "type": "null" } ] }, "niche": { "type": [ "string", "null" ] }, "membersOnly": { "type": "boolean" }, "ageRestricted": { "type": "boolean" }, "labels": { "type": "array", "items": { "type": "string" } }, "election": { "type": "boolean" }, "electionLabel": { "type": [ "string", "null" ] }, "electionNote": { "type": [ "string", "null" ] }, "audience": { "anyOf": [ { "type": "object", "properties": { "countries": { "type": "array", "items": { "type": "string" } }, "minSharePct": { "type": [ "number", "null" ] }, "language": { "type": [ "string", "null" ] } }, "required": [ "countries", "minSharePct", "language" ], "additionalProperties": {} }, { "type": "null" } ] }, "audienceLabel": { "type": [ "string", "null" ] }, "audienceNote": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "firstSeenAt": { "type": "string" }, "launchedAt": { "type": "string" }, "newAt": { "type": [ "string", "null" ] }, "pageUrl": { "type": "string" }, "joinUrl": { "type": "string" }, "forYou": { "type": "object", "properties": { "reason": { "type": "string" }, "estimateUsd": { "type": [ "number", "null" ] }, "application": { "type": "boolean" }, "moved": { "anyOf": [ { "type": "string", "enum": [ "joined", "skipped" ] }, { "type": "null" } ] }, "fit": { "type": "boolean" } }, "required": [ "reason", "estimateUsd", "application", "moved", "fit" ], "additionalProperties": {} }, "picture": { "anyOf": [ { "type": "object", "properties": { "src": { "type": "string" }, "src2x": { "type": [ "string", "null" ] }, "square": { "type": [ "string", "null" ] }, "alt": { "type": "string" }, "width": { "type": "number" }, "height": { "type": "number" }, "fit": { "type": "string", "enum": [ "cover", "contain" ] } }, "required": [ "src", "src2x", "square", "alt", "width", "height", "fit" ], "additionalProperties": {} }, { "type": "null" } ] }, "canCut": { "type": "boolean" } }, "required": [ "campaignId", "title", "brand", "brandSlug", "seriesSlug", "board", "boardSlug", "state", "campaignType", "payModel", "platforms", "ratePer1kUsd", "budgetLeftUsd", "budgetTotalUsd", "alphaScore", "tier", "drainP50", "openJoin", "exclusive", "access", "niche", "membersOnly", "ageRestricted", "labels", "election", "electionLabel", "electionNote", "firstSeenAt", "launchedAt", "newAt", "pageUrl", "joinUrl", "picture" ], "additionalProperties": {} } }, "forYou": { "type": "object", "properties": { "state": { "type": "string", "enum": [ "on", "connect", "off" ] }, "title": { "type": "string" }, "banner": { "type": "object", "properties": { "text": { "type": "string" }, "key": { "type": "string" }, "platform": { "type": "string" }, "url": { "type": "string" }, "signedIn": { "type": "boolean" }, "say": { "type": "string" } }, "required": [ "text", "key", "platform", "url", "signedIn" ], "additionalProperties": {} } }, "required": [ "state", "title" ], "additionalProperties": {} } }, "required": [ "total", "membersLocked", "campaigns" ], "additionalProperties": {} }, "get_campaign_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "campaign": { "type": "string", "minLength": 3, "maxLength": 300, "description": "brand/series, for example lovable/clipping, or a clippingalpha.com/campaigns/... URL." } }, "required": [ "campaign" ] }, "get_campaign_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "campaign": { "type": "object", "properties": { "campaignId": { "type": "string" }, "title": { "type": "string" }, "brand": { "type": "string" }, "pageUrl": { "type": "string" }, "alpha": { "type": "object", "properties": {}, "additionalProperties": {} }, "whereToJoin": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } } }, "required": [ "campaignId", "title", "brand", "pageUrl", "alpha", "whereToJoin" ], "additionalProperties": {} }, "locked": { "type": "boolean" }, "board": { "type": "string" }, "platforms": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": {} }, "top_alpha_now_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "platform": { "description": "Only campaigns that pay for this social app.", "type": "string", "enum": [ "tiktok", "instagram", "youtube", "x", "facebook", "twitch", "kick", "threads", "snapchat" ] }, "type": { "description": "One campaign type: clipping cuts clips from the footage the campaign provides, ugc films your own content about the product, logo puts the brand's logo on your own niche content, music uses the artist's track as the sound.", "type": "string", "enum": [ "clipping", "ugc", "logo", "music" ] }, "limit": { "description": "How many, default 5.", "type": "integer", "minimum": 1, "maximum": 10 }, "cuttable": { "description": "True to plan or cut clips: then only clipping campaigns whose footage ClippingAlpha has read and can cut into clips are listed, each with its moments. Leave it out to find or compare campaigns.", "type": "boolean" }, "for_clips": { "description": "The same as cuttable, kept for earlier calls.", "type": "boolean" }, "for_you": { "description": "Rank for the signed-in user's connected social account: fit, an estimate at their recent views and Alpha Score. Default true when signed in. False for the usual order.", "type": "boolean" } } }, "top_alpha_now_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "market": { "type": "object", "properties": { "live": { "type": "number" }, "boards": { "type": "number" }, "newToday": { "type": "number" }, "leftUsd": { "type": [ "number", "null" ] }, "asOf": { "type": [ "string", "null" ] }, "cpm": { "type": "object", "properties": { "medianUsd": { "type": "number" }, "p25Usd": { "type": "number" }, "p75Usd": { "type": "number" }, "n": { "type": "number" }, "basis": { "type": "string", "const": "listed" }, "url": { "type": "string" } }, "required": [ "medianUsd", "p25Usd", "p75Usd", "n", "basis", "url" ], "additionalProperties": {} } }, "required": [ "live", "boards", "newToday", "leftUsd", "asOf" ], "additionalProperties": {} }, "campaigns": { "type": "array", "items": { "type": "object", "properties": { "campaignId": { "type": "string" }, "title": { "type": "string" }, "brand": { "type": "string" }, "brandSlug": { "type": "string" }, "seriesSlug": { "type": "string" }, "board": { "type": "string" }, "boardSlug": { "type": "string" }, "agency": { "type": [ "string", "null" ] }, "agencySlug": { "type": [ "string", "null" ] }, "state": { "type": "string" }, "campaignType": { "type": "string", "enum": [ "clipping", "ugc", "logo", "music" ] }, "payModel": { "type": "string" }, "platforms": { "type": "array", "items": { "type": "string" } }, "ratePer1kUsd": { "type": [ "number", "null" ] }, "budgetLeftUsd": { "type": [ "number", "null" ] }, "budgetTotalUsd": { "type": [ "number", "null" ] }, "alphaScore": { "type": [ "number", "null" ] }, "tier": { "type": "string", "enum": [ "alpha", "solid", "fair", "low", "scoring" ] }, "drainP50": { "type": [ "string", "null" ] }, "openJoin": { "type": "boolean" }, "exclusive": { "type": "boolean" }, "access": { "anyOf": [ { "type": "string", "enum": [ "exclusive", "apply" ] }, { "type": "null" } ] }, "niche": { "type": [ "string", "null" ] }, "membersOnly": { "type": "boolean" }, "ageRestricted": { "type": "boolean" }, "labels": { "type": "array", "items": { "type": "string" } }, "election": { "type": "boolean" }, "electionLabel": { "type": [ "string", "null" ] }, "electionNote": { "type": [ "string", "null" ] }, "audience": { "anyOf": [ { "type": "object", "properties": { "countries": { "type": "array", "items": { "type": "string" } }, "minSharePct": { "type": [ "number", "null" ] }, "language": { "type": [ "string", "null" ] } }, "required": [ "countries", "minSharePct", "language" ], "additionalProperties": {} }, { "type": "null" } ] }, "audienceLabel": { "type": [ "string", "null" ] }, "audienceNote": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "firstSeenAt": { "type": "string" }, "launchedAt": { "type": "string" }, "newAt": { "type": [ "string", "null" ] }, "pageUrl": { "type": "string" }, "joinUrl": { "type": "string" }, "forYou": { "type": "object", "properties": { "reason": { "type": "string" }, "estimateUsd": { "type": [ "number", "null" ] }, "application": { "type": "boolean" }, "moved": { "anyOf": [ { "type": "string", "enum": [ "joined", "skipped" ] }, { "type": "null" } ] }, "fit": { "type": "boolean" } }, "required": [ "reason", "estimateUsd", "application", "moved", "fit" ], "additionalProperties": {} }, "picture": { "anyOf": [ { "type": "object", "properties": { "src": { "type": "string" }, "src2x": { "type": [ "string", "null" ] }, "square": { "type": [ "string", "null" ] }, "alt": { "type": "string" }, "width": { "type": "number" }, "height": { "type": "number" }, "fit": { "type": "string", "enum": [ "cover", "contain" ] } }, "required": [ "src", "src2x", "square", "alt", "width", "height", "fit" ], "additionalProperties": {} }, { "type": "null" } ] }, "canCut": { "type": "boolean" } }, "required": [ "campaignId", "title", "brand", "brandSlug", "seriesSlug", "board", "boardSlug", "state", "campaignType", "payModel", "platforms", "ratePer1kUsd", "budgetLeftUsd", "budgetTotalUsd", "alphaScore", "tier", "drainP50", "openJoin", "exclusive", "access", "niche", "membersOnly", "ageRestricted", "labels", "election", "electionLabel", "electionNote", "firstSeenAt", "launchedAt", "newAt", "pageUrl", "joinUrl", "picture" ], "additionalProperties": {} } }, "forYou": { "type": "object", "properties": { "state": { "type": "string", "enum": [ "on", "connect", "off" ] }, "title": { "type": "string" }, "banner": { "type": "object", "properties": { "text": { "type": "string" }, "key": { "type": "string" }, "platform": { "type": "string" }, "url": { "type": "string" }, "signedIn": { "type": "boolean" }, "say": { "type": "string" } }, "required": [ "text", "key", "platform", "url", "signedIn" ], "additionalProperties": {} } }, "required": [ "state", "title" ], "additionalProperties": {} } }, "required": [ "market", "campaigns" ], "additionalProperties": {} }, "board_summary_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "board": { "description": "One clipping platform, or leave out for all.", "type": "string", "enum": [ "content-rewards", "promote-fun", "clipster", "clipstake", "vyro", "evangelist" ] } } }, "board_summary_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "boards": { "type": "array", "items": { "type": "object", "properties": { "board": { "type": "string" }, "slug": { "type": "string" }, "liveCampaigns": { "type": "number" }, "pageUrl": { "type": "string" } }, "required": [ "board", "slug", "liveCampaigns", "pageUrl" ], "additionalProperties": {} } } }, "required": [ "boards" ], "additionalProperties": {} }, "get_brief_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "campaign": { "type": "string", "minLength": 1, "maxLength": 300, "description": "The campaign as brand/series (for example lovable/clipping), its clippingalpha.com page URL, or its numeric campaignId from another tool." } }, "required": [ "campaign" ] }, "get_brief_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "campaign": { "type": "object", "properties": { "campaignId": { "type": "string" }, "ref": { "type": "string" }, "title": { "type": "string" }, "brand": { "type": "string" }, "pageUrl": { "type": "string" }, "joinUrl": { "type": [ "string", "null" ] } }, "required": [ "campaignId", "ref", "title", "brand", "pageUrl", "joinUrl" ], "additionalProperties": {} }, "wants": { "type": "object", "properties": {}, "additionalProperties": {} }, "checklist": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "rulesHidden": { "type": "boolean" }, "quality": { "type": "object", "properties": { "grade": { "type": [ "string", "null" ] }, "flags": { "type": "array", "items": { "type": "string" } } }, "required": [ "grade", "flags" ], "additionalProperties": {} }, "join": { "type": "object", "properties": {}, "additionalProperties": {} }, "briefUrl": { "type": [ "string", "null" ] }, "briefDocs": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "rules": { "type": "object", "properties": { "groups": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "thresholds": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "materials": { "type": "object", "properties": {}, "additionalProperties": {} } }, "required": [ "groups", "thresholds", "materials" ], "additionalProperties": {} } }, "required": [ "campaign", "wants", "checklist", "rulesHidden", "quality", "join", "briefUrl", "briefDocs", "rules" ], "additionalProperties": {} }, "get_moments_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "campaign": { "type": "string", "minLength": 1, "maxLength": 300, "description": "The campaign as brand/series (for example lovable/clipping), its clippingalpha.com page URL, or its numeric campaignId from another tool." }, "source_id": { "description": "Only this source, by the sourceId of an earlier answer.", "type": "string", "pattern": "^\\d{1,18}$" } }, "required": [ "campaign" ] }, "get_moments_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "campaign": { "type": "object", "properties": { "campaignId": { "type": "string" }, "ref": { "type": "string" }, "title": { "type": "string" }, "brand": { "type": "string" }, "pageUrl": { "type": "string" }, "joinUrl": { "type": [ "string", "null" ] } }, "required": [ "campaignId", "ref", "title", "brand", "pageUrl", "joinUrl" ], "additionalProperties": {} }, "full": { "type": "boolean" }, "sources": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "unavailable": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "momentMapUrl": { "type": "string" } }, "required": [ "campaign", "full", "sources", "unavailable", "momentMapUrl" ], "additionalProperties": {} }, "get_assets_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "campaign": { "type": "string", "minLength": 1, "maxLength": 300, "description": "The campaign as brand/series (for example lovable/clipping), its clippingalpha.com page URL, or its numeric campaignId from another tool." } }, "required": [ "campaign" ] }, "get_assets_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "campaign": { "type": "object", "properties": { "campaignId": { "type": "string" }, "ref": { "type": "string" }, "title": { "type": "string" }, "brand": { "type": "string" }, "pageUrl": { "type": "string" }, "joinUrl": { "type": [ "string", "null" ] } }, "required": [ "campaignId", "ref", "title", "brand", "pageUrl", "joinUrl" ], "additionalProperties": {} }, "videos": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "brandAssets": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, { "type": "null" } ] }, "brandAssetCount": { "type": "number" }, "library": { "anyOf": [ { "type": "object", "properties": { "total": { "type": "number" }, "analysed": { "type": "number" } }, "required": [ "total", "analysed" ], "additionalProperties": false }, { "type": "null" } ] }, "exampleClips": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "memberFootage": { "type": "number" } }, "required": [ "campaign", "videos", "brandAssets", "brandAssetCount", "library", "exampleClips", "memberFootage" ], "additionalProperties": {} }, "plan_clips_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "campaign": { "type": "string", "minLength": 1, "maxLength": 300, "description": "The campaign as brand/series (for example lovable/clipping), its clippingalpha.com page URL, or its numeric campaignId from another tool." }, "app": { "description": "Set only by the ClippingAlpha app in the chat, to count its steps. Leave it out.", "type": "string", "enum": [ "make_clips", "plan_video", "cut", "poll", "download", "submit" ] } }, "required": [ "campaign" ] }, "plan_clips_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "campaign": { "type": "object", "properties": { "campaignId": { "type": "string" }, "ref": { "type": "string" }, "title": { "type": "string" }, "brand": { "type": "string" }, "pageUrl": { "type": "string" }, "joinUrl": { "type": [ "string", "null" ] } }, "required": [ "campaignId", "ref", "title", "brand", "pageUrl", "joinUrl" ], "additionalProperties": {} }, "full": { "type": "boolean" }, "plan": { "anyOf": [ { "type": "object", "properties": { "live": { "type": "boolean" }, "access": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": {} }, { "type": "null" } ] }, "make": { "type": "object", "properties": {}, "additionalProperties": {} }, "from": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": {} }, { "type": "null" } ] }, "rules": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "avoid": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } } }, "required": [ "include", "avoid" ], "additionalProperties": {} }, "footage": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "hooks": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, { "type": "null" } ] }, "passwords": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, { "type": "null" } ] }, "full": { "type": "boolean" }, "computedAt": { "type": "string" } }, "required": [ "live", "access", "make", "from", "rules", "footage", "hooks", "passwords", "full", "computedAt" ], "additionalProperties": {} }, { "type": "null" } ] }, "guide": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "cut", "ready", "post", "none" ] }, "full": { "type": "boolean" }, "groups": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "ready": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": {} }, { "type": "null" } ] }, "readyFirst": { "type": "boolean" }, "post": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": {} }, { "type": "null" } ] }, "moreHooks": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "caption": { "type": [ "string", "null" ] } }, "required": [ "kind", "full", "groups", "ready", "readyFirst", "post", "moreHooks", "caption" ], "additionalProperties": {} }, { "type": "null" } ] }, "exampleClips": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } } }, "required": [ "campaign", "full", "plan", "guide", "exampleClips" ], "additionalProperties": {} }, "get_campaign_analytics_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "campaign": { "type": "string", "minLength": 1, "maxLength": 300, "description": "The campaign as brand/series (for example lovable/clipping), its clippingalpha.com page URL, or its numeric campaignId from another tool." } }, "required": [ "campaign" ] }, "get_campaign_analytics_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "campaign": { "type": "object", "properties": { "campaignId": { "type": "string" }, "ref": { "type": "string" }, "title": { "type": "string" }, "brand": { "type": "string" }, "pageUrl": { "type": "string" }, "joinUrl": { "type": [ "string", "null" ] } }, "required": [ "campaignId", "ref", "title", "brand", "pageUrl", "joinUrl" ], "additionalProperties": {} }, "alpha": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": {} }, { "type": "null" } ] }, "pay": { "type": "object", "properties": {}, "additionalProperties": {} }, "runway": { "type": "object", "properties": {}, "additionalProperties": {} }, "market": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": {} }, { "type": "null" } ] }, "asOf": { "type": [ "string", "null" ] } }, "required": [ "campaign", "alpha", "pay", "runway", "market", "asOf" ], "additionalProperties": {} }, "compare_campaigns_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "campaigns": { "minItems": 2, "maxItems": 5, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 300, "description": "The campaign as brand/series (for example lovable/clipping), its clippingalpha.com page URL, or its numeric campaignId from another tool." }, "description": "2 to 5 campaigns, each as brand/series, a page URL or a campaignId." } }, "required": [ "campaigns" ] }, "compare_campaigns_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "recommendation": { "type": "string" }, "order": { "type": "array", "items": { "type": "string" } }, "campaigns": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } } }, "required": [ "recommendation", "order", "campaigns" ], "additionalProperties": {} }, "show_campaign_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "campaign": { "description": "The campaign as brand/series (for example lovable/clipping), its clippingalpha.com page URL, or its campaignId. Leave out to show the top picks to choose from.", "type": "string", "minLength": 1, "maxLength": 300 } } }, "show_campaign_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "view": { "type": "string", "enum": [ "campaign", "pick" ] }, "campaign": { "type": "object", "properties": { "campaignId": { "type": "string" }, "ref": { "type": "string" }, "title": { "type": "string" }, "pageUrl": { "type": "string" }, "joinUrl": { "type": [ "string", "null" ] } }, "required": [ "campaignId", "ref", "title", "pageUrl", "joinUrl" ], "additionalProperties": {} }, "alpha": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": {} }, { "type": "null" } ] }, "pay": { "type": "object", "properties": {}, "additionalProperties": {} }, "runway": { "type": "object", "properties": {}, "additionalProperties": {} }, "brief": { "type": "object", "properties": {}, "additionalProperties": {} }, "moments": { "type": "object", "properties": {}, "additionalProperties": {} }, "sources": { "type": "object", "properties": {}, "additionalProperties": {} }, "whereToJoin": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "market": { "type": "object", "properties": { "live": { "type": "number" }, "boards": { "type": "number" }, "newToday": { "type": "number" }, "leftUsd": { "type": [ "number", "null" ] }, "asOf": { "type": [ "string", "null" ] }, "cpm": { "type": "object", "properties": { "medianUsd": { "type": "number" }, "p25Usd": { "type": "number" }, "p75Usd": { "type": "number" }, "n": { "type": "number" }, "basis": { "type": "string", "const": "listed" }, "url": { "type": "string" } }, "required": [ "medianUsd", "p25Usd", "p75Usd", "n", "basis", "url" ], "additionalProperties": {} } }, "required": [ "live", "boards", "newToday", "leftUsd", "asOf" ], "additionalProperties": {} }, "campaigns": { "type": "array", "items": { "type": "object", "properties": { "campaignId": { "type": "string" }, "title": { "type": "string" }, "brand": { "type": "string" }, "brandSlug": { "type": "string" }, "seriesSlug": { "type": "string" }, "board": { "type": "string" }, "boardSlug": { "type": "string" }, "agency": { "type": [ "string", "null" ] }, "agencySlug": { "type": [ "string", "null" ] }, "state": { "type": "string" }, "campaignType": { "type": "string", "enum": [ "clipping", "ugc", "logo", "music" ] }, "payModel": { "type": "string" }, "platforms": { "type": "array", "items": { "type": "string" } }, "ratePer1kUsd": { "type": [ "number", "null" ] }, "budgetLeftUsd": { "type": [ "number", "null" ] }, "budgetTotalUsd": { "type": [ "number", "null" ] }, "alphaScore": { "type": [ "number", "null" ] }, "tier": { "type": "string", "enum": [ "alpha", "solid", "fair", "low", "scoring" ] }, "drainP50": { "type": [ "string", "null" ] }, "openJoin": { "type": "boolean" }, "exclusive": { "type": "boolean" }, "access": { "anyOf": [ { "type": "string", "enum": [ "exclusive", "apply" ] }, { "type": "null" } ] }, "niche": { "type": [ "string", "null" ] }, "membersOnly": { "type": "boolean" }, "ageRestricted": { "type": "boolean" }, "labels": { "type": "array", "items": { "type": "string" } }, "election": { "type": "boolean" }, "electionLabel": { "type": [ "string", "null" ] }, "electionNote": { "type": [ "string", "null" ] }, "audience": { "anyOf": [ { "type": "object", "properties": { "countries": { "type": "array", "items": { "type": "string" } }, "minSharePct": { "type": [ "number", "null" ] }, "language": { "type": [ "string", "null" ] } }, "required": [ "countries", "minSharePct", "language" ], "additionalProperties": {} }, { "type": "null" } ] }, "audienceLabel": { "type": [ "string", "null" ] }, "audienceNote": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "firstSeenAt": { "type": "string" }, "launchedAt": { "type": "string" }, "newAt": { "type": [ "string", "null" ] }, "pageUrl": { "type": "string" }, "joinUrl": { "type": "string" }, "forYou": { "type": "object", "properties": { "reason": { "type": "string" }, "estimateUsd": { "type": [ "number", "null" ] }, "application": { "type": "boolean" }, "moved": { "anyOf": [ { "type": "string", "enum": [ "joined", "skipped" ] }, { "type": "null" } ] }, "fit": { "type": "boolean" } }, "required": [ "reason", "estimateUsd", "application", "moved", "fit" ], "additionalProperties": {} }, "picture": { "anyOf": [ { "type": "object", "properties": { "src": { "type": "string" }, "src2x": { "type": [ "string", "null" ] }, "square": { "type": [ "string", "null" ] }, "alt": { "type": "string" }, "width": { "type": "number" }, "height": { "type": "number" }, "fit": { "type": "string", "enum": [ "cover", "contain" ] } }, "required": [ "src", "src2x", "square", "alt", "width", "height", "fit" ], "additionalProperties": {} }, { "type": "null" } ] }, "canCut": { "type": "boolean" } }, "required": [ "campaignId", "title", "brand", "brandSlug", "seriesSlug", "board", "boardSlug", "state", "campaignType", "payModel", "platforms", "ratePer1kUsd", "budgetLeftUsd", "budgetTotalUsd", "alphaScore", "tier", "drainP50", "openJoin", "exclusive", "access", "niche", "membersOnly", "ageRestricted", "labels", "election", "electionLabel", "electionNote", "firstSeenAt", "launchedAt", "newAt", "pageUrl", "joinUrl", "picture" ], "additionalProperties": {} } }, "signedIn": { "type": "boolean" }, "asOf": { "type": [ "string", "null" ] } }, "required": [ "view", "signedIn" ], "additionalProperties": {} }, "browse_campaigns_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "platform": { "description": "Only campaigns that pay for this platform.", "type": "string", "enum": [ "tiktok", "instagram", "youtube", "x", "facebook", "twitch", "kick", "threads", "snapchat" ] }, "type": { "description": "clipping cuts clips from the footage the campaign provides, ugc films your own content about the product, logo puts the brand's logo on your own niche content, music uses the artist's track as the sound.", "type": "string", "enum": [ "clipping", "ugc", "logo", "music" ] }, "saved_only": { "description": "Only the signed-in clipper's saved campaigns.", "type": "boolean" } } }, "browse_campaigns_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "market": { "type": "object", "properties": { "live": { "type": "number" }, "boards": { "type": "number" }, "newToday": { "type": "number" }, "leftUsd": { "type": [ "number", "null" ] }, "asOf": { "type": [ "string", "null" ] }, "cpm": { "type": "object", "properties": { "medianUsd": { "type": "number" }, "p25Usd": { "type": "number" }, "p75Usd": { "type": "number" }, "n": { "type": "number" }, "basis": { "type": "string", "const": "listed" }, "url": { "type": "string" } }, "required": [ "medianUsd", "p25Usd", "p75Usd", "n", "basis", "url" ], "additionalProperties": {} } }, "required": [ "live", "boards", "newToday", "leftUsd", "asOf" ], "additionalProperties": {} }, "filters": { "type": "object", "properties": { "platform": { "type": [ "string", "null" ] }, "type": { "anyOf": [ { "type": "string", "enum": [ "clipping", "ugc", "logo", "music" ] }, { "type": "null" } ] }, "savedOnly": { "type": "boolean" } }, "required": [ "platform", "type", "savedOnly" ], "additionalProperties": {} }, "topPicks": { "type": "array", "items": { "type": "object", "properties": { "campaignId": { "type": "string" }, "title": { "type": "string" }, "brand": { "type": "string" }, "brandSlug": { "type": "string" }, "seriesSlug": { "type": "string" }, "board": { "type": "string" }, "boardSlug": { "type": "string" }, "agency": { "type": [ "string", "null" ] }, "agencySlug": { "type": [ "string", "null" ] }, "state": { "type": "string" }, "campaignType": { "type": "string", "enum": [ "clipping", "ugc", "logo", "music" ] }, "payModel": { "type": "string" }, "platforms": { "type": "array", "items": { "type": "string" } }, "ratePer1kUsd": { "type": [ "number", "null" ] }, "budgetLeftUsd": { "type": [ "number", "null" ] }, "budgetTotalUsd": { "type": [ "number", "null" ] }, "alphaScore": { "type": [ "number", "null" ] }, "tier": { "type": "string", "enum": [ "alpha", "solid", "fair", "low", "scoring" ] }, "drainP50": { "type": [ "string", "null" ] }, "openJoin": { "type": "boolean" }, "exclusive": { "type": "boolean" }, "access": { "anyOf": [ { "type": "string", "enum": [ "exclusive", "apply" ] }, { "type": "null" } ] }, "niche": { "type": [ "string", "null" ] }, "membersOnly": { "type": "boolean" }, "ageRestricted": { "type": "boolean" }, "labels": { "type": "array", "items": { "type": "string" } }, "election": { "type": "boolean" }, "electionLabel": { "type": [ "string", "null" ] }, "electionNote": { "type": [ "string", "null" ] }, "audience": { "anyOf": [ { "type": "object", "properties": { "countries": { "type": "array", "items": { "type": "string" } }, "minSharePct": { "type": [ "number", "null" ] }, "language": { "type": [ "string", "null" ] } }, "required": [ "countries", "minSharePct", "language" ], "additionalProperties": {} }, { "type": "null" } ] }, "audienceLabel": { "type": [ "string", "null" ] }, "audienceNote": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "firstSeenAt": { "type": "string" }, "launchedAt": { "type": "string" }, "newAt": { "type": [ "string", "null" ] }, "pageUrl": { "type": "string" }, "joinUrl": { "type": "string" }, "forYou": { "type": "object", "properties": { "reason": { "type": "string" }, "estimateUsd": { "type": [ "number", "null" ] }, "application": { "type": "boolean" }, "moved": { "anyOf": [ { "type": "string", "enum": [ "joined", "skipped" ] }, { "type": "null" } ] }, "fit": { "type": "boolean" } }, "required": [ "reason", "estimateUsd", "application", "moved", "fit" ], "additionalProperties": {} }, "picture": { "anyOf": [ { "type": "object", "properties": { "src": { "type": "string" }, "src2x": { "type": [ "string", "null" ] }, "square": { "type": [ "string", "null" ] }, "alt": { "type": "string" }, "width": { "type": "number" }, "height": { "type": "number" }, "fit": { "type": "string", "enum": [ "cover", "contain" ] } }, "required": [ "src", "src2x", "square", "alt", "width", "height", "fit" ], "additionalProperties": {} }, { "type": "null" } ] }, "canCut": { "type": "boolean" } }, "required": [ "campaignId", "title", "brand", "brandSlug", "seriesSlug", "board", "boardSlug", "state", "campaignType", "payModel", "platforms", "ratePer1kUsd", "budgetLeftUsd", "budgetTotalUsd", "alphaScore", "tier", "drainP50", "openJoin", "exclusive", "access", "niche", "membersOnly", "ageRestricted", "labels", "election", "electionLabel", "electionNote", "firstSeenAt", "launchedAt", "newAt", "pageUrl", "joinUrl", "picture" ], "additionalProperties": {} } }, "campaigns": { "type": "array", "items": { "type": "object", "properties": { "campaignId": { "type": "string" }, "title": { "type": "string" }, "brand": { "type": "string" }, "brandSlug": { "type": "string" }, "seriesSlug": { "type": "string" }, "board": { "type": "string" }, "boardSlug": { "type": "string" }, "agency": { "type": [ "string", "null" ] }, "agencySlug": { "type": [ "string", "null" ] }, "state": { "type": "string" }, "campaignType": { "type": "string", "enum": [ "clipping", "ugc", "logo", "music" ] }, "payModel": { "type": "string" }, "platforms": { "type": "array", "items": { "type": "string" } }, "ratePer1kUsd": { "type": [ "number", "null" ] }, "budgetLeftUsd": { "type": [ "number", "null" ] }, "budgetTotalUsd": { "type": [ "number", "null" ] }, "alphaScore": { "type": [ "number", "null" ] }, "tier": { "type": "string", "enum": [ "alpha", "solid", "fair", "low", "scoring" ] }, "drainP50": { "type": [ "string", "null" ] }, "openJoin": { "type": "boolean" }, "exclusive": { "type": "boolean" }, "access": { "anyOf": [ { "type": "string", "enum": [ "exclusive", "apply" ] }, { "type": "null" } ] }, "niche": { "type": [ "string", "null" ] }, "membersOnly": { "type": "boolean" }, "ageRestricted": { "type": "boolean" }, "labels": { "type": "array", "items": { "type": "string" } }, "election": { "type": "boolean" }, "electionLabel": { "type": [ "string", "null" ] }, "electionNote": { "type": [ "string", "null" ] }, "audience": { "anyOf": [ { "type": "object", "properties": { "countries": { "type": "array", "items": { "type": "string" } }, "minSharePct": { "type": [ "number", "null" ] }, "language": { "type": [ "string", "null" ] } }, "required": [ "countries", "minSharePct", "language" ], "additionalProperties": {} }, { "type": "null" } ] }, "audienceLabel": { "type": [ "string", "null" ] }, "audienceNote": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "firstSeenAt": { "type": "string" }, "launchedAt": { "type": "string" }, "newAt": { "type": [ "string", "null" ] }, "pageUrl": { "type": "string" }, "joinUrl": { "type": "string" }, "forYou": { "type": "object", "properties": { "reason": { "type": "string" }, "estimateUsd": { "type": [ "number", "null" ] }, "application": { "type": "boolean" }, "moved": { "anyOf": [ { "type": "string", "enum": [ "joined", "skipped" ] }, { "type": "null" } ] }, "fit": { "type": "boolean" } }, "required": [ "reason", "estimateUsd", "application", "moved", "fit" ], "additionalProperties": {} }, "picture": { "anyOf": [ { "type": "object", "properties": { "src": { "type": "string" }, "src2x": { "type": [ "string", "null" ] }, "square": { "type": [ "string", "null" ] }, "alt": { "type": "string" }, "width": { "type": "number" }, "height": { "type": "number" }, "fit": { "type": "string", "enum": [ "cover", "contain" ] } }, "required": [ "src", "src2x", "square", "alt", "width", "height", "fit" ], "additionalProperties": {} }, { "type": "null" } ] }, "canCut": { "type": "boolean" } }, "required": [ "campaignId", "title", "brand", "brandSlug", "seriesSlug", "board", "boardSlug", "state", "campaignType", "payModel", "platforms", "ratePer1kUsd", "budgetLeftUsd", "budgetTotalUsd", "alphaScore", "tier", "drainP50", "openJoin", "exclusive", "access", "niche", "membersOnly", "ageRestricted", "labels", "election", "electionLabel", "electionNote", "firstSeenAt", "launchedAt", "newAt", "pageUrl", "joinUrl", "picture" ], "additionalProperties": {} } }, "total": { "type": "number" }, "membersLocked": { "type": "number" }, "signedIn": { "type": "boolean" }, "saved": { "type": "array", "items": { "type": "string" } } }, "required": [ "market", "filters", "topPicks", "campaigns", "total", "membersLocked", "signedIn", "saved" ], "additionalProperties": {} }, "my_saved_campaigns_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": {} }, "my_saved_campaigns_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "saved": { "type": "array", "items": { "type": "object", "properties": { "seriesId": { "type": [ "string", "null" ] }, "brand": { "type": [ "string", "null" ] }, "brandSlug": { "type": [ "string", "null" ] }, "seriesSlug": { "type": [ "string", "null" ] }, "state": { "type": [ "string", "null" ] }, "savedAt": { "type": "string" }, "pageUrl": { "type": "string" } }, "required": [ "seriesId", "brand", "brandSlug", "seriesSlug", "state", "savedAt", "pageUrl" ], "additionalProperties": {} } } }, "required": [ "saved" ], "additionalProperties": {} }, "save_campaign_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "campaign": { "type": "string", "minLength": 3, "maxLength": 300, "description": "brand/series, for example lovable/clipping, or its page URL." }, "saved": { "description": "true to save (the default), false to remove.", "type": "boolean" } }, "required": [ "campaign" ] }, "save_campaign_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "saved": { "type": "boolean" }, "campaign": { "type": "string" }, "pageUrl": { "type": "string" } }, "required": [ "saved", "campaign", "pageUrl" ], "additionalProperties": {} }, "my_alert_rules_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": {} }, "my_alert_rules_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "rules": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "channels": { "type": "array", "items": { "type": "string" } }, "settings": { "anyOf": [ { "type": "object", "properties": {}, "additionalProperties": {} }, { "type": "null" } ] } }, "required": [ "rules", "channels", "settings" ], "additionalProperties": {} }, "set_alert_rule_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "rule_id": { "description": "Change this rule. Leave out to add a new one.", "type": "string", "pattern": "^\\d{1,18}$" }, "min_rate_per_1k_usd": { "description": "Minimum pay per 1,000 views in USD, rounded down to $0.50 steps. 0 for any.", "type": "number", "minimum": 0, "maximum": 100 }, "platforms": { "description": "Social apps the clipper posts on. Empty for every app.", "maxItems": 9, "type": "array", "items": { "type": "string", "enum": [ "tiktok", "instagram", "youtube", "x", "facebook", "twitch", "kick", "threads", "snapchat" ] } }, "niches": { "description": "Content niches. Empty for every niche.", "maxItems": 12, "type": "array", "items": { "type": "string", "enum": [ "podcast", "streams", "gaming", "sports", "film-and-tv", "music", "brand-ads", "ugc-and-apps", "behind-the-scenes", "gambling", "prediction-markets", "crypto-trading" ] } }, "boards": { "description": "Clipping platforms. Empty for every clipping platform.", "maxItems": 6, "type": "array", "items": { "type": "string", "enum": [ "content-rewards", "promote-fun", "clipster", "clipstake", "vyro", "evangelist" ] } }, "min_tier": { "description": "Lowest Alpha tier to alert on.", "type": "string", "enum": [ "alpha", "solid", "fair" ] }, "pay_type": { "description": "per_view pays per 1K views (the default), per_post pays a flat amount a post, any takes both.", "type": "string", "enum": [ "per_view", "per_post", "any" ] }, "open_join_only": { "description": "Only campaigns anyone can join with no application.", "type": "boolean" }, "active": { "description": "false pauses the rule.", "type": "boolean" }, "mode": { "description": "custom (the default) sets a rule by the filters above. personalised sets the one Personalised alert, which fits the clipper's connected account, and ignores the filters.", "type": "string", "enum": [ "custom", "personalised" ] }, "cadence": { "description": "Personalised only: instant as campaigns launch (the default), or daily for one digest at 09:00 in the clipper's time zone.", "type": "string", "enum": [ "instant", "daily" ] } } }, "set_alert_rule_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "rule": { "type": "object", "properties": { "ruleId": { "type": "string" }, "active": { "type": "boolean" } }, "required": [ "ruleId", "active" ], "additionalProperties": {} } }, "required": [ "rule" ], "additionalProperties": {} }, "delete_alert_rule_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "rule_id": { "type": "string", "pattern": "^\\d{1,18}$", "description": "The rule to delete." } }, "required": [ "rule_id" ] }, "delete_alert_rule_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean" } }, "required": [ "deleted" ], "additionalProperties": {} }, "my_referral_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": {} }, "my_referral_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "link": { "anyOf": [ { "type": "object", "properties": { "url": { "type": "string" }, "handle": { "type": "string" } }, "required": [ "url", "handle" ], "additionalProperties": {} }, { "type": "null" } ] }, "profileUrl": { "type": "string" }, "counted": { "type": "number" }, "next": { "anyOf": [ { "type": "object", "properties": { "badge": { "type": "string" }, "friendsLeft": { "type": "number" } }, "required": [ "badge", "friendsLeft" ], "additionalProperties": {} }, { "type": "null" } ] }, "verified": { "type": "boolean" }, "friendReward": { "type": "object", "properties": { "clips": { "type": "number" }, "when": { "type": "string" } }, "required": [ "clips", "when" ], "additionalProperties": {} }, "ladder": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "friends": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "rewardsAre": { "type": "string" } }, "required": [ "link", "profileUrl", "counted", "next", "verified", "friendReward", "ladder", "friends", "rewardsAre" ], "additionalProperties": {} }, "cut_clips_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "campaign": { "type": "string", "minLength": 1, "maxLength": 300, "description": "The campaign as brand/series, its page URL or its campaignId." }, "clips": { "description": "The clip numbers of the campaign's creative plan, for example [1, 2, 3].", "maxItems": 5, "type": "array", "items": { "type": "integer", "minimum": 1, "maximum": 200 } }, "ranges": { "description": "Or exact ranges of the campaign's videos or brand files.", "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "source_id": { "type": "string", "pattern": "^\\d{1,18}$", "description": "The sourceId of one of the campaign's videos or brand files, as an earlier signed-in answer gave it." }, "start_sec": { "type": "number", "minimum": 0, "maximum": 100000, "description": "Where the clip starts, in seconds of the source." }, "end_sec": { "type": "number", "minimum": 0, "maximum": 100000, "description": "Where it ends, 3 seconds to 3 minutes after the start." } }, "required": [ "source_id", "start_sec", "end_sec" ] } }, "edit": { "description": "Or one mix of your own: 2 to 4 segments of the campaign's videos, cut into one vertical edit.", "type": "object", "properties": { "segments": { "minItems": 2, "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "source_id": { "type": "string", "pattern": "^\\d{1,18}$", "description": "The sourceId of one of the campaign's videos or brand files." }, "start_sec": { "type": "number", "minimum": 0, "maximum": 100000, "description": "Where this segment starts, in seconds of that video." }, "end_sec": { "type": "number", "minimum": 0, "maximum": 100000, "description": "Where it ends, at least 3 seconds later." } }, "required": [ "source_id", "start_sec", "end_sec" ] }, "description": "2 to 4 segments in the order they play, the hook first, 20 to 45 seconds in all." } }, "required": [ "segments" ] }, "app": { "description": "Set only by the ClippingAlpha app in the chat, to count its steps. Leave it out.", "type": "string", "enum": [ "make_clips", "plan_video", "cut", "poll", "download", "submit" ] } }, "required": [ "campaign" ] }, "cut_clips_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "campaign": { "type": "string" }, "clipIds": { "type": "array", "items": { "type": "string" } }, "clips": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "open": { "type": "number" } }, "required": [ "campaign", "clipIds", "clips", "open" ], "additionalProperties": {} }, "my_clips_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "clip_ids": { "description": "The clip ids of an earlier answer. Leave out for the last 24 hours.", "maxItems": 20, "type": "array", "items": { "type": "string", "pattern": "^\\d{1,18}$" } }, "app": { "description": "Set only by the ClippingAlpha app in the chat, to count its steps. Leave it out.", "type": "string", "enum": [ "make_clips", "plan_video", "cut", "poll", "download", "submit" ] } } }, "my_clips_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "clips": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "open": { "type": "number" } }, "required": [ "clips", "open" ], "additionalProperties": {} }, "connect_account_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "platform": { "type": "string", "enum": [ "tiktok", "instagram", "youtube", "x" ], "description": "The social app: tiktok, instagram, youtube or x." }, "handle": { "type": "string", "minLength": 1, "maxLength": 200, "description": "The account's handle, as @name, name or its profile link." } }, "required": [ "platform", "handle" ] }, "connect_account_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "account": { "type": "object", "properties": { "id": { "type": "string" }, "platform": { "type": "string" }, "handle": { "type": "string" }, "profileUrl": { "type": "string" }, "state": { "type": "string" }, "stateText": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "codeExpiresAt": { "type": [ "string", "null" ] }, "followers": { "type": [ "number", "null" ] }, "reason": { "type": [ "string", "null" ] }, "reasonText": { "type": [ "string", "null" ] } }, "required": [ "id", "platform", "handle", "profileUrl", "state", "stateText", "code", "codeExpiresAt", "followers", "reason", "reasonText" ], "additionalProperties": {} }, "next": { "type": "string", "enum": [ "add_code", "ask_again", "connected" ] } }, "required": [ "account", "next" ], "additionalProperties": {} }, "check_account_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "handle": { "description": "The account's handle, as @name, name or its profile link.", "type": "string", "minLength": 1, "maxLength": 200 }, "platform": { "type": "string", "enum": [ "tiktok", "instagram", "youtube", "x" ], "description": "The social app: tiktok, instagram, youtube or x." }, "id": { "description": "The account id of an earlier answer.", "type": "string", "pattern": "^\\d{1,18}$" }, "recheck": { "description": "True to read the profile again after a failed check, once the clipper says they fixed it.", "type": "boolean" } } }, "check_account_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "account": { "type": "object", "properties": { "id": { "type": "string" }, "platform": { "type": "string" }, "handle": { "type": "string" }, "profileUrl": { "type": "string" }, "state": { "type": "string" }, "stateText": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "codeExpiresAt": { "type": [ "string", "null" ] }, "followers": { "type": [ "number", "null" ] }, "reason": { "type": [ "string", "null" ] }, "reasonText": { "type": [ "string", "null" ] } }, "required": [ "id", "platform", "handle", "profileUrl", "state", "stateText", "code", "codeExpiresAt", "followers", "reason", "reasonText" ], "additionalProperties": {} }, "next": { "type": "string", "enum": [ "ask_again", "connected", "fix" ] } }, "required": [ "account", "next" ], "additionalProperties": {} }, "my_accounts_input": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": {} }, "my_accounts_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "accounts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "platform": { "type": "string" }, "handle": { "type": "string" }, "profileUrl": { "type": "string" }, "state": { "type": "string" }, "stateText": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "codeExpiresAt": { "type": [ "string", "null" ] }, "followers": { "type": [ "number", "null" ] }, "reason": { "type": [ "string", "null" ] }, "reasonText": { "type": [ "string", "null" ] } }, "required": [ "id", "platform", "handle", "profileUrl", "state", "stateText", "code", "codeExpiresAt", "followers", "reason", "reasonText" ], "additionalProperties": {} } }, "max": { "type": "number" } }, "required": [ "accounts", "max" ], "additionalProperties": {} } } }