CaptapiCaptapi
Facebook · Guide

How to get Facebook profile photos

TL;DR
To get Facebook profile photos, sign up for a free Captapi key, then send one GET request to /v1/facebook/profile-photos with your input. You get clean JSON back in seconds for 12 credits per call — no OAuth, scraping or platform SDKs. Bulk-list Facebook content with full metadata for each item.
Get your free API keyAPI reference

How to get Facebook profile photos (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the Facebook Profile Photos API

    Send an authenticated GET request to /v1/facebook/profile-photos with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Results are cached for 24 hours, so repeat calls are free.

Code example

curl "https://api.captapi.com/v1/facebook/profile-photos?url=https%3A%2F%2Fwww.facebook.com%2FNASA" \
  -H "Authorization: Bearer capt_live_..."

What the response looks like

{
  "success": true,
  "cached": false,
  "creditsUsed": 12,
  "data": {
    "url": "https://www.facebook.com/nasa",
    "totalReturned": 5,
    "photos": [
      {
        "platform": "facebook",
        "id": "YXBwX2l0ZW06MTAwMDQ0NTYxNTUwODMxOjIzMDUyNzI3MzI6NTo6MTU2ODIwMTIyODAwODU4MQ==",
        "url": "https://www.facebook.com/photo.php?fbid=1568201228008581&set=pb.100044561550831.-2207520000&type=3",
        "image": "https://scontent-mia5-2.xx.fbcdn.net/v/t39.99422-6/739596077_1554598526079319_7764838102821159111_n.png?stp=dst-jpg_tt6&cstp=mx2048x2048&ctp=s2048x2048&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=gt4JC_WdvSYQ7kNvwGTz8_M&_nc_oc=AdoYvOi07pLqBhuho7XKpR0rdSMIFe5e7v4vp-xSZwQfLJoZS95qw50JQIBol8x3BSA&_nc_zt=14&_nc_ht=scontent-mia5-2.xx&_nc_gid=cjhU7CvvrM25lg5_SdKqdg&_nc_ss=72289&oh=00_AQCAsL9my7FB92unZB1G8A8xNLLeAgaPspwGGXu2Qhe9Hg&oe=6A4DECD1",
        "caption": "A newly-released photo of Earth's horizon taken during the Artemis II mission from the window of the Orion spacecraft. This view shows the hazy, blue atmosphere on top of faded, textured clouds. The Moon appears as a tiny, white dot in the distance. Credit: NASA",
        "publishedAt": null,
        "likes": null,
        "comments": null,
        "width": null,
        "height": null
      },
      {
        "platform": "facebook",
        "id": "YXBwX2l0ZW06MTAwMDQ0NTYxNTUwODMxOjIzMDUyNzI3MzI6NTo6MTU2ODIwMTE3MTM0MTkyMA==",
        "url": "https://www.facebook.com/photo.php?fbid=1568201171341920&set=pb.100044561550831.-2207520000&type=3",
        "image": "https://scontent-mia5-2.xx.fbcdn.net/v/t39.99422-6/738494240_1517432012920711_6195141728552532415_n.png?stp=dst-jpg_tt6&cstp=mx2048x2048&ctp=s2048x2048&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=eVcYhY0hqJIQ7kNvwH-79p2&_nc_oc=AdrdwjJQ1kyxCSxQT3j-7lXdR9LRXzUrMdEEfuBRx1vOeNVajj_1DTcsO3oBgfUlkHY&_nc_zt=14&_nc_ht=scontent-mia5-2.xx&_nc_gid=cjhU7CvvrM25lg5_SdKqdg&_nc_ss=72289&oh=00_AQBJRYOuQhq0oMNitPQfn9IREr0rJP0R_pUj3HV7e1ot-g&oe=6A4DDCAA",
        "caption": "A newly-released photo of our Moon taken by the crew of Artemis II. The top portion is shadowed by black space. This angle captures a mostly uniform, light gray portion of the lunar surface, with darker patches in the lower third. Craters of various sizes are visible all over the Moon’s surface—most easily visible at the edge of the upper shadow. Credit: NASA",
        "publishedAt": null,
        "likes": null,
        "comments": null,
        "width": null,
        "height": null
      },
      {
        "platform": "facebook",
        "id": "YXBwX2l0ZW06MTAwMDQ0NTYxNTUwODMxOjIzMDUyNzI3MzI6NTo6MTU2ODIwMTE1MTM0MTkyMg==",
        "url": "https://www.facebook.com/photo.php?fbid=1568201151341922&set=pb.100044561550831.-2207520000&type=3",
        "image": "https://scontent-mia5-2.xx.fbcdn.net/v/t39.99422-6/735761467_1991329928167370_6353960477553016321_n.png?stp=dst-jpg_tt6&cstp=mx1080x1080&ctp=s1080x1080&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=QXoZTSqO4c4Q7kNvwGxPHER&_nc_oc=Ado4Wj7UpKAI7zqeFML9qzlR3vBfu3srJROq37a08GVwzglMr8fVvXNDcdmXsy1uxiE&_nc_zt=14&_nc_ht=scontent-mia5-2.xx&_nc_gid=cjhU7CvvrM25lg5_SdKqdg&_nc_ss=72289&oh=00_AQBRuDTEpxWlc17V3plLgf_GjE1d_EYfadEeqPXDwR6_Yw&oe=6A4DF1D9",
        "caption": "A crisp photo of Mars against black space. The Red Planet appears rust-colored with dark texturing along its middle and a light patch on its lower right side. Credit: USGS Astrogeology Science Center",
        "publishedAt": null,
        "likes": null,
        "comments": null,
        "width": null,
        "height": null
      },
      {
        "platform": "facebook",
        "id": "YXBwX2l0ZW06MTAwMDQ0NTYxNTUwODMxOjIzMDUyNzI3MzI6NTo6MTU2NjUwMTAxNDg0NTI2OQ==",
        "url": "https://www.facebook.com/photo.php?fbid=1566501014845269&set=pb.100044561550831.-2207520000&type=3",
        "image": "https://scontent-mia5-1.xx.fbcdn.net/v/t39.99422-6/735193531_1369401081794252_3282264264129556761_n.png?stp=dst-jpg_tt6&cstp=mx1782x1264&ctp=s1782x1264&_nc_cat=101&ccb=1-7&_nc_sid=127cfc&_nc_ohc=WFiORgoguQMQ7kNvwFkXsDs&_nc_oc=AdoVKn1M18BsmDxx-9fjqlZzdjhtUti_iJRAu-JjoWeuyTMyBxlisdbXMjZN5h84eFU&_nc_zt=14&_nc_ht=scontent-mia5-1.xx&_nc_gid=cjhU7CvvrM25lg5_SdKqdg&_nc_ss=72289&oh=00_AQCH-clzF63z4t_Gr-uxWh0kiAEWwvtwVv0-nnKg48GJdA&oe=6A4E0112",
        "caption": "A screenshot of the \"What Did Hubble See On Your Birthday\" website, with buttons to \"Select Your Birth Date\" and five Hubble photos displayed beneath. A reddish-blue star system faintly fills the background. Credit: NASA",
        "publishedAt": null,
        "likes": null,
        "comments": null,
        "width": null,
        "height": null
      },
      {
        "platform": "facebook",
        "id": "YXBwX2l0ZW06MTAwMDQ0NTYxNTUwODMxOjIzMDUyNzI3MzI6NTo6MTU2NDk0MTc4MTY2Nzg1OQ==",
        "url": "https://www.facebook.com/photo.php?fbid=1564941781667859&set=pb.100044561550831.-2207520000&type=3",
        "image": "https://scontent-mia3-3.xx.fbcdn.net/v/t39.30808-6/734008892_1564941785001192_3952070880633221311_n.jpg?stp=dst-jpg_tt6&cstp=mx1273x1280&ctp=s1273x1280&_nc_cat=109&ccb=1-7&_nc_sid=127cfc&_nc_ohc=2Rh9bQ0m2YYQ7kNvwGydx9O&_nc_oc=AdpcoqPcqVBnvslep_0C7tWQgZkofrwHsEAqrVQxUBhBcFeKFV7dzTh_6NELe7SZTts&_nc_zt=23&_nc_ht=scontent-mia3-3.xx&_nc_gid=cjhU7CvvrM25lg5_SdKqdg&_nc_ss=72289&oh=00_AQA4IULhMZWSjEaqT4ba-MGZpAL68wafdqUScwTjM9Y_DA&oe=6A4DE345",
        "caption": "A dense, sparkly star field collecting around a central point. The stars are various shades of white, yellow, and blue. Credit: ESA/Hubble & NASA, A. Sarajedini, G. Piotto",
        "publishedAt": null,
        "likes": null,
        "comments": null,
        "width": null,
        "height": null
      }
    ]
  }
}

Request parameters

NameTypeRequiredDescription
urlstring YesFacebook profile/page URL, @handle, or page name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
limitintegerNoMax items to return (default 20, max 200). Billed per result.

Frequently asked questions

What does the Facebook Profile Photos API do?

The Facebook Profile Photos API lets you list items in bulk with metadata from a public Facebook video using one GET request to /v1/facebook/profile-photos. It returns clean JSON — no OAuth or scraping setup required.

How many credits does the Facebook Profile Photos API cost?

Each successful call costs 12 credits. Responses are cached for 24 hours, and cached results cost 0 credits. Failed or empty results are never charged.

Do I need a Facebook API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, and Rumble. We handle proxies, rate limits, retries, and authentication for you.

Is the Facebook Profile Photos API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON, automatic retries, and a shared 24-hour cache. Use it for RAG pipelines, analytics, monitoring, and content automation.

Ready to get Facebook profile photos?

Start free with 100 credits — no credit card required.

Get your free API key