Profiles

Profile Timeline

Description

This endpoint retrieves the timeline of a specific Facebook profile, identified by its profile ID

Endpoint

GET api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/timeline

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data is to be retrieved.

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/722677142/timeline' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "data": {
        "user": {
            "id": "722677142",
            "profile_footer_prompts_nt_view": null,
            "__typename": "User",
            "strong_id__": "722677142",
            "subscribe_status": "CAN_SUBSCRIBE",
            "is_additional_profile_plus": false,
            "can_viewer_message": true,
            "message_box_id": "722677142",
            "alternate_name": "",
            "profile_video": null,
            "name": "Yann LeCun",
            "profile_type_name_for_content": "PROFILE",
            "contextual_profile_cover_photo": {...},
            "is_profile_plus": false,
            "is_profile_header_name_tappable": false,
            "wem_private_sharing_bundle": {...},
            "is_wem_private_sharing_on": false,
            "structured_name": {...},
            "short_name": "Yann",
            "is_work_user": false,
            "is_memorialized": false,
            "profile_photo": {...},
            "gender": "MALE",
            "friendship_status": "CANNOT_REQUEST",
            "cover_photo": {...},
            "viewer": {...},
            "pinned_profile_song": null,
            "cover_video": null,
            "is_verified": true,
            "profile_header_left_aligned": false,
            "should_show_avatar_cover_photo_animated_prompt": false,
            "should_show_avatar_cover_photo_takeover_prompt": false,
            "show_cover_photo_camera_icon_indicator": false,
            "avatar_cover_photo_option_subtext": null,
            "profile_footer_prompt_type": null,
            "can_viewer_post": false,
            "birthdate": null,
            "birthday_card": {...},
            "nt_community_introduction_nux_action": null,
            "big_profile_picture_relative": {...},
            "disable_profile_photo_expansion": false,
            "is_profile_photo_shielded": false,
            "profile_photo_has_design": false,
            "profile_picture_id": "cHJvZmlsZV9waWN0dXJlNzIyNjc3MTQy",
            "is_viewer_friend": false,
            "profile_picture_is_silhouette": false,
            "posted_item_privacy_scope": null,
            "profile_active_messenger_room": null,
            "is_visibly_memorialized": false,
            "work_foreign_entity_info": null,
            "work_info": null,
            "contextual_profile_info": null,
            "story_bucket": {...},
            "eligible_profile_prompts": [],
            "nt_profile_admin_call_to_action_card": null,
            "profile_plus_megaphone_qp": null,
            "community_contextual_message_nt_view": null,
            "delegate_group": null,
            "memorialized_user_info": null,
            "aboveBio": {...},
            "aboveActionBar": {...},
            "belowActionBar": {...},
            "profile_action_bar": {...},
            "active_lightweight_status": null,
            "username_bloks_component": [...],
            "userWithoutTabs": {...},
            "userWithTabs": null,
            "wem_private_sharing_strings_bundle": null,
            "if_viewer_can_see_facepile_separated_from_social_context": null,
            "username_tooltip_for_profile": null,
            "has_taggable_products": false,
            "if_viewer_can_schedule_posts": null,
            "if_viewer_can_create_events_in_community_additional_profile": null,
            "if_viewer_can_see_presence_composer_header_on_first_story": null,
            "profile_deferred_action": {...},
            "is_partial": false,
            "profile_wizard_nux": {...},
            "can_viewer_enable_wem_private_sharing": true,
            "should_use_page_rename": false,
            "has_biz_tools_user_features": false,
            "editPublicDetailsFragment": [...],
            "private_sharing_tryit_card_nt_view": null,
            "private_sharing_tryit_card_bk_view": null
        }
    }
}

Profile About

Description

This endpoint retrieves the "About" information of a specific Facebook profile, based on its profile ID

Endpoint

GET api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/about

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data is to be retrieved.

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/722677142/about' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "data": {
        "user": {
            "has_biz_tools_user_features": false,
            "is_rising_creator": false,
            "delegate_page_id": null,
            "profile_info_sync_reminder_content": null,
            "profile_field_sections": {
                "edges": [...]
            },
            "should_use_page_rename": false,
            "life_event_units": null,
            "id": "722677142",
            "delegate_group": null,
            "timeline_about_app_sections": {
                "edges": [...]
            }
        }
    },
    "extensions": {
        "server_metadata": {
            "request_start_time_ms": 1724672659821,
            "time_at_flush_ms": 1724672660291
        },
        "is_final": true
    }
}

Profile Joined Year

Description

This endpoint retrieves the profile's joined year.

Endpoint

GET api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/joined_year

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data is to be retrieved.

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/722677142/joined_year' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "joined_year": "2007"
}

Profile About Tabs

Description

This endpoint retrieves specific "About" tab information from a Facebook profile based on its profile ID and the selected tab

Endpoint

GET api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/about-tabs?tab={{tab}}

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data is to be retrieved.

tab

Yes

Query Param

String | The specific tab or section to retrieve information from:

  • OVERVIEW

  • WORK_EDUCATION

  • PLACES_LIVED

  • CONTACT_INFO

  • FAMILY_RELATHIONSHIPS

  • DETAILS

Example Request
curl -X GET 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/722677142/about-tabs?tab=WORK_EDUCATION' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "data": {
        "user": {
            "profile_tile_sections": {
                "edges": [
                    {
                        "node": {
                            "profile_tile_section_type": "NAMES",
                            "profile_tile_views": {
                                "nodes": [...]
                            },
                            "action_link": null,
                            "is_pinned_profile_feature": false,
                            "title": {
                                "text": "Others named Yann LeCun"
                            },
                            "subtitle": null,
                            "nux_tooltip": null,
                            "url": null,
                            "action_menu": null,
                            "__typename": "ProfileTileSection"
                        },
                        "cursor": null
                    }
                ],
                "page_info": {
                    "has_next_page": false,
                    "end_cursor": "names"
                }
            },
            "id": "pfbid02HVsnBFmp4RsimVP4sYMg92A9MhtA9EBHFkM3xH4Ar71JBV9ZekuE472PxZRw6nRnl",
            "profile_plus_should_show_page_insights_disclaimer_link": false,
            "feed_banner": null
        },
        "mainColumnTiles": {
            "profile_tile_sections": {
                "edges": [
                    {
                        "node": {
                            "profile_tile_section_type": "PHOTOS",
                            "profile_tile_views": {
                                "nodes": [...]
                            },
                            "action_link": {
                                "__typename": "SeeAllPhotosProfileTileActionLink",
                                "title": "See All Photos",
                                "url": null
                            },
                            "is_pinned_profile_feature": false,
                            "title": {
                                "text": "Photos"
                            },
                            "subtitle": null,
                            "nux_tooltip": null,
                            "url": "https://www.facebook.com/login/",
                            "action_menu": null,
                            "__typename": "ProfileTileSection"
                        },
                        "cursor": null
                    }
                ],
                "page_info": {
                    "has_next_page": false,
                    "end_cursor": "photos"
                }
            },
            "id": "pfbid02HVsnBFmp4RsimVP4sYMg92A9MhtA9EBHFkM3xH4Ar71JBV9ZekuE472PxZRw6nRnl",
            "profile_plus_should_show_page_insights_disclaimer_link": false
        },
        "about_collection": {
            "style_renderer": {
                "__typename": "TimelineAppCollectionAboutProfileFieldSectionsRenderer",
                "profile_field_sections": [
                    {
                        "id": "cHJvZmlsZV9maWVsZF9zZWN0aW9uOjcyMjY3NzE0Mjp3b3Jr",
                        "title": {
                            "text": "Work"
                        },
                        "subtitle": null,
                        "title_icon": null,
                        "fxim_business_info_reminder": null,
                        "delegate_page": null,
                        "field_section_type": "work",
                        "profile_fields": {
                            "nodes": [...]
                        }
                    },
                    ..
                ],
                "__module_operation_ProfileCometLoggedOutAboutContent_timelineCollection": {
                    "__dr": "ProfileCometAboutProfileFieldSectionsRenderer_styleRenderer$normalization.graphql"
                },
                "__module_component_ProfileCometLoggedOutAboutContent_timelineCollection": {
                    "__dr": "ProfileCometAboutProfileFieldSectionsRenderer.react"
                }
            },
            "__typename": "TimelineAppCollection",
            "id": "YXBwX2NvbGxlY3Rpb246NzIyNjc3MTQyOjIzMjcxNTgyMjc6MjAy"
        }
    }
}

Profile Feed

Description

This endpoint retrieves the feed of a specific Facebook profile based on its profile ID.

Endpoint

POST api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/feed

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data is to be retrieved.

end_cursor

No

Body Param

String | The cursor to paginate

start_time

No

Body Param

String | UNIX timestamp of the start time to use as a filter.

end_time

No

Body Param

String | UNIX timestamp of the end time to use as a filter.

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/722677142/feed' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "results": {
        "featured": [],
        "pinned": [],
        "feed": [
            {
                "__typename": "Story",
                "id": "UzpfSTcyMjY3NzE0MjoxMDE1OTY4MjU2ODAyNzE0MzoxMDE1OTY4MjU2ODAyNzE0Mw==",
                "post_id": "10159682568027143",
                "creation_time": 1724270641,
                "message": "An important op-ed by Mark Zuckerberg (Meta) and Daniel Ek (Spotify) in The Economist about the fuzzy and disparate regulatory landscape in the EU and how it is becoming an obstacle to the development and deployment of technology in the EU, particularly when it comes to AI and open source.\n\n",
                "message_entity_ranges": [],
                "url": "https://m.facebook.com/story.php?story_fbid=pfbid02HU26foweH9yEqroRAsUJn445GeCMWRswTqDNbKSmVR9MsKJRSC4UmpUCWyAFJFg6l&id=722677142",
                "actors": [...],
                "collaborators": [],
                "attachments": [...],
                "attached_story": null,
                "privacy_scope": "Public",
                "edit_history": 0,
                "is_anonymous": false,
                "explicit_place": null,
                "feedback": {...},
                "source_language": "English"
            }
        ]
    },
    "page_info": {
        "start_cursor": "Cg8Ob3JnYW5pY19jdXJzb3IJAAABWkFRSFJFd3UxR04zWGRVSkJGczlSNWNIX2VMMlhyU0FnYW1PLUR0UE95NF83WVBRNDRHblV0SU1JUGJUd2k5UkZPc2hSbXZCbnRCSWhtZzFEUUpjbHZqSENFSjZsN3pMT0FaQUpTWGZMMFp6cl9CZ2F1c1lnUVY5d1hrT1RQQ3B1R0hIRS1wUDNkQWpHM2JJU3NBYU45a3liMktLdVd5TFVMc1ZvUW9xOWNOSEE4Z0NCTWluczluRmRGSFdtNmMwZkpjakVwVjJDMDB3YW95aDdTQ0dIdmJPVm9FM1dUNUVWQ0NTN1NOMzR5bnRMN1dwcEk0bGE1Y0hkOFlpcFhFcy1LMWg0Vm9sU1p4Tm9aTTVkUi1Od2ZmWHRVVUw0RGdJcXJOazZiRVVqNHc1aUhrTzhFNFczT1lNekZvTmlWNE5MMkJVREF6ekVQbUdqNi1WQ2V3eC1qUVVsOWcPCWFkX2N1cnNvcg4PD2dsb2JhbF9wb3NpdGlvbgIADwZvZmZzZXQCAA8QbGFzdF9hZF9wb3NpdGlvbgL/AQ==",
        "end_cursor": "Cg8Ob3JnYW5pY19jdXJzb3IJAAABWkFRSFJBTnFZd29NcnVBaUV4OVNXSFJORlUyaENkRzN3VWFyX0hLZm5xY0NydVRTMnJ0OHNxT2hUdkdzSGtUbmpMNkpLaGRfejVscGVqNVZDZnRmbFA2MG9KV1lLSGlvNzExU1NGNUR4YkxQYnRyZmZVR19EVjk4QXJsa1VpMEktd2tDT3Q0cHRqOVhWTlBsWlFUV1c5WDVEVUJhS0d6cm5VZm9fWVgzOWZPSDQwQjBCcDlUOVBSZ3UzSkNUN2NKSFQyYnZEaDdoLUhzRE5FSlpUMFFNejZkZkNqQjRRU1pLTE9vVlRadnNvX0dwcG9rbW9YOVdpZTFYTzR2cE5GNWdmMS1qdU5sYWtwV0V5UG9tcnlrQ0c5Tm0yYW53cGNYTHpVajdhMm9QSk1Kb0t3SW5nRXZUMTlRWklZVUxnYjU1UDAxTEozSVRGUzktLWVaY1JRNGdxMmlQcFEPCWFkX2N1cnNvcg4PD2dsb2JhbF9wb3NpdGlvbgIADwZvZmZzZXQCAA8QbGFzdF9hZF9wb3NpdGlvbgL/AQ==",
        "has_previous_page": false,
        "has_next_page": true
    }
}

Profile Following

Description

This endpoint retrieves the list of profiles that a specific Facebook profile is following, identified by its profile ID.

Endpoint

POST api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/following

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data is to be retrieved.

end_cursor

No

Body Param

String | The cursor to paginate

typed_query

No

Body Param

String | The query to search for

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/100014807225880/following' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "count": 872,
    "results": [
        {
            "id": "61554851735496",
            "name": "Pass Drive ",
            "profilePicture": "https://scontent-lga3-1.xx.fbcdn.net/v/t39.30808-1/414639923_122101389032161724_9212908604871479227_n.jpg?stp=cp0_dst-jpg_e15_q65_s240x240&_nc_cat=103&ccb=1-7&_nc_sid=f4b9fd&_nc_ohc=t-HKWdHpILYQ7kNvgFtNXPK&_nc_ad=z-m&_nc_cid=0&_nc_ht=scontent-lga3-1.xx&oh=00_AYD8FPxif3zWq8LGi0dMIQmEKLeaTWUf4HxAOeymVTDFGA&oe=66D256C8",
            "profile_picture": "https://scontent-lga3-1.xx.fbcdn.net/v/t39.30808-1/414639923_122101389032161724_9212908604871479227_n.jpg?stp=cp0_dst-jpg_e15_q65_s240x240&_nc_cat=103&ccb=1-7&_nc_sid=f4b9fd&_nc_ohc=t-HKWdHpILYQ7kNvgFtNXPK&_nc_ad=z-m&_nc_cid=0&_nc_ht=scontent-lga3-1.xx&oh=00_AYD8FPxif3zWq8LGi0dMIQmEKLeaTWUf4HxAOeymVTDFGA&oe=66D256C8",
            "url": "https://www.facebook.com/61554851735496"
        },
        ...
    ],
    "page_info": {
        "start_cursor": "AQHR92kUCxhEURCVQinru214DHockhesnk1C5vKUiBQ6ZLYKmjxJxrpSi_rRA_Sz6kIQ1d_LmyDgzqukjfM-ySrMxw",
        "end_cursor": "AQHRSaf1egob08xcHefvboawtU9yuInal6joG1AgJ49HgvkCOsQhqW1CBuO4fczcX2F3b1KWvbwFb9x9V9zhG5PZ-A",
        "has_previous_page": false,
        "has_next_page": true
    }
}

Profile Followers

Description

This endpoint retrieves the list of followers of a specific Facebook profile based on its profile ID.

Endpoint

POST api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/followers

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data is to be retrieved.

end_cursor

No

Body Param

BString | The cursor to paginate

typed_query

No

Body Param

String | The query to search for

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/100014807225880/followers' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "count": 114689,
    "results": [
        {
            "id": "61564447895335",
            "name": "Minh Pham",
            "profilePicture": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.30808-1/456103573_122099969786481596_1078033593112717992_n.jpg?stp=cp0_dst-jpg_e15_q65_s240x240&_nc_cat=111&ccb=1-7&_nc_sid=10b96e&_nc_ohc=dHLatrexFOUQ7kNvgE4ZY0M&_nc_ad=z-m&_nc_cid=0&_nc_ht=scontent-iad3-2.xx&oh=00_AYA-9uMhrHdGvHgV0F08-BsZvmolNfJQGju0nrgmVR_S7Q&oe=66D24B5E",
            "profile_picture": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.30808-1/456103573_122099969786481596_1078033593112717992_n.jpg?stp=cp0_dst-jpg_e15_q65_s240x240&_nc_cat=111&ccb=1-7&_nc_sid=10b96e&_nc_ohc=dHLatrexFOUQ7kNvgE4ZY0M&_nc_ad=z-m&_nc_cid=0&_nc_ht=scontent-iad3-2.xx&oh=00_AYA-9uMhrHdGvHgV0F08-BsZvmolNfJQGju0nrgmVR_S7Q&oe=66D24B5E",
            "url": "https://www.facebook.com/61564447895335"
        },
        ...
    ],
    "page_info": {
        "start_cursor": "AQHRGkQvBMEREHvItq6AmtwZLMGJLt4BvxnfyPRlpnENTaQohJNLdKJhkDWJxBaxztlG3cmSkF22JsOsvXr4TfqPhg",
        "end_cursor": "AQHRD9ow0Xq1ipeXdOh4_Q_X0_rtVNZz8JRFY_LwNFxbhMITMnZ3J21Tt0PdP7y6GXvV6SEbF8TMpw0fwuli8auNVw",
        "has_previous_page": false,
        "has_next_page": true
    }
}

Profile Friends

Description

This endpoint retrieves the list of friends for a specific Facebook profile based on its profile ID.

Endpoint

POST api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/friends

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data is to be retrieved.

search_term

No

Body Param

String | The cursor to paginate

end_cursor

No

Body Param

String | The search term

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/100014807225880/friends' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "count": 4996,
    "name": "Senia Waldberg",
    "results": [
        {
            "id": "100095066641736",
            "name": "Gail Shoresh",
            "profile_picture": "https://scontent.fedi1-1.fna.fbcdn.net/v/t39.30808-1/424601591_232417216603832_8515810159176708758_n.jpg?stp=cp0_dst-jpg_e15_q65_s240x240&_nc_cat=107&ccb=1-7&_nc_sid=0ecb9b&_nc_ohc=O2AV809K04YQ7kNvgExMtcu&_nc_ad=z-m&_nc_cid=1001&_nc_ht=scontent.fedi1-1.fna&oh=00_AYDpXH312Cgr99lYz7kOThkodhFkJrxKgBPcNmgf1XZBdw&oe=66D26216",
            "url": "https://www.facebook.com/100095066641736"
        },
        ...
    ],
    "page_info": {
        "start_cursor": "AQHRrDg_gZp0GN5NoKlIsOXAd8l2pCFJBWiluktF2dy3yKu4fFG40zxn6XXjIkZBlHI6jTJWh357gGe_4KyuPUrqZQ",
        "end_cursor": "AQHR9DyepqNC93g1He_TW4mwNdWMmBo9vkdgnTA36pQhpSCswPFc4sEWc3k7jtCd_mTqdh5SqpcfoGvBBb8vPLSZyA",
        "has_previous_page": false,
        "has_next_page": true
    }
}

Profile Checkins

Description

This endpoint retrieves the list of check-ins for a specific Facebook profile based on its profile ID

Endpoint

POST api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/checkins

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data 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/profiles/722677142/checkins' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "data": {
        "node": {
            "__typename": "TimelineAppCollection",
            "pageItems": {
                "edges": [
                    {
                        "node": {
                            "id": "YXBwX2l0ZW06NzIyNjc3MTQyOjMwMjMyNDQyNTc5MDoxMDM6OjEwMTU5NDE2OTg0ODQ3MTQz",
                            "image": {
                                "uri": "https://scontent-mia3-1.xx.fbcdn.net/v/t39.30808-1/327447928_6616386438377253_3916061746311866974_n.jpg?stp=dst-jpg_s160x160&_nc_cat=108&ccb=1-7&_nc_sid=e61854&_nc_ohc=k9cfAAvReUsQ7kNvgEzpkRm&_nc_ht=scontent-mia3-1.xx&oh=00_AYAguvvY5CcBYd75vyvtZE0-YaAkPZdJf3NpAqMOSkoEZQ&oe=66D2407A"
                            },
                            "title": {
                                "text": "Musée des Arts et Métiers"
                            },
                            "subtitle_text": {
                                "delight_ranges": [],
                                "image_ranges": [],
                                "inline_style_ranges": [],
                                "aggregated_ranges": [],
                                "ranges": [],
                                "color_ranges": [],
                                "text": "Paris, France\nVisited on April 6, 2024"
                            },
                            "url": "https://facebook.com/musee.des.arts.et.metiers",
                            "actions_renderer": null,
                            "privacy_scope": null,
                            "node": {
                                "__typename": "Page",
                                "id": "118701377171",
                                "__isEntity": "Page",
                                "url": "https://facebook.com/musee.des.arts.et.metiers"
                            },
                            "__typename": "TimelineAppCollectionItem"
                        },
                        "cursor": "AQHRSyRU2rbiKKnUHuA2GR1X3XvIpGC9Y1nLP-27Cew8j0NntV3TZ2O3jR5mB9GX0qL_cfsFipszozPk9LIwJrEzBg"
                    }
                ],
                "page_info": {
                    "end_cursor": "AQHR2dt0TSggcbsxx_wGgX1uGeMsj61t8VOaI8dl6NN_VKWDIvNTG27BmD21XLjIwYtujlA6Lk5J4jF3NjVi9H0owQ",
                    "has_next_page": true
                }
            },
            "id": "YXBwX2NvbGxlY3Rpb246NzIyNjc3MTQyOjMwMjMyNDQyNTc5MDoxMDM="
        }
    }
}

Profile Likes

Description

This endpoint retrieves the list of likes for a specific Facebook profile based on its profile ID.

Endpoint

POST api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/likes

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data 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/profiles/722677142/likes' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "data": {
        "node": {
            "__typename": "TimelineAppCollection",
            "pageItems": {
                "edges": [
                    {
                        "node": {
                            "id": "YXBwX2l0ZW06NzIyNjc3MTQyOjI0MDk5OTcyNTQ6OTY6OjEwNTU4NDU3MjgwNzk4Ng==",
                            "node": {
                                "__typename": "Page",
                                "id": "105584572807986",
                                "__isEntity": "Page",
                                "url": "https://www.facebook.com/pages/Courant-Institute-of-Mathematical-Sciences/105584572807986"
                            },
                            "collection_item_type": null,
                            "image": {
                                "uri": "https://scontent-mia3-1.xx.fbcdn.net/v/t1.30497-1/84687230_2222103328096112_4091110349787365376_n.png?stp=c81.0.275.275a_dst-png_s275x275&_nc_cat=108&ccb=1-7&_nc_sid=990cb8&_nc_ohc=7KWERB8XFYoQ7kNvgEZleqg&_nc_ht=scontent-mia3-1.xx&oh=00_AYB7ZwDSKDoyT4FmCFajH8G8aLQYh7weUtyTkeYMn53Ssg&oe=66F3E2D7"
                            },
                            "title": {
                                "text": "Courant Institute of Mathematical Sciences"
                            },
                            "subtitle_text": null,
                            "url": "https://www.facebook.com/pages/Courant-Institute-of-Mathematical-Sciences/105584572807986",
                            "__typename": "TimelineAppCollectionItem"
                        },
                        "cursor": "AQHR5BwFl1CfoK28ZKRaw9id0vBxEezSPcspFOgUnVmd32rbMGz1oPXq-wLpEl7SI7N_g6EuUa89AniOOG3L_T1ky8p0ahbAUcD8LWpCzcK_xS3a9MoUybIl3Wl1PCfPE2Uc"
                    },
                    ...
                ],
                "page_info": {
                    "end_cursor": "AQHRcJVbGsE_yf6kzfb0LNkJWWctv_MWk5Iq1m0oJqFfQX4Lun2POIcnrYDkwa2a205xaJPJdKwREUC_5QOgPaMvSA",
                    "has_next_page": false
                }
            },
            "id": "YXBwX2NvbGxlY3Rpb246NzIyNjc3MTQyOjI0MDk5OTcyNTQ6OTY="
        }
    }
}

Profile Videos

Description

This endpoint retrieves the list of check-ins for a specific Facebook profile based on its profile ID

Endpoint

POST api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/videos

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data 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/profiles/722677142/videos' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "data": {
        "node": {
            "__typename": "User",
            "strong_id__": "722677142",
            "id": "722677142",
            "uploaded_videos": {
                "nodes": [
                    {
                        "id": "1015665063436603",
                        "__typename": "Video",
                        "strong_id__": "1015665063436603",
                        "squareLargeImage": {...},
                        "largeThumbnail": {...},
                        "largePortraitImage": {...},
                        "imageThumbnail": {...},
                        "imageLow": {...},
                        "imageHigh": {...},
                        "portrait": {...},
                        "feedback": {...},
                        "landscape": {...},
                        "image": {...},
                        "imageMedium": {...},
                        "narrowLandscapeImage": {...},
                        "narrowPortraitImage": {...},
                        "is_playable": true,
                        "playable_url": "https://video-lga3-1.xx.fbcdn.net/v/t42.1790-2/454986407_514603867597506_6920704601778818194_n.mp4?_nc_cat=102&ccb=1-7&_nc_sid=55d0d3&efg=eyJybHIiOjU0MSwicmxhIjo1MTIsInZlbmNvZGVfdGFnIjoic3ZlX3NkIiwidmlkZW9faWQiOjEwMTU2NjUwNjM0MzY2MDN9&_nc_ohc=kAdoJGFoGc0Q7kNvgFYAZvW&_nc_ht=video-lga3-1.xx&oh=00_AYDgHg9ECk6VjQjqnoAE0sB6PzZ6PkBuPzzhxx9ZWj3WCQ&oe=66D243BC",
                        "playable_duration_in_ms": 12045,
                        "width": 1920,
                        "height": 1080,
                        "is_looping": true,
                        "loop_count": 7,
                        "creation_story": {...}
                    },
                    ...
                ],
                "page_info": {
                    "has_next_page": true,
                    "end_cursor": "AQHRVhMK42q2_7nkM-nE9QYg6g1eTOFVPXdgq4UBxKqejWKJou8zAvoC5TRDuEhjW9FQqrmN3sRGvGrCYChfSQ2QTw",
                    "start_cursor": "AQHRjOvmerUagqAPtOBP9H_X4KuwnnM_L-6Ze8OKCk24ALZvQiIG9zzas5F6PyUmzwPC8_Ih6gT62JhzQw_HkgIRqg",
                    "has_previous_page": false
                },
                "count": 162
            }
        }
    },
    "extensions": {
        "server_metadata": {
            "request_start_time_ms": 1724676561021,
            "time_at_flush_ms": 1724676561685
        },
        "is_final": true
    }
}

Profile Albums

Description

This endpoint retrieves profile's albums section.

Endpoint

POST api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/albums

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data 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/profiles/722677142/albums' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "data": {
        "node": {
            "__typename": "User",
            "strong_id__": "722677142",
            "id": "722677142",
            "albums": {
                "page_info": {
                    "has_next_page": false,
                    "end_cursor": "414564017142",
                    "start_cursor": "426092997142",
                    "has_previous_page": false
                },
                "nodes": [
                    {
                        "id": "426092997142",
                        "media": {
                            "count": 5
                        },
                        "photo_items": {
                            "count": 5
                        },
                        "owner": {
                            "__typename": "User",
                            "strong_id__": "722677142",
                            "id": "722677142",
                            "name": "Yann LeCun"
                        },
                        "title": {
                            "text": "Profile pictures"
                        },
                        "privacy_scope": {
                            "privacy_write_id": "cHJpdmFjeV9zY29wZV9yZW5kZXJlcjp7ImlkIjo0MjYwOTI5OTcxNDJ9",
                            "extended_description": "Yann LeCun set who can see what's posted in this album.",
                            "label": "Custom",
                            "icon_image": {
                                "name": "custom",
                                "uri": "https://static.xx.fbcdn.net/rsrc.php/v4/yY/r/3iTcWByShpb.png"
                            },
                            "description": "Each photo has its own privacy setting",
                            "selected_privacy_option": {
                                "edges": []
                            },
                            "type": "custom",
                            "legacy_graph_api_privacy_json": "{\"value\":\"EVERYONE\"}",
                            "privacy_options": {
                                "edges": []
                            }
                        },
                        "media_owner_object": {
                            "__typename": "User",
                            "strong_id__": "722677142",
                            "id": "722677142",
                            "is_page_or_profile_plus_actor": false
                        },
                        "can_upload": false,
                        "album_type": "PROFILE",
                        "contributors": [
                            {
                                "__typename": "User",
                                "strong_id__": "722677142",
                                "id": "722677142",
                                "name": "Yann LeCun",
                                "profile_picture": {
                                    "uri": "https://scontent-mia3-2.xx.fbcdn.net/v/t39.30808-1/271834751_10158079704667143_1760195658663702190_n.jpg?stp=c425.480.714.715a_cp0_dst-jpg_e15_q65_s50x50_tt6&_nc_cat=107&ccb=1-7&_nc_sid=e99d92&_nc_ohc=a6ql5VfhrJAQ7kNvgH2FY6y&_nc_ad=z-m&_nc_cid=0&_nc_zt=24&_nc_ht=scontent-mia3-2.xx&oh=00_AYCAymoxpqhitUwk8Z2cEHCfv-nI53A4IhuW_pzUGst85A&oe=6777628B",
                                    "height": 50,
                                    "width": 50
                                }
                            }
                        ],
                        "album_cover_focused_image": {
                            "image": {
                                "__typename": "Photo",
                                "strong_id__": "10158079704677143",
                                "imageThumbnail": {
                                    "uri": "https://scontent-mia3-2.xx.fbcdn.net/v/t39.30808-6/271834751_10158079704667143_1760195658663702190_n.jpg?stp=c0.225.1366.1366a_cp0_dst-jpg_e15_q65_s261x260_tt6&_nc_cat=107&ccb=1-7&_nc_sid=6ee11a&_nc_ohc=a6ql5VfhrJAQ7kNvgH2FY6y&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-2.xx&oh=00_AYB632DgPklsna1tN7pPSXctjf6uOXdysjeSgasIGv23sg&oe=67776F3B"
                                }
                            }
                        },
                        "created_time": 1283987370,
                        "modified_time": 1642088675,
                        "message": null,
                        "can_viewer_delete": false,
                        "can_edit_caption": false,
                        "feedback": null
                    },
                ]
            }
        }
    },
    "extensions": {
        "server_metadata": {
            "request_start_time_ms": 1735501842685,
            "time_at_flush_ms": 1735501843167
        },
        "is_final": true
    }
}

Profile Search Post

Description

This endpoint allows you to search for posts on a specific Facebook profile based on its profile ID.

Endpoint

POST api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/search

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data is to be retrieved.

query

No

Body Param

String | The search query string used to filter posts.

end_cursor

No

Body Param

String | The cursor to paginate

city_id

No

Body Param

String | search filters endpoint with city filter type to get this value

start_time

No

Body Param

String | UNIX timestamp of the start time to use as a filter.

end_time

No

Body Param

String | UNIX timestamp of the end time to use as a filter.

recent_post

No

Body Param

Boolean | set true add a recent posts search filter

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/722677142/search' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "query": "world"
}'
Example Response
{
    "data": {
        "search_query": {
            "cache_id": "3261544372284063655",
            "query_function": "keywords_search(world)",
            "logging_unit_id": "browse_serp:ee48bfcb-e050-4b0f-ae6e-d27f3fcf0802",
            "combined_results": {
                "page_info": {...},
                "has_hcm": false,
                "degradation_level": null,
                "has_iem_triggered": false,
                "is_cache_hit": null,
                "edges": [
                     {
                        "result_display_styles": [],
                        "logging_unit_id": "browse_rl:31b60bb1-4f11-4312-8a7e-39607308d24b",
                        "module_role": "FEED_POSTS",
                        "result_role": "FEED_POSTS",
                        "node": null,
                        "node_story": null,
                        "story_decoration": null,
                        "see_more_query": null,
                        "result_decoration": null,
                        "native_template_view": {...},
                        "native_template_split_views": [],
                        "native_template_result_ids": [
                            "10158953275587143:12:0"
                        ]
                    },
                    ...
                ],
                "speller_confidence": "NONE",
                "speller_nt_view": null,
                "corrected_query": null
            },
            "filter_type_sets": [
                {
                    "filters": [
                        {
                            "main_filter": null,
                            "filter_shortcut": "POSTS"
                        },
                        ...
                    ]
                }
            ]
        }
    }
}

Profile Tagged Media

Description

This endpoint retrieves the list of media where a specific Facebook profile has been tagged

Endpoint

POST api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/tagged-media

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data 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/profiles/100044176822324/tagged-media' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "data": {
        "node": {
            "__typename": "User",
            "strong_id__": "722677142",
            "id": "722677142",
            "tagged_mediaset": null
        }
    },
    "extensions": {
        "server_metadata": {
            "request_start_time_ms": 1724677621915,
            "time_at_flush_ms": 1724677621941
        },
        "is_final": true
    }
}

Profile Uploaded Media

Description

This endpoint retrieves the list of media that a specific Facebook profile has uploaded.

Endpoint

POST api/v1/realtime/social/facebook/v1/profiles/{{profileId}}/tagged-media

Parameters

Param
Required
Param Type
Description

profileId

Yes

Path Param

String | The unique identifier for the Facebook profile whose data 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/profiles/722677142/uploaded-media' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "data": {
        "profile": {
            "__typename": "User",
            "strong_id__": "722677142",
            "id": "722677142",
            "uploaded_mediaset": {
                "id": "bWVkaWFzZXQ6cGIuNzIyNjc3MTQyLi0yMjA3NTIwMDAw",
                "__typename": "MediaUploadedByUserMediaSet",
                "strong_id__": "bWVkaWFzZXQ6cGIuNzIyNjc3MTQyLi0yMjA3NTIwMDAw",
                "media": {
                    "page_info": {...},
                    "nodes": [
                        {
                            "__typename": "Photo",
                            "strong_id__": "10159661046422143",
                            "squareLargeImage": {...},
                            "largeThumbnail": {...},
                            "largePortraitImage": {...},
                            "imageThumbnail": {...},
                            "imageLow": {...},
                            "imageHigh": {...},
                            "portrait": {...},
                            "feedback": {...},
                            "landscape": {...},
                            "id": "10159661046422143",
                            "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": 1724677313614,
            "time_at_flush_ms": 1724677313792
        },
        "is_final": true
    }
}

Last updated