{ "openapi": "3.0.1", "info": { "title": "Facebook Photos Scraper ✨", "description": "Facebook Photos Scraper Returns caption, own photos, tagged photos & albums, image height, full-res image URLs, image width, number, photo details, album details, photo id, photo type, profile url, thumbnail url, type, url for every row ✨", "version": "1.0", "x-build-id": "53G182mQaTauGuATX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/premiumscraper~facebook-photos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-premiumscraper-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/premiumscraper~facebook-photos-scraper/runs": { "post": { "operationId": "runs-sync-premiumscraper-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/premiumscraper~facebook-photos-scraper/run-sync": { "post": { "operationId": "run-sync-premiumscraper-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": { "username": { "title": "Facebook Username(s)", "type": "array", "description": "Enter one or more usernames (e.g., Cristiano, IamSRK, nike). Each will be auto-converted to a full profile URL.", "items": { "type": "string" } }, "facebook_urls": { "title": "Facebook Profile / Page URLs", "type": "array", "description": "One or more Facebook URLs. Supported formats:\n• Username: Cristiano\n• Profile URL: https://www.facebook.com/Cristiano\n• People URL: https://www.facebook.com/people/Page-Name/123456789/", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "photos_count": { "title": "Number of Photos to Scrape", "minimum": 1, "maximum": 50000, "type": "integer", "description": "How many photos to scrape per tab per profile (1–10,000). Own photos are always scraped. If Tagged Photos or Albums are enabled, this limit applies to each of those tabs independently as well.", "default": 10 }, "scrape_photos_of": { "title": "Also Scrape Tagged Photos ($)", "type": "boolean", "description": "In addition to own photos, also scrape photos where this profile/person is tagged by others.\n\n⚠️ Enabling this adds an extra per-photo charge on top of the base photo price.", "default": false }, "scrape_photos_albums": { "title": "Also Scrape Albums ($)", "type": "boolean", "description": "In addition to own photos, also scrape photo albums. Returns album cover image, title, and item count. (Does not scrape individual photos inside each album.)\n\n⚠️ Enabling this adds an extra per-album charge on top of the base photo price.", "default": false }, "photos_newer_than": { "title": "Photos Newer Than ($)", "type": "string", "description": "Only scrape photos created AFTER this date. Leave empty for no lower date limit.\n\n⚠️ Enabling this filter adds an extra per-photo charge on top of the base photo price." }, "photos_older_than": { "title": "Photos Older Than ($)", "type": "string", "description": "Only scrape photos created BEFORE this date. Leave empty for no upper date limit.\n\n⚠️ Enabling this filter adds an extra per-photo charge on top of the base photo price." }, "keyValueStorePrefix": { "title": "Custom Storage Name / Prefix", "type": "string", "description": "Enter a custom storage name (e.g. `Cristiano` or `my_store_1`). ⚠️ RULES: Only letters (a-z, A-Z), numbers (0-9), hyphens (-) and underscores (_), max 63 characters. Leave empty to use the default unnamed storage." }, "storePhotos": { "title": "📸 Store Photos in Cloud Storage ($)", "type": "boolean", "description": "If ON, each photo is downloaded and saved to permanent cloud storage with a non-expiring download URL added to the output row. Extra charge applies per photo saved.", "default": false } } }, "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 } } } } } } } } } }