{ "openapi": "3.0.1", "info": { "title": "Influencer #ad Disclosure Checker: FTC & ASA", "description": "Check influencer captions and video descriptions for missing or unclear #ad disclosures under FTC Endorsement Guides, the ASA/CAP 2026 influencer guide and CMA, plus German and French rules. Flags codes, affiliate links and gifted posts without a clear upfront label, with quote, rule link and fix.", "version": "0.1", "x-build-id": "WmseKvaFkXK20BbA6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ultimatemc~influencer-ad-disclosure-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ultimatemc-influencer-ad-disclosure-checker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ultimatemc~influencer-ad-disclosure-checker/runs": { "post": { "operationId": "runs-sync-ultimatemc-influencer-ad-disclosure-checker", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ultimatemc~influencer-ad-disclosure-checker/run-sync": { "post": { "operationId": "run-sync-ultimatemc-influencer-ad-disclosure-checker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "texts": { "title": "Captions / post texts to check", "type": "array", "description": "Instagram, TikTok, YouTube, X or Facebook captions, video descriptions or scripts, one per line. The prefill has three examples; replace them with your own.", "items": { "type": "string" } }, "items": { "title": "Posts (advanced, optional)", "type": "array", "description": "One object per post with your own \"id\" and \"text\" (or \"caption\"), plus optional \"platform\" (instagram, tiktok, youtube, x, facebook...), \"relationship\" (paid, gifted, affiliate, employee, own-brand, none, unknown) and \"isPaidPartnership\" (true if the platform's paid-partnership tag is on). Example: [{\"id\": \"post-1\", \"text\": \"Loving these trainers!\", \"platform\": \"instagram\", \"relationship\": \"gifted\"}]" }, "datasetId": { "title": "Dataset ID (optional)", "type": "string", "description": "Check the output of another Actor, e.g. an Instagram, TikTok or YouTube scraper. Caption/text/description fields, the post URL and paid-partnership flags (isPaidPartnership, isSponsored, isAd...) are detected automatically." }, "textFields": { "title": "Dataset fields to check (optional)", "type": "array", "description": "Field names to read from dataset items, e.g. \"caption\". Leave empty to use the first of caption, text, fullText, description, desc, content, title.", "items": { "type": "string" } }, "jurisdictions": { "title": "Rules to apply", "type": "array", "description": "US = FTC Endorsement Guides (16 CFR 255). UK = ASA/CAP influencer guide (4th edition, Oct 2026) and CMA. Germany = Medienanstalten guide ('Werbung'/'Anzeige'). France = Law 2023-451 ('Publicité'/'Collaboration commerciale'). DE/FR rules apply only to German/French-language posts unless you turn off language detection.", "items": { "type": "string", "enum": [ "us", "uk", "de", "fr" ], "enumTitles": [ "US (FTC)", "UK (ASA/CAP, CMA)", "Germany (Medienanstalten)", "France (Law 2023-451)" ] }, "default": [ "us", "uk" ] }, "relationship": { "title": "Brand relationship (default for all posts)", "enum": [ "unknown", "paid", "gifted", "affiliate", "employee", "own-brand", "none" ], "type": "string", "description": "If you know the relationship (e.g. you're checking a campaign), set it: then a post with no label is flagged even when the text has no clues. 'unknown' = detect from the text only.", "default": "unknown" }, "platform": { "title": "Platform", "enum": [ "auto", "instagram", "tiktok", "youtube", "x", "facebook", "linkedin", "threads", "pinterest", "twitch", "other" ], "type": "string", "description": "Used for video notes and '#BrandPartner' tags (OK on X under FTC guidance). 'auto' reads it from the post URL.", "default": "auto" }, "visibleChars": { "title": "Characters visible before 'more'", "minimum": 20, "maximum": 5000, "type": "integer", "description": "A label after this many characters counts as hidden below 'more'. 125 is a common Instagram feed cut-off; use about 100 for TikTok or YouTube descriptions.", "default": 125 }, "languageAware": { "title": "Apply DE/FR rules only to German/French text", "type": "boolean", "description": "On by default. Turn off to apply the German or French label rules to every post.", "default": true }, "minSeverity": { "title": "Minimum severity to report", "enum": [ "low", "medium", "high" ], "type": "string", "description": "Hide findings below this level.", "default": "low" }, "onlyFlagged": { "title": "Only save posts with findings", "type": "boolean", "description": "Skip posts with no findings (you are only charged for saved rows).", "default": false }, "maxItems": { "title": "Max posts", "minimum": 1, "type": "integer", "description": "Stop after this many posts.", "default": 1000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }