(Chilkat2-Python) Facebook Download all Photos to Local Files

Demonstrates how to download all of one's Facebook photos to a local filesystem directory. This sample code keeps a local cache to avoid re-downloading the same photos twice. The program can be run again after a time, and it will download only photos that haven't yet been downloaded.

Chilkat2 Python Downloads install with pip pip3 install chilkat2 or download... Python Module for Windows, Linux, Alpine Linux, MacOS, Solaris

import sys
import chilkat2

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

# This example will use a local disk cache to avoid re-fetching the same
# photo id after it's been fetched once.
fbCache = chilkat2.Cache()
# The cache will use 1 level of 256 sub-directories.
fbCache.Level = 1
# Use a directory path that makes sense on your operating system..
fbCache.AddRoot("C:/fbCache")

# This example assumes a previously obtained an access token
oauth2 = chilkat2.OAuth2()
oauth2.AccessToken = "FACEBOOK-ACCESS-TOKEN"

rest = chilkat2.Rest()

# Connect to Facebook.
success = rest.Connect("graph.facebook.com",443,True,True)
if (success != True):
    print(rest.LastErrorText)
    sys.exit()

# Provide the authentication credentials (i.e. the access key)
rest.SetAuthOAuth2(oauth2)

# There are two choices:  
# We can choose to download the photos the person is tagged in or has uploaded
# by setting type to "tagged" or "uploaded".
rest.AddQueryParam("type","uploaded")

# To download all photos, we begin with an outer loop that iterates over
# the list of photo nodes in pages.  Each page returned contains a list of 
# photo node ids.  Each photo node id must be retrieved to get the download URL(s)
# of the actual image.

# I don't know the max limit for the number of records that can be downloaded at once.
rest.AddQueryParam("limit","100")

# Get the 1st page of photos ids.
# See https://developers.facebook.com/docs/graph-api/reference/user/photos/ for more information.
responseJson = rest.FullRequestNoBody("GET","/v2.7/me/photos")
if (rest.LastMethodSuccess != True):
    print(rest.LastErrorText)
    sys.exit()

photoJson = chilkat2.JsonObject()
saPhotoUrls = chilkat2.StringArray()
sbPhotoIdPath = chilkat2.StringBuilder()

json = chilkat2.JsonObject()
json.EmitCompact = False
json.Load(responseJson)

# Get the "after" cursor.
afterCursor = json.StringOf("paging.cursors.after")
while json.LastMethodSuccess == True :

    print("-------------------")
    print("afterCursor = " + afterCursor)

    # For each photo id in this page...
    i = 0
    numItems = json.SizeOfArray("data")
    while i < numItems :
        json.I = i
        photoId = json.StringOf("data[i].id")
        print("photoId = " + photoId)

        # We need to fetch the JSON for this photo.  Check to see if it's in the local disk cache,
        # and if not, then get it from Facebook.
        photoJsonStr = fbCache.FetchText(photoId)
        if (fbCache.LastMethodSuccess == False):
            # It's not locally available, so get it from Facebook..
            sbPhotoIdPath.Clear()
            sbPhotoIdPath.Append("/v2.7/")
            sbPhotoIdPath.Append(photoId)

            rest.ClearAllQueryParams()
            rest.AddQueryParam("fields","id,album,images")

            print("Fetching photo node from Facebook...")

            # This REST request will continue using the existing connection.
            # If the connection was closed, it will automatically reconnect to send the request.
            photoJsonStr = rest.FullRequestNoBody("GET",sbPhotoIdPath.GetAsString())
            if (rest.LastMethodSuccess != True):
                print(rest.LastErrorText)
                sys.exit()

            # Add the photo JSON to the local cache.
            fbCache.SaveTextNoExpire(photoId,"",photoJsonStr)

        # Parse the photo JSON and add the main photo download URL to saPhotoUrls
        # There may be multiple URLs in the images array, but the 1st one is the largest and main photo URL.
        # The others are smaller sizes of the same photo.
        photoJson.Load(photoJsonStr)
        imageUrl = photoJson.StringOf("images[0].source")
        if (photoJson.LastMethodSuccess == True):

            # Actually, we'll add a small JSON document that contains both the image ID and the URL.
            imgUrlJson = chilkat2.JsonObject()
            imgUrlJson.AppendString("id",photoId)
            imgUrlJson.AppendString("url",imageUrl)
            saPhotoUrls.Append(imgUrlJson.Emit())
            print("imageUrl = " + imageUrl)

        i = i + 1

    # Prepare for getting the next page of photos ids.
    # We can continue using the same REST object.
    # If already connected, we'll continue using the existing connection.
    # Otherwise, a new connection will automatically be made if needed.
    rest.ClearAllQueryParams()
    rest.AddQueryParam("type","uploaded")
    rest.AddQueryParam("limit","20")
    rest.AddQueryParam("after",afterCursor)

    # Get the next page of photo ids.
    responseJson = rest.FullRequestNoBody("GET","/v2.7/me/photos")
    if (rest.LastMethodSuccess != True):
        print(rest.LastErrorText)
        sys.exit()

    json.Load(responseJson)
    afterCursor = json.StringOf("paging.cursors.after")

print("No more pages of photos.")

# Now iterate over the photo URLs and download each to a file.
# We can use Chilkat HTTP.  No Facebook authorization (access token) is required to download
# the photo once the URL is known.  
http = chilkat2.Http()

# We'll cache the image data so that if run again, we don't re-download the same image again.
numUrls = saPhotoUrls.Count
i = 0
urlJson = chilkat2.JsonObject()

fac = chilkat2.FileAccess()

while i < numUrls :
    urlJson.Load(saPhotoUrls.GetString(i))
    photoId = urlJson.StringOf("id")
    imageUrl = urlJson.StringOf("url")

    # Check the local cache for the image data.
    # Only download and save if not already cached.
    # imageBytes is a memoryview
    imageBytes = fbCache.FetchFromCache(imageUrl)
    if (fbCache.LastMethodSuccess == False):
        #  This photo needs to be downloaded.

        sbImageUrl = chilkat2.StringBuilder()
        sbImageUrl.Append(imageUrl)

        # Let's form a filename..
        extension = ".jpg"
        if (sbImageUrl.Contains(".gif",False) == True):
            extension = ".gif"

        if (sbImageUrl.Contains(".png",False) == True):
            extension = ".png"

        if (sbImageUrl.Contains(".tiff",False) == True):
            extension = ".tiff"

        if (sbImageUrl.Contains(".bmp",False) == True):
            extension = ".bmp"

        sbLocalFilePath = chilkat2.StringBuilder()
        sbLocalFilePath.Append("C:/Photos/facebook/uploaded/")
        sbLocalFilePath.Append(photoId)
        sbLocalFilePath.Append(extension)

        # imageBytes is a memoryview
        imageBytes = http.QuickGet(imageUrl)
        if (http.LastMethodSuccess != True):
            print(http.LastErrorText)
            sys.exit()

        # We've downloaded the photo image bytes into memory.
        # Save it to the cache AND save it to the output file.
        fbCache.SaveToCacheNoExpire(imageUrl,"",imageBytes)
        fac.WriteEntireFile(sbLocalFilePath.GetAsString(),imageBytes)

        print("Downloaded to " + sbLocalFilePath.GetAsString())

    i = i + 1

print("Finished downloading all Facebook photos!")