# Facebook Photos Scraper - Pages, Albums, Tagged & Group Photos (`topapi/facebook-photos-scraper`) Actor Scrape every public photo of a Facebook Page, profile, album or group: full-size image URL, size, alt text and link. Optional details: upload date, caption, reactions, comments, shares and tags. Date window, album list, monitor mode for new photos. $0.90 per 1,000 photos. No login or cookies. - **URL**: https://apify.com/topapi/facebook-photos-scraper.md - **Developed by:** [Top Api](https://apify.com/topapi) (community) - **Categories:** Social media, Marketing, AI - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.90 / 1,000 photos This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### What does Facebook Photos Scraper do? **Facebook Photos Scraper** extracts Facebook photos from public Pages, profiles, albums and groups and turns each photo into a structured row: the full-size image URL, its width and height, Facebook's own alt text and the photo link. Turn on details and every row also gets the upload date, caption, reactions, comment and share counts, the post link and the people tagged. Built for brand monitoring, competitor creative research, image datasets and archiving. Also searched as: Facebook image scraper Β· Facebook photo downloader Β· Facebook album scraper Β· Facebook page photos API Facebook Page photos tab that Facebook Photos Scraper turns into rows - **Every photo of a Page, newest first:** the Page's own photos, the photos others tagged it in, or both, plus each album's photos and a list of its albums. - **Full-size images:** the image Facebook shows in its photo viewer (up to 2048 px wide) and the grid thumbnail, with the true width and height. - **Photo details on request:** upload date, caption, reactions by type, comments, shares, post link, album, tagged people, uploader and privacy. - **Facebook's own date window:** a year, a month or any date range; Facebook filters the photos itself, so a narrow window costs no extra requests. - **Monitor mode:** a scheduled run returns only photos no earlier run delivered. - **Save image files:** optionally download each image into your key-value store and get a permanent link (Facebook's own image links expire after a few days). - **No login, cookies or Facebook API key:** paste Page, album, group or photo links, or just usernames. - **Export anywhere:** JSON, CSV, Excel, XML; schedules, webhooks, Make, Zapier, n8n, Google Sheets and the Apify MCP server. ### What data can you get from Facebook photos?
πŸ–ΌοΈ Full-size image URL (`image`) πŸ“ Width Γ— height πŸ”— Photo link and id
🦯 Facebook's alt text (`ocrText`) 🏷️ Source: own / tagged / album / group πŸ”’ Position, newest first
πŸ“… Upload date (`createdTime`) πŸ“ Caption ❀️ Reactions, total and by type
πŸ’¬ Comment count πŸ” Share count πŸ“° Post id and link
πŸ“š Album id and title πŸ‘₯ Tagged people πŸ‘€ Uploader, verified badge
🏒 Page name, id, followers πŸ“£ Page's Ad Library id πŸ’Ύ Saved image link (`imageStoredUrl`)
On a 75-photo test run with details (NASA, Mark Zuckerberg, The Copper Kettle Restaurant) the image, size, alt text, upload date, reactions, comments, shares and post link were filled on 100% of rows and the caption on 93%. On a tagged-photos run (20 photos) every row named the tagged people. ### How to scrape Facebook photos with Facebook Photos Scraper 1. [Create a free Apify account](https://console.apify.com/sign-up). The free plan includes $5 of monthly credit and needs no card. 2. Open [Facebook Photos Scraper](https://apify.com/topapi/facebook-photos-scraper) and click **Try for free**. 3. Paste Facebook Page, profile, album, group or photo links into **Facebook URLs** (or usernames into **Page usernames or ids**) and set **Photos per source**. 4. Optional: pick **Which photos**, a date window, and **Add photo details**. 5. Click **Start**. Photos stream into the dataset as they are read. 6. Open the **Storage** tab and **Export** as JSON, CSV or Excel, or schedule the run. ### ⬇️ Input | Parameter | Type | Description | |---|---|---| | **πŸ” What to scrape** | | | | `startUrls` | List of `{ "url": … }` | Page or profile (`https://www.facebook.com/NASA`, `profile.php?id=…`, `/people/…/`), album (`/media/set/?set=a.`), group (`/groups/`) or photo (`/photo/?fbid=…`) links. Prefill: humansofnewyork | | `pageNames` | List | Usernames or numeric ids instead of URLs, e.g. `NASA`, `100044561550831` | | `photoType` | Select | `photos_by` (posted by the Page), `photos_of` (tagged photos) or `both`. Default: `photos_by` | | **🎯 Filters** (applied by Facebook) | | | | `onlyPhotosNewerThan` | Date | Uploaded on or after: `2026-01-01` or relative `30 days`, `6 months` | | `onlyPhotosOlderThan` | Date | Uploaded before this date | | `dateFilter` | Text | A year (`2025`) or a month (`2025-06`), like Facebook's own photo filter | | **βœ‚οΈ Refine results** | | | | `keywords` / `excludeKeywords` | List | Keep / drop photos whose alt text (and caption, with details on) contains a word | | `minWidth` | Integer | Minimum image width in pixels | | `minReactions` | Integer | Minimum reactions (needs details) | | **βž• Extra data** | | | | `includeDetails` | Boolean | Upload date, caption, reactions, comments, shares, post, album, tags, uploader, privacy. Charged as **Photo details**. Default: `false` | | `includeAlbums` | Boolean | One row per album: title, item count, cover, link. Charged as **Album** | | `includeAlbumPhotos` | Boolean | Also walk the photos inside each album, with the album on each row | | `maxAlbums` / `maxPhotosPerAlbum` | Integer | Albums per Page (default `10`) and photos per album (default `50`, `0` = all) | | `includePageContext` | Boolean | Add the Page's category (one extra page load per Page, no extra charge) | | `storeImages` / `imageStoreName` | Boolean / Text | Save each image file to a named key-value store. Charged as **Image stored** | | **πŸ” Monitoring** | | | | `monitorMode` / `monitorStoreName` | Boolean / Text | Return only photos not delivered by earlier runs with the same store. Pair with a schedule | | **πŸ“¦ Output** | | | | `resultsLimit` | Integer | Photos per source (per tab when `both`). Default `50`, prefill `20`, `0` = all (up to 10,000) | | `maxItems` | Integer | Rows in total across all sources. `0` = no limit | | `compact` | Boolean | Core columns only, for AI agents and MCP | | **βš™οΈ Advanced** | | | | `proxyConfiguration` | Proxy | Leave off: the run starts without a proxy and moves to the Apify datacenter proxy, then RESIDENTIAL, only if Facebook refuses it | | `maxConcurrency` / `concurrentPhotos` | Integer | Sources read in parallel (default `3`) / detail requests in flight per source (default `8`) | #### Input JSON ```json { "startUrls": [{ "url": "https://www.facebook.com/NASA" }], "photoType": "photos_by", "resultsLimit": 100, "onlyPhotosNewerThan": "2026-01-01", "includeDetails": true } ``` #### Paste the Page, not a post A Page or profile link reads its whole photo library. A post link is not a photo source: open the photo and paste its `/photo/?fbid=` link, or paste the Page. Accepted: `https://www.facebook.com/NASA`, `NASA`, `https://www.facebook.com/profile.php?id=100044561550831`. Rejected (listed in the run summary): event, search and share links. #### Use the date window instead of a large limit On Pages and profiles the date window is applied by Facebook: `"dateFilter": "2025"` returned exactly the 220 photos Humans of New York posted in 2025 in 28 requests. Album and group photos are dated one by one (their grids ignore Facebook's filter), so a window there costs one detail request per photo checked. #### Use both tabs for brand monitoring `"photoType": "both"` adds the photos other people tagged the Page in. The limit applies to each tab, so `resultsLimit: 50` returns up to 50 own photos and 50 tagged ones. ### ⬆️ Output Every photo becomes one dataset item. Here is a table of a real run on NASA's Page with details on: Facebook Photos Scraper output table with image, alt text, size, date, caption and engagement The same row as JSON (long values trimmed here): ```json { "dataType": "photo", "id": "1652244872937549", "url": "https://www.facebook.com/photo.php?fbid=1652244872937549&set=pb.100044561550831.-2207520000&type=3", "image": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.99422-6/841844892…", "width": 2048, "height": 1911, "ocrText": "A young star cluster filled with many stars that display Webb's unique eight-pronged diffraction pattern…", "photoType": "photos_by", "position": 2, "albumId": "416661013162614", "pageName": "NASA - National Aeronautics and Space Administration", "pageFollowers": 28746231, "createdTime": "2026-10-09T20:54:33.000Z", "caption": "Brewing up baby stars ⭐ NASA's James Webb Space Telescope's unique view reveals…", "reactionsCount": 8640, "reactions": { "like": 5199, "love": 3102, "care": 188, "wow": 122, "haha": 22, "angry": 5, "sad": 2 }, "commentsCount": 190, "sharesCount": 909, "postUrl": "https://www.facebook.com/NASA/posts/pfbid02hL3YCLokPkZbLhPqz…", "privacy": "Public" } ``` #### Facebook photo fields | Field | Type | What it is | Fill on test runs | |---|---|---|---| | `id`, `url` | string | Photo id and link | 100% | | `image` | string | Image URL; full size on Page / profile rows and on every row with details | 100% | | `thumbnail` | string | The grid thumbnail | 100% | | `width`, `height` | number | Size of the photo in pixels | 100% | | `imageIsFullSize` | boolean | `false` on album / group rows without details (their grids print a 168-417 px image) | 100% | | `ocrText` | string | Facebook's alt text ("May be an image of…") | 100% | | `photoType` | string | `photos_by`, `photos_of`, `album`, `group` or `photo` | 100% | | `position` | number | Position in its source, newest first | 100% | | `collectionItemId` | string | Facebook's id of the photo in the photos tab | 100% on Page rows | | `facebookId`, `pageName`, `pageUrl`, `pageUsername` | string | The Page or profile | 100% on Page rows | | `pageFollowers`, `pageTalkingAbout` | number | As printed on the Page | 100% on Page rows | | `pageIsVerified`, `pageAdLibrary`, `navSections` | mixed | Verified badge, Ad Library id, photo sections | 100% on Page rows | | `albumId`, `albumTitle` | string | Album (album walks; any row with details) | 100% with details | | `groupId`, `groupTitle`, `ownerId` | string | Group rows: the group and the uploader's id | 100% on group rows | | `createdTime`, `timestamp` | string, number | Details: upload time | 100% | | `caption` | string | Details: text of the post | 93% | | `reactionsCount`, `reactions` | number, object | Details: reactions, total and by type | 100%, 92% | | `commentsCount`, `sharesCount` | number | Details: comment and share counts | 100% | | `postId`, `postUrl`, `creation_story` | mixed | Details: the post the photo was published in | 100% | | `ownerName`, `ownerUrl`, `ownerIsVerified`, `ownerProfilePicture` | mixed | Details: the uploader | 100% | | `tags` | array | Details: tagged people {id, name, type, isProductTag} | 100% on tagged photos | | `previousPhotoId`, `nextPhotoId`, `privacy` | string | Details: neighbours in the album, audience | 92-100% | | `imageStoredUrl`, `imageStoreKey` | string | Saved image files | 100% when on | | `pageCategory` | string | Page category | when `includePageContext` | | `inputUrl`, `scrapedAt` | string | The input line and the read time | 100% | Album rows (`dataType: "album"`) carry `id`, `url`, `albumTitle`, `itemCount`, `itemCountText` ("10,975 Items"), `coverImage` and the Page columns. ### How can I use Facebook photo data? - 🎯 **Brand and agency teams:** collect every photo a competitor posts and its engagement, then rank creatives by shares or reactions. - πŸ“Š **Social media analysts:** track posting cadence and engagement per month with the date window and `createdTime`. - πŸ”Ž **Brand protection:** watch the tagged-photos tab of your own Page for photos other people post about you. - πŸ€– **AI and research teams:** build labelled image sets from `image` + `ocrText` + `caption`, with permanent copies via **Save image files**. - πŸ—‚οΈ **Archivists and journalists:** export a Page's or a group's whole photo library, album by album. - πŸ“ˆ **Monitoring:** schedule monitor mode daily and receive only the new photos. ### How much does it cost to scrape Facebook photos? Facebook Photos Scraper is pay-per-result with no start fee: **$0.90 per 1,000 photos**. The add-ons are charged only for the rows that carry them: **Photo details** $0.90 per 1,000 photos, **Album** rows $0.90 per 1,000 albums, **Image stored** $0.90 per 1,000 saved images. Photos removed by your filters, photos delivered by an earlier monitor run, and sources Facebook does not show cost nothing. | Photos | Photos only | With details | |---:|---:|---:| | 20 | $0.018 | $0.036 | | 100 | $0.09 | $0.18 | | 1,000 | $0.90 | $1.80 | | 10,000 | $9.00 | $18.00 | There is nothing else to pay: Apify platform usage is included in these prices. On test runs 100 photos took 4 seconds (13 seconds with details) and 1,000 photos 47 seconds (3.6 minutes with details). ### Integrations, API, scheduling & MCP - **Schedules:** run Facebook Photos Scraper hourly, daily or weekly from the **Schedules** tab; with `monitorMode` on, each run returns only new photos. - **Webhooks:** call a URL when a run finishes and push the photos to your CRM, Slack or a sheet. - **No-code:** Make, Zapier, n8n, Google Sheets, Airtable and Slack via [Apify integrations](https://docs.apify.com/integrations). - **API:** start runs and read the dataset with `apify-client` for [Python](https://apify.com/topapi/facebook-photos-scraper/api/python) or [JavaScript](https://apify.com/topapi/facebook-photos-scraper/api/javascript). - **MCP / AI agents:** connect Claude, Cursor or any MCP client through the [MCP tab](https://apify.com/topapi/facebook-photos-scraper/api/mcp); `compact` keeps the rows small. ### More Facebook scrapers by TopApi
πŸ“° Facebook Page Posts Scraper πŸ“Š Facebook Post Details Scraper πŸ’¬ Facebook Comments Scraper
⭐ Facebook Reviews Scraper πŸ“… Facebook Events Scraper πŸ”Ž Facebook Search Posts Scraper
πŸ›’ Facebook Marketplace Scraper πŸ“Έ Instagram Profile Scraper 🧭 All TopApi scrapers
### Limits & empty runs - **Per call:** Facebook serves 8 photos per page of a photos tab or group and 14 per page of an album; deeper runs simply take more calls (1,000 photos = 125 calls). - **Per source:** up to 10,000 photos per source per run; a 1,000-photo test run made 125 list calls and 1,000 detail calls with no refusal. - **Album and group images:** their grids print a 168-417 px image; turn on details to get the full-size file on those rows. - **Not available signed out:** tag positions on the photo, Page like counts, photo view counts, pinned or sponsored flags, comment text (use [Facebook Comments Scraper](https://apify.com/topapi/facebook-comments-scraper) for comments). - **Empty dataset:** the source is unknown, private or age-restricted, every photo was removed by your filters, or monitor mode found nothing new; the run summary says which. Nothing is charged. ### FAQ #### How many photos can Facebook Photos Scraper collect from one Page? Up to 10,000 per source per run (`resultsLimit: 0`). A test read 1,000 photos of Humans of New York with details in 3.6 minutes. For more, split the work with the date window. #### How much does Facebook Photos Scraper cost? $0.90 per 1,000 photos, plus $0.90 per 1,000 for details when you turn them on. No start fee, and platform usage is included. #### Can I get photos from a specific year or month with Facebook Photos Scraper? Yes. Set `dateFilter` to `2025` or `2025-06`, or use the two date fields. On Pages and profiles Facebook applies the window itself. #### Can I run Facebook Photos Scraper on a schedule to get only new photos? Yes. Turn on `monitorMode`, keep the same `monitorStoreName`, and schedule the task. A run that finds nothing new delivers and charges nothing. #### Can Facebook Photos Scraper download the image files? Yes. Turn on **Save image files**: each image is stored in your key-value store and the row gets a permanent link. Facebook's own image links expire after a few days (the expiry is written into each link). #### Does Facebook Photos Scraper get tagged photos and albums? Yes. `photoType: "photos_of"` (or `both`) returns the photos other people tagged the Page in; `includeAlbums` lists the albums and `includeAlbumPhotos` walks their photos. #### Do I need a Facebook account, cookies or an API key for Facebook Photos Scraper? No. It reads only what Facebook shows to a signed-out visitor; you paste links or usernames and nothing else. #### Can I use Facebook Photos Scraper with the Apify API or an MCP server? Yes. Use `apify-client` from the [API tab](https://apify.com/topapi/facebook-photos-scraper/api/python), or connect an MCP client through the [MCP tab](https://apify.com/topapi/facebook-photos-scraper/api/mcp). #### Why did my Facebook Photos Scraper run return no photos? Usually the address is a post or event rather than a Page, album, group or photo, the Page is private or age-restricted, or your filters removed every photo. The run summary lists each input with its status. #### Is it legal to scrape Facebook photos? Facebook Photos Scraper extracts only publicly available photos and does not log in or collect private data. Results can still contain personal data, which is regulated (for example by GDPR); make sure you have a legitimate purpose before you use it. #### Your feedback Found a bug or missing a field? Open an issue on the [Issues tab](https://apify.com/topapi/facebook-photos-scraper/issues/open) and we will look at it. # Actor input Schema ## `startUrls` (type: `array`): Public Facebook addresses: a Page or profile (https://www.facebook.com/humansofnewyork, profile.php?id=…), an album (/media/set/?set=a.…), a group (/groups/…) or a photo (/photo/?fbid=…). ## `pageNames` (type: `array`): Usernames or numeric ids instead of URLs, e.g. "NASA", "humansofnewyork" or "100044561550831". Mixed with the URLs above. ## `photoType` (type: `string`): The Page's own photos, the photos others tagged it in, or both. Albums, groups and photo links ignore this setting. ## `onlyPhotosNewerThan` (type: `string`): Keep photos uploaded on or after this date: absolute (2026-01-01) or relative (30 days, 6 months, 1 year). Empty = no lower bound. ## `onlyPhotosOlderThan` (type: `string`): Keep photos uploaded before this date, e.g. 2026-06-01 or "1 year". Empty = up to today. ## `dateFilter` (type: `string`): A year (2025) or a month (2025-06), the way Facebook's photo filter offers it. Combined with the two dates above. ## `keywords` (type: `array`): Keep a photo only if its alt text (and its caption, when details are on) contains one of these words, e.g. "people", "text", "food". ## `excludeKeywords` (type: `array`): Drop a photo whose alt text (or caption, with details on) contains one of these words. ## `minWidth` (type: `integer`): Keep only photos at least this many pixels wide, e.g. 1080. 0 = any size. ## `minReactions` (type: `integer`): Keep only photos with at least this many reactions. Needs "Add photo details". ## `includeDetails` (type: `boolean`): Upload date, caption, reactions (total and by type), comment and share counts, post link, album, tagged people, owner and privacy. One extra request per photo; charged as "Photo details". ## `includeAlbums` (type: `boolean`): Add one row per album of each Page / profile (up to "Albums per Page"): title, item count, cover and link. Charged as "Album". ## `includeAlbumPhotos` (type: `boolean`): Also walk the photos inside each album (cover photos, profile pictures, named albums), with the album title on each row. ## `maxAlbums` (type: `integer`): How many albums (newest first) to list and / or walk per Page or profile. ## `maxPhotosPerAlbum` (type: `integer`): Cap per album when walking albums. 0 = every photo of the album. ## `includePageContext` (type: `boolean`): Add the Page's category (e.g. "Pizza place") to every row. One extra page load per Page; no extra charge. ## `storeImages` (type: `boolean`): Download each image into a key-value store and add a permanent link to the row (Facebook's own image links expire after a few days). Charged as "Image stored". ## `imageStoreName` (type: `string`): Named key-value store for the saved images (letters, digits and hyphens), e.g. "nasa-photos". ## `monitorMode` (type: `boolean`): Skip photos an earlier run with the same store already delivered. A run that finds nothing new bills nothing. ## `monitorStoreName` (type: `string`): Named key-value store that remembers delivered photos between runs. Use one name per schedule. ## `resultsLimit` (type: `integer`): Maximum photos from each Page, profile, album or group (newest first). 0 = all of them, up to 10,000 per source. ## `maxItems` (type: `integer`): Stop the whole run after this many rows across all sources. 0 = no total limit. ## `compact` (type: `boolean`): Core columns only (id, link, image, size, alt text, date, caption, counts) - smaller rows for AI agents and MCP. ## `proxyConfiguration` (type: `object`): Leave off: the run starts without a proxy and moves to the Apify datacenter proxy, then RESIDENTIAL, only if Facebook refuses it. ## `maxConcurrency` (type: `integer`): How many Pages / albums / groups are read in parallel. ## `concurrentPhotos` (type: `integer`): Photo-detail requests in flight per source when details are on. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.facebook.com/humansofnewyork" } ], "photoType": "photos_by", "includeDetails": false, "includeAlbums": false, "includeAlbumPhotos": false, "maxAlbums": 10, "maxPhotosPerAlbum": 50, "includePageContext": false, "storeImages": false, "imageStoreName": "facebook-photos-images", "monitorMode": false, "monitorStoreName": "facebook-photos-monitor", "resultsLimit": 20, "compact": false, "proxyConfiguration": { "useApifyProxy": false }, "maxConcurrency": 3, "concurrentPhotos": 8 } ``` # Actor output Schema ## `photos` (type: `string`): The dataset of Facebook photos (one item per photo, plus album rows when the album list is on). ## `summary` (type: `string`): Per-source counts (read, filtered, already delivered, delivered), the status of every input line, requests made and bytes transferred. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.facebook.com/humansofnewyork" } ], "resultsLimit": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("topapi/facebook-photos-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.facebook.com/humansofnewyork" }], "resultsLimit": 20, } # Run the Actor and wait for it to finish run = client.actor("topapi/facebook-photos-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.facebook.com/humansofnewyork" } ], "resultsLimit": 20 }' | apify call topapi/facebook-photos-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/facebook-photos-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/AQskgQMkZc3iyni7L/builds/Rx1ncDBM2eF5nRINk/openapi.json