Nimble Home Login Create an Account

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

ParamRequiredParam TypeDescription

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

ParamRequiredParam TypeDescription

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 Header

Description

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

Endpoint

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

Parameters

ParamRequiredParam TypeDescription

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/header' \
--header 'Authorization: Basic <credential string>'
Example Response
{
    "data": {
        "user": {
            "profile_header_renderer": {
                "__typename": "XFBProfileEntityConvergenceHeaderRenderer",
                "user": {...},
                "viewer": {
                    "is_wem_private_sharing_enabled": false
                },
                "nux": null,
                "restriction_violation_status": "No Violations.",
                "__module_operation_ProfileCometHeaderQuery": {
                    "__dr": "ProfileCometEntityConvergenceHeaderWrapper_profileHeaderRenderer$normalization.graphql"
                },
                "__module_component_ProfileCometHeaderQuery": {
                    "__dr": "ProfileCometEntityConvergenceHeaderWrapper.react"
                }
            },
            "id": "pfbid02HVsnBFmp4RsimVP4sYMg92A9MhtA9EBHFkM3xH4Ar71JBV9ZekuE472PxZRw6nRnl",
            "profile_plus_post_transition_modal": null
        }
    }
}

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

ParamRequiredParam TypeDescription

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

ParamRequiredParam TypeDescription

profileId

Yes

Path Param

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

transform

No

Body Param

Bool | A flag indicating whether the response should be transformed or formatted. Pass true to apply transformations, or false to get the raw response.

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/722677142/feed' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "transform": true
}'
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

ParamRequiredParam TypeDescription

profileId

Yes

Path Param

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

transform

No

Body Param

Bool | A flag indicating whether the response should be transformed or formatted. Pass true to apply transformations, or false to get the raw response.

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/100014807225880/following' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "transform": true
}'
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

ParamRequiredParam TypeDescription

profileId

Yes

Path Param

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

transform

No

Body Param

Bool | A flag indicating whether the response should be transformed or formatted. Pass true to apply transformations, or false to get the raw response.

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/100014807225880/followers' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "transform": true
}'
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

ParamRequiredParam TypeDescription

profileId

Yes

Path Param

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

transform

No

Body Param

Bool | A flag indicating whether the response should be transformed or formatted. Pass true to apply transformations, or false to get the raw response.

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/100014807225880/friends' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "transform": true
}'
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

ParamRequiredParam TypeDescription

profileId

Yes

Path Param

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

transform

No

Body Param

Bool | A flag indicating whether the response should be transformed or formatted. Pass true to apply transformations, or false to get the raw response.

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/722677142/checkins' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "transform": true
}'
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

ParamRequiredParam TypeDescription

profileId

Yes

Path Param

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

transform

No

Body Param

Bool | A flag indicating whether the response should be transformed or formatted. Pass true to apply transformations, or false to get the raw response.

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/722677142/likes' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "transform": true
}'
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

ParamRequiredParam TypeDescription

profileId

Yes

Path Param

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

transform

No

Body Param

Bool | A flag indicating whether the response should be transformed or formatted. Pass true to apply transformations, or false to get the raw response.

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/722677142/videos' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "transform": true
}'
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 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

ParamRequiredParam TypeDescription

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.

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

ParamRequiredParam TypeDescription

profileId

Yes

Path Param

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

transform

No

Body Param

Bool | A flag indicating whether the response should be transformed or formatted. Pass true to apply transformations, or false to get the raw response.

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/100044176822324/tagged-media' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "transform": true
}'
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

ParamRequiredParam TypeDescription

profileId

Yes

Path Param

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

transform

No

Body Param

Bool | A flag indicating whether the response should be transformed or formatted. Pass true to apply transformations, or false to get the raw response.

Example Request
curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/profiles/722677142/uploaded-media' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "transform": true
}'
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