{ "openapi": "3.0.1", "info": { "title": "LinkedIn Ads Transcript Scraper — Video Hooks & CTAs", "description": "Charged only when a transcript is delivered — image, silent and blocked ads are free rows. No cookies, no login. LinkedIn Ad Library video ads → transcript, first-3s hook, advertiser metadata. Search by advertiser or keyword: it finds the video ads for you. No start fee.", "version": "1.0", "x-build-id": "KFAilkN7a8sRhhyH0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadyfetch~linkedin-ads-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadyfetch-linkedin-ads-transcript-scraper", "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/steadyfetch~linkedin-ads-transcript-scraper/runs": { "post": { "operationId": "runs-sync-steadyfetch-linkedin-ads-transcript-scraper", "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/steadyfetch~linkedin-ads-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-steadyfetch-linkedin-ads-transcript-scraper", "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": { "accountOwners": { "title": "Advertiser names", "type": "array", "description": "Company names as they appear in the Ad Library (e.g. \"Salesforce\", \"HubSpot\"). Each is searched with the Ad Library's own advertiser search.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Free-text Ad Library searches (e.g. \"crm software\", \"recruiting\"). Finds video ads across many advertisers in a niche.", "items": { "type": "string" } }, "videoUrls": { "title": "Ad URLs or video URLs", "type": "array", "description": "Ad Library detail URLs (linkedin.com/ad-library/detail/…), numeric ad IDs, or direct video URLs (dms.licdn.com/playlist/vid/…) from any LinkedIn Ad Library scraper result.", "items": { "type": "string" } }, "datasetId": { "title": "Dataset ID (chain a scraper run)", "type": "string", "description": "The default dataset ID of a finished LinkedIn Ad Library scraper run. With Apify's 'Connect actor' integration this is filled automatically — the cleanest way to chain." }, "datasetItems": { "title": "Dataset items (paste rows)", "type": "array", "description": "Paste rows from your Ad Library scraper run. The actor deep-scans each row for video URLs, ad detail links, and metadata — works with any scraper's output shape. Non-video rows come back as uncharged metadata rows. The prefilled demo row shows the honesty contract: it returns one uncharged row — replace it with your own rows, or use the search fields above." }, "includeImageText": { "title": "Read the text on image ads", "type": "boolean", "description": "ON (default): image ads get their on-image copy read and delivered as `imageText` — each delivered extraction is charged like a video transcript (same event, same price; never a long-video surcharge). Image ads with no readable text are always free. Most LinkedIn ads are image ads, so a keyword run charges for many more rows with this on than a video-only run did — set `maxItems` and the run's max total charge to match. OFF: image ads pass through free with their metadata, as before.", "default": true }, "includeOnScreenText": { "title": "Read on-screen text on silent video ads", "type": "boolean", "description": "OFF (default): a video ad with no speech is never charged. ON: silent and music-only video ads have their on-screen text read from the video's own frames and delivered as `onScreenText`, charged like a transcript. Ads with no readable on-screen text stay free either way. About half of LinkedIn's video ads are silent.", "default": false }, "includeNonVideo": { "title": "Include the remaining formats as uncharged rows", "type": "boolean", "description": "When searching by advertiser/keyword, also output one uncharged metadata row (advertiser, format, ad link) for each creative this actor does not read — document, carousel, article, message and text-only ads. Off by default.", "default": false }, "maxItems": { "title": "Max ads to process", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Safety cap on how many ads to process in one run (every attempted video ad and image ad counts toward it, including uncharged misses; the formats above never do).", "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 } } }, "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 } } } } } } } } } }