How to Use Facebook Page photos in Codex
Fetch photos from a public Facebook Page, including photo IDs, image links, dimensions, thumbnails, and accessibility descriptions. Use it to build a visual inventory or review a brand's published imagery.
Prompts to try with Facebook Page photos in Codex
Copy an example into Codex, or ask in your own words.
Use Facebook Page photos for https://www.facebook.com/Spurs and build a photo inventory in this project. Include photo IDs, thumbnails, image dimensions, accessibility descriptions, and Facebook links.
Use Facebook Page photos for https://www.facebook.com/NASA and add an aspect ratio report to this project. Fetch up to three batches and count square, portrait, and landscape images in the retrieved sample.
Use Facebook Page photos for https://www.facebook.com/LEGO and create a review page in this project that pairs each thumbnail with its returned accessibility description and Facebook link.
Use Facebook Page photos for https://www.facebook.com/Spurs and compare the returned photo IDs with this project's saved inventory. Add newly observed IDs with their image dimensions and source links.
Use Facebook Page photos for https://www.facebook.com/NASA and write the retrieved metadata to a CSV in this project. Fetch up to five batches, preserve both pagination values between requests, and remove duplicate photo IDs.
How to set up Facebook Page photos in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Facebook Page photos
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "scrapecreators", "model": "scrapecreators/facebook-profile-photos", "input": { "url": "https://www.facebook.com/Spurs" } }'
Then paste one of the prompts above: Codex finds Facebook Page photos on Spiral, shows the price and runs it.
Facebook Page photos providers and prices
Spiral runs Facebook Page photos through ScrapeCreators. Open a card for today's price, with every fee included.
What can you do with Facebook Page photos in Codex?
Build a photo inventory with thumbnails, dimensions, and Facebook links for a public brand Page. A coding agent can add aspect ratio calculations and compare returned photo IDs against the project's saved inventory.
Public photo inventory
Create a reviewable inventory of a brand's Facebook photos with photo IDs, thumbnails, image dimensions, and links back to Facebook.
Creative research
Collect a bounded sample of public brand photos for a creative brief. Use thumbnails and accessibility descriptions to shortlist images for visual review.
Image format audit
Calculate aspect ratios from returned image dimensions and compare the square, portrait, and landscape images in a Page's retrieved photos.
Accessibility description review
Put Facebook's returned accessibility descriptions beside photo links so an editor can check whether each description conveys the image accurately.
Newly observed photo digest
Compare retrieved photo IDs across scheduled checks of a public business Page. Prepare a digest of newly observed IDs with thumbnails and Facebook links.
Editorial image shortlist
Build a linked shortlist of photos from a public organization's Page for an editor to review before seeking permission to reuse selected images.
More on Facebook Page photos and Codex
Overview
Facebook Page photos in other agents
Questions about Facebook Page photos in Codex
Can Codex use Facebook Page photos?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Facebook Page photos like any built-in tool.
How much does Facebook Page photos cost in Codex?
Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need a ScrapeCreators account to use Facebook Page photos in Codex?
No. Spiral runs Facebook Page photos on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.
How long does it take to set up Facebook Page photos in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Facebook Page photos runs?
Facebook Page photos runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.
Which Facebook photos does this cover?
The documented coverage is photos from public Facebook Pages. Private photos fall outside that stated scope.
Does it return image files or links?
It returns image links and metadata: a viewer image URL with height and width, a thumbnail, a photo ID, an accessibility description, and a direct Facebook photo URL.
How do I retrieve more than the first batch of photos?
Pagination requires two continuation values from the preceding response: next_page_id and cursor. Preserve both when requesting the next batch.
How accurate are Facebook's accessibility descriptions?
Facebook's automatic descriptions can be wrong. Meta says its “May be” wording reflects a margin for error, so use those descriptions as clues when reviewing imagery.
Can I reuse the returned photos commercially?
ScrapeCreators permits commercial use and redistribution of its output, but its terms also require compliance with the accessed website's terms and applicable laws. That permission alone does not establish reuse rights for a Facebook photo.
Start using Facebook Page photos in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


