{ "openapi": "3.0.1", "info": { "title": "Facebook Photos Scraper + Tagged Photos Extractor", "description": "This Facebook Photos Scraper collects public photos from profiles, pages, posts, and albums. Capture image links, timestamps, captions, and more. Great for digital marketers, analysts, and developers needing structured visual datasets quickly and efficiently.", "version": "0.1", "x-build-id": "yi53VebgtPraz3lXQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~facebook-photos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-facebook-photos-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/scrapier~facebook-photos-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-facebook-photos-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/scrapier~facebook-photos-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-facebook-photos-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": { "profileTargets": { "title": "🌐 Profile / page targets", "type": "array", "description": "One public profile or page per line — full URL or short handle (e.g. `IamSRK` or `https://www.facebook.com/IamSRK`). Example: two handles -> two chronological timelines. Accepts the legacy `startUrls` key as a fallback.", "items": { "type": "string" } }, "photoBudget": { "title": "🔢 Photo budget per target", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum photos to KEEP per target after date filtering and ordering (1–10,000). Example: photoBudget=25 + photoOrder=newest -> the 25 most recent photos inside your window. Default is 10. Accepts the legacy `maxPhotos` key as a fallback." }, "capturedAfter": { "title": "📅 Captured after", "type": "string", "description": "Keep only photos uploaded ON or AFTER this moment. Accepts an absolute date (`2024-01-01`) or a relative value (`3 months`, `1 year`). Leave empty for no lower bound. Example: capturedAfter=`6 months` -> only photos from the last half year." }, "capturedBefore": { "title": "📅 Captured before", "type": "string", "description": "Keep only photos uploaded ON or BEFORE this moment. Accepts an absolute date (`2025-06-30`) or a relative value (`1 week`). Leave empty for no upper bound. Example: capturedAfter=`2024-01-01` + capturedBefore=`2024-12-31` -> the full 2024 timeline." }, "photoOrder": { "title": "↕️ Timeline order", "enum": [ "newest", "oldest" ], "type": "string", "description": "Chronological ordering of the delivered archive. `newest` = most recent uploads first; `oldest` = earliest uploads first. Each row also carries a derived `photoAgeDays`. Default is newest.", "default": "newest" }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Facebook intermittently blocks logged-out traffic; residential Apify Proxy raises success rates on public timelines. Example: enable Apify Proxy with the RESIDENTIAL group for the most reliable coverage." } } }, "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 } } } } } } } } } }