Albums

Album Metadata

Description

This endpoint retrieves metadata for a specific Facebook album based on its album ID.

Endpoint

GET api/v1/realtime/social/facebook/v1/albums/{{albumtId}}/metadata

Parameters

Param	Required	Param Type	Description
albumtId	Yes	Path Param	String | The unique identifier for the Facebook album whose metadata is to be retrieved.

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/facebook/v1/albums/5427027857336285/metadata' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "data": {
        "album": {
            "id": "5427027857336285",
            "owner": {
                "__typename": "Page",
                "strong_id__": "141225109249946",
                "id": "141225109249946",
                "name": "Canon",
                "profile_picture": {
                    "uri": "https://scontent-lga3-2.xx.fbcdn.net/v/t39.30808-1/377787479_689766959850495_3102182382570413184_n.png?stp=cp0_dst-webp_s86x86&_nc_cat=109&ccb=1-7&_nc_sid=e8ff23&_nc_ohc=AsuG7T1dlOAQ7kNvgEh9f7P&_nc_ad=z-m&_nc_cid=0&_nc_ht=scontent-lga3-2.xx&oh=00_AYB_TR5-XGq9iCw4USpZYqV2XLYDbnk8KghFZ32pOrKLKQ&oe=66D21593"
                }
            },
            "title": {
                "text": "Dejando Huella - Canon y Fundación Vizacaya"
            },
            "privacy_scope": {...},
            "media_owner_object": {...},
            "can_upload": false,
            "album_type": "NORMAL",
            "contributors": [...],
            "message": null,
            "is_featured_on_profile": false,
            "can_viewer_feature_on_profile": false,
            "can_viewer_unfeature_from_profile": false,
            "allow_contributors": false,
            "explicit_place": null,
            "url": "https://www.facebook.com/media/set/?set=a.5427027857336285&type=3",
            "album_cover_focused_image": {...},
            "media": {
                "count": 549
            },
            "photo_items": {
                "count": 549
            },
            "modified_time": 1660579453,
            "viewer_follow_status": "FOLLOW",
            "can_viewer_edit_follow_status": false,
            "can_viewer_see_contained_post_stories_feed": false,
            "can_viewer_edit_cover_photo": false,
            "can_viewer_transfer_photos": false,
            "feedback": {...},
            "contained_post_stories_feed": {
                "count": 10
            },
            "is_opt_in_friends_channel": null
        }
    },
    "extensions": {
        "server_metadata": {
            "request_start_time_ms": 1724659315629,
            "time_at_flush_ms": 1724659315858
        },
        "is_final": true
    }
}

---

Album Media

Description

This endpoint retrieves the media within a specific Facebook album based on its album ID.

Endpoint

POST api/v1/realtime/social/facebook/v1/albums/{{albumtId}}/media

Parameters

Param	Required	Param Type	Description
albumtId	Yes	Path Param	String | The unique identifier for the Facebook album whose metadata is to be retrieved.
end_cursor	No	Body Param	String | The cursor to paginate

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/albums/5427027857336285/media' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "data": {
        "album": {
            "id": "5427027857336285",
            "media": {
                "page_info": {
                    "has_next_page": true,
                    "end_cursor": "AQHRa0y5M6Ed0gpEL_VsnS1BbEs0Inp8L6GRMEEmKZDViPvvuLQmqxa4UIWtzKrtKmTd",
                    "start_cursor": "AQHRT0vwM2JN5vcsLl7xlneaNqAdXK0rISmWs7aO3lanOl20MqV1eXybI7Qg2TVz_LxW",
                    "has_previous_page": false
                },
                "nodes": [
                    {
                        "__typename": "Photo",
                        "strong_id__": "5427029174002820",
                        "squareLargeImage": {...},
                        "largeThumbnail": {...},
                        "largePortraitImage": {...},
                        "imageThumbnail": {...},
                        "imageLow": {...},
                        "imageHigh": {...},
                        "portrait": {...},
                        "feedback": {...},
                        "landscape": {...},
                        "id": "5427029174002820",
                        "image": {...},
                        "imageMedium": {...},
                        "focus": {...},
                        "should_block_screenshot": false,
                        "narrowLandscapeImage": {...},
                        "narrowPortraitImage": {...},
                        "is_playable": false,
                        "playable_url": null,
                        "playable_duration_in_ms": 0,
                        "photo_encodings": [],
                        "is_spherical": false,
                        "immersive_photo_encodings": [],
                        "photo_creation_story": {...},
                        "photo_product_tags": []
                    },
                    ...
                ]
            }
        }
    },
    "extensions": {
        "server_metadata": {
            "request_start_time_ms": 1724659698042,
            "time_at_flush_ms": 1724659698191
        },
        "is_final": true
    }
}