{ "openapi": "3.0.1", "info": { "title": "Meta Branded Content Scraper: Paid Partnerships", "description": "Meta branded content scraper, no login: every Instagram and Facebook post marked as a paid partnership for the brands or creators you name. Rows carry the creator, each brand partner, the date, type and link, with follower counts and optional captions and likes. Monitor new posts; CSV or API.", "version": "0.1", "x-build-id": "olwXE6Y38A4ifrZXg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation_craft~meta-branded-content-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation_craft-meta-branded-content-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/automation_craft~meta-branded-content-scraper/runs": { "post": { "operationId": "runs-sync-automation_craft-meta-branded-content-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/automation_craft~meta-branded-content-scraper/run-sync": { "post": { "operationId": "run-sync-automation_craft-meta-branded-content-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": { "accounts": { "title": "Brands or creators", "type": "array", "description": "One per line: a brand or creator name as it is written on Instagram or Facebook (Sephora), an @handle (@sephora), a profile URL (https://www.instagram.com/sephora/ or https://www.facebook.com/sephora), a branded content library URL, or an account id. A name is read only when exactly one account in the library's search box has that exact handle or name; otherwise you get a free row with the accounts it suggests. Up to 200 per run; accounts without partnerships in the days asked are read free, about five per run (the README's \"Accounts without partnerships\").", "items": { "type": "string" } }, "platforms": { "title": "Apps", "type": "array", "description": "Instagram, Facebook or both. Names and @handles are looked up on each app chosen; a profile or library URL says its app itself. Left empty: both apps.", "items": { "type": "string", "enum": [ "instagram", "facebook" ], "enumTitles": [ "Instagram", "Facebook" ] } }, "startDate": { "title": "From date", "type": "string", "description": "The first day to include: YYYY-MM-DD, today, yesterday, or a relative date such as 30 days, 6 months or 1 year. Days are the library's own, in US Pacific time. Left empty: 2023-08-17, the first day the library holds." }, "endDate": { "title": "To date", "type": "string", "description": "The last day to include (inclusive): YYYY-MM-DD, today, yesterday or a relative date. Left empty: up to today." }, "maxPartnershipsPerAccount": { "title": "Most partnerships per account", "minimum": 1, "maximum": 100000, "type": "integer", "description": "New partnership rows per account and app, newest first. Left empty: 1,000." }, "maxPartnerships": { "title": "Most partnerships per run", "minimum": 1, "maximum": 100000, "type": "integer", "description": "New partnership rows for the whole run. Left empty: 10,000." }, "postDetails": { "title": "Post details (Instagram)", "type": "boolean", "description": "Read each delivered Instagram post or reel's own page and add its caption, like count, comment count, exact posting time and coauthors. Charged per row read (the Post details event); stories and Facebook rows are not read and never charged for it." }, "memoryName": { "title": "Memory name (new posts only)", "type": "string", "description": "Give a name to deliver and charge only partnerships not delivered under that name before. The memory also remembers which days of each account were read in full and reads only the newest 7 days of them again, so a scheduled run costs about one page per account. A memory belongs to this Actor." }, "resetMemory": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything the named memory holds before this run (every partnership counts as new again)." } } }, "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 } } } } } } } } } }