Search

Search All

Description

This endpoint performs a comprehensive search across Facebook, allowing you to search for various types of content including posts, pages, groups, and more based on the provided query.

Endpoint

POST api/v1/realtime/social/facebook/v1/search/all

Parameters

Param	Required	Param Type	Description
typed_query	Yes	Body Param	String | The search query string used to find matching content across Facebook.
end_cursor	No	Body Param	String | The cursor to paginate
disable_blocks	No	Body Param	Boolean | This parameter allows you to decide the data structure of the response from Facebook, whether to return data in Bloks or JSON form. Bloks is a proprietary format of Facebook, so we suggest setting this parameter to true

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/search/all' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "typed_query": "olympics2024"
}'

Example Response

{
    "data": {
        "search_query": {
            "cache_id": "2344920769953646283",
            "query_function": "keywords_search(olympics2024)",
            "logging_unit_id": "browse_serp:3eab094d-1527-4fd9-a8db-4f01acfd146c",
            "combined_results": {
                "page_info": {...},
                "has_hcm": false,
                "degradation_level": null,
                "has_iem_triggered": false,
                "is_cache_hit": null,
                "edges": [...],
                "speller_confidence": "NONE",
                "speller_nt_view": null,
                "corrected_query": null
            },
            "filter_type_sets": [
                {
                    "filters": [
                        {
                            "main_filter": null,
                            "filter_shortcut": "POSTS"
                        },
                        ...
                    ]
                }
            ]
        }
    }
}

---

Search Posts

Description

This endpoint allows you to search for posts across Facebook that match the provided query. It retrieves posts that contain the specified search term.

Endpoint

POST api/v1/realtime/social/facebook/v1/search/posts

Parameters

Param	Required	Param Type	Description
typed_query	Yes	Body Param	String | The search query string used to find matching content across Facebook.
end_cursor	No	Body Param	String | The cursor to paginate
disable_blocks	No	Body Param	Boolean | This parameter allows you to decide the data structure of the response from Facebook, whether to return data in Bloks or JSON form. Bloks is a proprietary format of Facebook, so we suggest setting this parameter to true
start_date	No	Body Param	String | ISO date of the start date to use as a filter
end_date	No	Body Param	String | ISO date of the end date to use as a filter
public_posts	No	Body Param	Boolean | set true to add a public posts filter (search public posts).
city_id	No	Body Param	String | tagged location filter - use search filters endpoint with city filter type to get this value
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/search/posts' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "typed_query": "olympics2024"
}'

Example Response

{
    "data": {
        "search_query": {
            "cache_id": "5637959455477343283",
            "query_function": "keywords_blended_posts(olympics2024)",
            "logging_unit_id": "browse_serp:2167fe21-def9-4bdb-b9ce-6f3ebdb6b2fe",
            "combined_results": {
                "page_info": {...},
                "has_hcm": false,
                "degradation_level": null,
                "has_iem_triggered": false,
                "is_cache_hit": null,
                "edges": [...],
                "speller_confidence": "NONE",
                "speller_nt_view": null,
                "corrected_query": null
            },
            "filter_type_sets": [
                {
                    "filters": [
                        {
                            "main_filter": {
                                "cache_id": "-4372916532594624232",
                                "custom_value": null,
                                "id": "Z3NxZjp7IjAiOiJicm93c2VfaW5zdGFudF9maWx0ZXIiLCIxIjoia2V5d29yZHNfYmxlbmRlZF9wb3N0cyhvbHltcGljczIwMjQpIiwiMyI6ImE2NzQyZmMxLTNmYTgtNDJkMi05OGJhLTBmZjBlM2YwZTI1NiIsImN1c3RvbV92YWx1ZSI6bnVsbH0=",
                                "name": "recent_posts",
                                "text": "Recent Posts",
                                "filter_icon": "CLOCK",
                                "default_option_text": null,
                                "search_place_holder": null,
                                "pill_button_type": "TOGGLE",
                                "filter_set_key": null,
                                "tab_display_style": null,
                                "handle": null,
                                "exclude_from_filter_bar": false,
                                "exclude_from_filters_dialog": false,
                                "implicit_values": [],
                                "filter_values": {
                                    "edges": [...]
                                },
                                "current_value": null
                            },
                            "filter_shortcut": null
                        },
                    ]
                }
            ]
        }
    }
}

---

Search Events

Description

This endpoint allows you to search for events on Facebook that match the provided query. It retrieves events that contain the specified search term.

Endpoint

POST api/v1/realtime/social/facebook/v1/search/events

Parameters

Param	Required	Param Type	Description
typed_query	Yes	Body Param	String | The search query string used to find matching content across Facebook.
end_cursor	No	Body Param	String | The cursor to paginate
disable_blocks	No	Body Param	Boolean | This parameter allows you to decide the data structure of the response from Facebook, whether to return data in Bloks or JSON form. Bloks is a proprietary format of Facebook, so we suggest setting this parameter to true
start_date	No	Body Param	String | ISO date of the start date to use as a filter
end_date	No	Body Param	String | ISO date of the end date to use as a filter
city_id	No	Body Param	String | tagged location filter - use search filters endpoint with city filter type to get this value

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/search/events' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "typed_query": "olympics2024"
}'

Example Response

{
    "data": {
        "search_query": {
            "cache_id": "-4300362989237728472",
            "query_function": "keywords_events(olympics2024)",
            "logging_unit_id": "browse_serp:177c8373-959f-4d70-bd59-772d96010b57",
            "combined_results": {
                "page_info": {...},
                "has_hcm": false,
                "degradation_level": null,
                "has_iem_triggered": false,
                "is_cache_hit": null,
                "edges": [...],
                "speller_confidence": "NONE",
                "speller_nt_view": null,
                "corrected_query": null
            },
            "filter_type_sets": [
                {
                    "filters": [...]
                }
            ]
        }
    }
}

---

Search Photos

Description

This endpoint allows you to search for photos on Facebook that match the provided query. It retrieves photos that contain the specified search term.

Endpoint

POST api/v1/realtime/social/facebook/v1/search/photos

Parameters

Param	Required	Param Type	Description
typed_query	Yes	Body Param	String | The search query string used to find matching content across Facebook.
end_cursor	No	Body Param	String | The cursor to paginate
disable_blocks	No	Body Param	Boolean | This parameter allows you to decide the data structure of the response from Facebook, whether to return data in Bloks or JSON form. Bloks is a proprietary format of Facebook, so we suggest setting this parameter to true
start_date	No	Body Param	String | ISO date of the start date to use as a filter
end_date	No	Body Param	String | ISO date of the end date to use as a filter

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/search/photos' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "typed_query": "olympics2024"
}'

Example Response

{
    "data": {
        "search_query": {
            "cache_id": "-5867555737346517536",
            "query_function": "keywords_blended_photos(olympics2024)",
            "logging_unit_id": "browse_serp:63388724-1d8c-47e8-86d9-ec3391e46588",
            "combined_results": {
                "page_info": {
                    "start_cursor": null,
                    "end_cursor": "Abo4epN-xm9jy37fDJ3VjLVi3x7QbmjF_CR_J8uVptgnedzvQlxsXwY5mMmpsI7SwvbESwPdzQLsTtpHvw-WDXjkN0ObIJLnnP2Vu6yqEI0ZtLu87x2Pd7pHh_eJNXYeEQV3mDTWLMj_IechvRVknveWvhskhTwO-CrlKVUK_VQR4yDKtGGY1k-q3sP11YuJtEnl3LJyj-e4aj70ADX9h3CRbxwhDk9yzubLMJ21wo6RbQPHXFejybnA4d_ikClKZa1QglxuEewyslvaS9NPoDbH-k2MRhW_9kqXbFCxP7XvJjs0_CPZNoT8GwnfM4RvB-Yrav1BIIlWDxAwV7WHlZWaCzUrlO-p7_tCuiHWa744TPwk5IuGErVvvc3qaPC6YZb6IFRA7qc3tmT2P8NhStzBhDlDovxZGbbUzlSbgxzy9HQmMaqf-cQEX_LZuYCvwXvwsEY6WvZK1BwaQ7IosceJh5qPZM_InwhBZ93w-uLCjOrGNWpn7NJZ7hbQS10qJ2SD_AJXyW167NescsLCzS7LhF8WFxgOjC3IUilCfUfj7-Hv482n6I9zEVZVlVSETcRkQan4s19XDMwYGigSUtigzDQY2emq1gVC6z94fzgv23qrCmEDcYJ-RW9t2qX4SYWY5Xo4sz6RA1Gj407kJ4bMwVlY-xV1ICMSskOuMu5eer0UeTnLpuxXgjK6XheyedLPRR8cJVnf2BRBfBRsNaTjK5bXyWJyrTsTlT9Qog4y1UJAGXNGcQZaijdxyDebmQe2tIghmh8itfkyZITzS_NmIbO94n0Wl3NfKbL7Fp1lmuNJsmihNxzB5QSYpbuLJzCmManbQK0C1t5oaty3ncBFL-5rBr5W25Ig_baaXaty9Sz3svHlrcaUvZJYu5UGN4T5dnQlKJGtGLjOYFkegjFhu2db57nGpw9ejsQNe-uQQUQZ-i4ruLza4g9x4BqNws4M_VQt78xGS_0rhmBAhvi84yhHZLO5MMUaeMHvNiQ56ZP9fDpK12Fmn0Z6UycbyqhgKfgfRTPmNTKIGGqfD0q9Vc6i1Q98lVfbooHOSu1Tr1BOyXf4EJsfwIS-qD5xaTAn1iA-XrlfcEUIgdDWr47iN35MVNW7kkuEguoKh_xF6JphBjWdZmmoBGs06d-qDRCW-zRXUInFnnxMSZzORPm21wrnGZ0QkQIbcr_8a7WH1JeJ8NY45UxPJK0sGq1RMVEzMC4_urRuFIg3rDeYN_SoP27tttlQjhAb2bIz0IiDAgeohD0Z9LeMUex0oQPFo6BLi01BqqXzM6kxxZmSNzezK5SIft8kD2SEjZlzKDEdAo9QX9ciFVdgj_nx2L8j5lDeAAYBLBSkgZHDxzFkgc6nbhwg3f8XAXL4KQX2bi7GDfWr0hsC2xPmaoC4dSnH0JSr-gBByMMcenzMBUz7bWCRcK3AeV_m55XSvX86xv0ILrcScYrlsyOlOdidNu5rsCoXUheclYr7EKHZiNO5RpyvnsPNJALWhAnnrZYOsQdEZKDWVJgADCAy0gIHNhUiSWDS71zygb2M-y-jo9dzOJAJhdDUxENL3uN20hqaA1aO432ExX6lF9yYhfvNFh21-L5cvHhEH60KuUB2WG5ATDG1YD_yPwGKrTEuCn5YBi3bX-HHrby8q-7sPnuajCoDv_GSBqwLeUB-P7EeaHUzlyIZPqg0xk6bcJPdPJIbgYxGHztJ-OeToQxDCPf5-0qLS9ISVmwfhV1xjXa3-zkbPlxsF26ccieoyT42cs09152aQc6HGQ157kxxLYdtbCJ0gBsa5jGR89fr9LlDzRGMG0K9J_5BCPM47e1FfUYJarIbI_y6R9Luz5kH3l3B65cl_XQlDtJ2UNGEw6s4z_rg27oxDslcQIit1NH3C2qkv6E7vg",
                    "has_previous_page": true,
                    "has_next_page": true
                },
                "has_hcm": false,
                "degradation_level": null,
                "has_iem_triggered": false,
                "is_cache_hit": null,
                "edges": [...],
                "speller_confidence": "NONE",
                "speller_nt_view": null,
                "corrected_query": null
            },
            "filter_type_sets": [...]
        }
    }
}

---

Search Videos

Description

This endpoint allows you to search for videos across Facebook based on the provided query. It retrieves videos that match the specified search term.

Endpoint

POST api/v1/realtime/social/facebook/v1/search/videos

Parameters

Param	Required	Param Type	Description
typed_query	Yes	Body Param	String | The search query string used to find matching content across Facebook.
end_cursor	No	Body Param	String | The cursor to paginate
disable_blocks	No	Body Param	Boolean | This parameter allows you to decide the data structure of the response from Facebook, whether to return data in Bloks or JSON form. Bloks is a proprietary format of Facebook, so we suggest setting this parameter to true
start_date	No	Body Param	String | ISO date of the start date to use as a filter
end_date	No	Body Param	String | ISO date of the end date to use as a filter
live_video	No	Body Param	Boolean | set true to add a live video filter

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/search/videos' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "typed_query": "olympics2024"
}'

Example Response

{
    "data": {
        "search_query": {
            "cache_id": "-2661061662294027033",
            "query_function": "keywords_video_home_search(olympics2024)",
            "logging_unit_id": "browse_serp:936a37c5-d8bc-4538-971d-4313c717474b",
            "combined_results": {
                "page_info": {
                    "start_cursor": null,
                    "end_cursor": "AbotO6C312RgDMQeRPzHt3lYW-_YEDhucf3-UyfstXq6IXLZZoP4Sc9wFI72LIsFJoeI8rJ3168xXiy99CBL3qU7y4vfpHnyUHYGWpow5AsBAAs9WkhwFj2QvlzNMrchb2CP5pOoHUwU56UKdRq-g3Cm7k2twSK1D4FjND79e0kIuIaqXq_cVA1we_Ogs96EsgjFq0It1LGLy4991YzcLWFbZ2Q6xHLzo_xdeNj-GF9Mk1wTEuRxgyZrtOD6X6wB-LsLQFVNuJkJV2Xo6NnOgZ7s3OyLX0JScoYyHpX8QlRq1oIDrQe03i8mVqEisvBmNzMDDib0jnf0UvOmoE9ONA9UMw-lWCI2UyFknpk02sTUJx686w7epIwQmzR758lEtAaQgrbk5K0UtgMyGGPJT0lhnZQlTbq-cUW93oKUGPoRkVGjYMLYyIsR7hphcBZNUV_Sla7PYS_1LCyEa-2b6Ewj9-tsmDr7WGHTOpx1PL-7VdiHDsFNo2elxRcsAVbYwySXtMXh_SbGFFJyRIy-2oRcOr_mcxYvyj8_l1YgD5fb6qRlPi3kcpeW_xcsBrduXiV_8oe0MUWXWKvpMgiesxxyKeJ2Sxkbs-iF0Ez3W5VnQfdL543x0kFDb0NHakPDDa5OS3yVF79k8KwFsj9w8z-1tHuTR8f5AeC7j7d9w3qpYyttrBZnCDC8MlNyW7KWbXo4sZSXbdjAeHzDC5ILDmKPm7ij6j4mEDq4-4N_hYhgAwRNH4SIz-g36FveEzUVMGvYGgifL2cmfVr0_ZXeabF3OrMCLnjiE9-OIUBC7Q4n_OtvdB9xKcMY9k2sqmtrTODxDq3Mcu3Yiwee-BXM1jcRqzpq6EeRnrFXQFJnC0LtOkPq3fgKLJ5OVHBR9KEOJ2ex40cUIlgper1rJqgHOyQW-WmcTT7MfGyrQAkcH_xILgpSu34nnUE9VfyD40Ax-4nF0D3ZfrHfo9OHXWntusvALZ9Wjl0WdcA8Ul8Hqr1QAQ_RnUgPnBcn9fvuSLnBZfQ1sOXnsCL2CXsdxJEhNM_H0O4bbX0vQS1UKPwcS-K0LQu7GdBnuopkiaSIDwRLv4nPbBucdu_WXuse7RTnj_LKSKilwe8GwRPNNfrpPUBGr4zz_MF43ChTFVpbQZY9e7xfTUeOZP7dIA8T6N5WTqsvntRfKuy0FitxezK5bmE-LPoxmQiGfeefmTtRTdEAZFSlvyXDrJMp0X6BW6DJaKWXHGufd0XeqA1PzJm_LmMwEXQtnB5jYhnxdSUo0nSUBk1a_pMIuTEVyxZzWei7VoDNzKZHqiMGQYHqA8J5roMXgFT0bh7LCym2WEwTCjWpR_uNzcxy2lYisgUkjyKoMmBO2EgId1GyOXHe6xC9yXDFXnkBf2oBEE3e1rA3PvhlOJZw5lNAF3TSvIXAAc6uWSKE5mrcbRaoVjd4Yl5dw-0yIIc4nyVL5eZR0QpeipPCZq5cZ5YhK72zolxX8vhHUZ5mZqIjl26ulTAjopgtmplfZw6N4XREHBjz1pTzHi7xoos8qesC3xtZfjcEHq3QKEFXZ9jYQhGhwvu5VjQvXimbrHrZwuTQH3pJ9t18UX4xrPC4Ar6NAGAAOYGW1BEpk-PoKhPtufrT0A1isqNJ28V4ruJLYuf6_9Q60IoYsnc1O7Y6T19hp3HjnEYJhn9DhaQkzsQaeeAQEwIsQvAvijWaSP_VHT1Aea4Qm9rve5qERZ_KzC1Rl24HehGulp1bwb9J0pl1QRgc0J9KjRhc2ffBnz6X1NEsJzHwByObZ9ZrFOnKpLDpxHXGL_LJ4h__RThc",
                    "has_previous_page": true,
                    "has_next_page": true
                },
                "has_hcm": false,
                "degradation_level": null,
                "has_iem_triggered": false,
                "is_cache_hit": null,
                "edges": [...],
                "speller_confidence": "NONE",
                "speller_nt_view": null,
                "corrected_query": null
            },
            "filter_type_sets": [...]
        }
    }
}

---

Search Users

Description

This endpoint allows you to search for users on Facebook that match the provided query. It retrieves user profiles that contain the specified search term.

Endpoint

POST api/v1/realtime/social/facebook/v1/search/users

Parameters

Param	Required	Param Type	Description
typed_query	Yes	Body Param	String | The search query string used to find matching content across Facebook.
end_cursor	No	Body Param	String | The cursor to paginate
disable_blocks	No	Body Param	Boolean | This parameter allows you to decide the data structure of the response from Facebook, whether to return data in Bloks or JSON form. Bloks is a proprietary format of Facebook, so we suggest setting this parameter to true
education_id	No	Body Param	String | Education ID filter, use the search filters endpoint to get values for here.
work_id	No	Body Param	String | work ID filter, use the search filters endpoint to get values for here.
city_id	No	Body Param	String | tagged location filter - use search filters endpoint with city filter type to get this value

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/search/users' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "typed_query": "olympics2024"
}'

Example Response

{
    "data": {
        "search_query": {
            "cache_id": "97215477438392655",
            "query_function": "keywords_users(olympics2024)",
            "logging_unit_id": "browse_serp:881939d7-8b66-4328-be36-72629b6de9f3",
            "combined_results": {
                "page_info": {
                    "start_cursor": null,
                    "end_cursor": "AboI9wID0h6lwnkHmpCjU-OH9KBVrVzAZsMcgXYJKNfLDfcDzwOLx63ao4v1ExlKHO4Nm0eqggqtKS2hYIR2kevRo6KXEPwpfLwL2fTcAfdRZlOg_RJKd2s856lv0xm9SZSLHEXxqUjCVP2Vi2ms9QgTQjZTchJZbUeY64SI9Z3-fayO5amfjzuM0pMbAdiCRgerVhpxhkDv6ANUCYAv3FPnkm7m1-exVqbjCZzucqBuAnIyK22l5GZuvXVJavp7-t0THPJff41d9YkOuMKCjGDPhDBs7fgXCfIPBv-PdqSbap0b618AXOkqCODNpClCSRatBEsl2l0WYk46G_1Ln_mwqTOeoO7-u5v26IH1_bGzgPkde6ySwugrQLV5VPql_NAaz18Tw7XR0lilivqq5w9vKk6jMtuwaLGRZlbcshhGqgtngQ9hIGMKqUyG7c-rlynorOtJO86f2S623INlmAO6Tea8u1hfHsZ2k1gNEZG6oIOaslbVY3LfG3D0n_pfO0isgH6xdL2yLgrk2qrjjUZaPQNZGPh3Ctn3b7uDluE-KX2d7Eda_mhLgeiI7paX3hcRXNjIW9SzqU62UM2jc88gLXesz6X3vAEWD_rp0UrIIXqZNHOxz9CfJH1XI6of9t_QcMsoTlgzuOPFHVo95570v95_2dSpzIUNP526Ad6_urA6KdXt5ErxZHsHD3FX6itYdaLUtS6hEA3N9RTLjUBUIv_bRnQ7eBDUZK2IzGuXt4U4E5cd5qZhMX3P6y9hn5StjmM0vffXUzJZuvkzcQ-Ga93ybukAMy9m5oJ5QncQDTFh-nSX1qcbN_oplKhbCaaHG0K0TH7abanVe5JGcFQ6FHjdmSnub1RFXDdfGoSRur1ti8vvOItoan8OgcFrsDcHI6FIGmIYylojT9E6FFea7eImP3b2tHRmCwl7T3C5ZzVQ_OGGpIfsmuuUlAMl95TcbKJT5s06r9lc7bmDJhxyjt0BFkzkrCl9XtBVrw5Op-ca0Bf8CFtGU44dFlsM29GQHiJGcqOJLsPJLFuueVFcXE8Fo18bjejElxGKN9psuW4N1t0MdhMoXhzuPceTtXar6GRbQqIqXg0m3JOveX10ArvhsxaoSuupoMo3jP7Aaqqr1nybGPEmYrhU0krp9_umIbpEg3RZiNKuWfYWKjzhFmmotPlUWxHLL6Fa21J3zTDo5QYsA3EXkYnVaAXBPRe1RJwMrWamJsG0TbrLRVuBGrdiiwuV1JMyGz7O_w5cZe0qwYGx9KLoxfDBcQglwkfOYxrrHDd_fJhA1xYAcIcHu1zrt8wbJEWqqXdoe99g0C_vm3TwVKSRccKY9lgxhSdHDjnIkSjyGTKkV1RUY6IPESxTGJgNxxjcwi6E9BWjlLoWLV24Sy-JeS1HLbax1-4xqpNPc_J43CfP80QnwPwTxpUO8e7fCOBVjM04pVZqB4MVuMU0gaG1ZzEN0-PpUzjjSEfCtwJJjXnHd0nFHExsC6bIUiaWtttvbFA2euFY6xcPEfdIXdQqmO37akKNjhm-RDB7RtbI4zGIy95cbRZfBRZn0jt3i9VAAHQpR5ICgYTHb_uSf5JOxA38h3AhIsnC_wp54LaoFpKWqdDownLIA7qYUwNPk4jyDTtyyDCJJ0AxjplZV2yleqy4tnKaifPMypazxni0N4XSWofb2GbDMJyt2Gp1B3oMLINdIm8vrELSjouN3P0rin-4OY1x91i3yJ9v8OALsOQE_l0GPiIkduDrz9J4E6KXVzzF4QoZow",
                    "has_previous_page": true,
                    "has_next_page": true
                },
                "has_hcm": false,
                "degradation_level": null,
                "has_iem_triggered": false,
                "is_cache_hit": null,
                "edges": [...],
                "speller_confidence": "NONE",
                "speller_nt_view": null,
                "corrected_query": null
            },
            "filter_type_sets": [...]
        }
    }
}

---

Search Groups

Description

This endpoint allows you to search for groups on Facebook that match the provided query. It retrieves groups that contain the specified search term.

Endpoint

POST api/v1/realtime/social/facebook/v1/search/groups

Parameters

Param	Required	Param Type	Description
typed_query	Yes	Body Param	String | The search query string used to find matching content across Facebook.
end_cursor	No	Body Param	String | The cursor to paginate
disable_blocks	No	Body Param	Boolean | This parameter allows you to decide the data structure of the response from Facebook, whether to return data in Bloks or JSON form. Bloks is a proprietary format of Facebook, so we suggest setting this parameter to true
city_id	No	Body Param	String | tagged location filter - use search filters endpoint with city filter type to get this value

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/search/groups' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "typed_query": "olympics2024"
}'

Example Response

{
  "results": [
    {
      "id": "258133816865470",
      "name": "Physics Is Fun",
      "url": "https://facebook.com/258133816865470",
      "description": "Physics Is Fun",
      "members": "442K",
      "info": "Public · 442K members · 10+ posts a day",
      "postsFrequency": "10+ posts a day",
      "privacy": "Public"
    },
    {
      "id": "2062556097204733",
      "name": "BASIC PHYSICS",
      "url": "https://facebook.com/2062556097204733",
      "description": "BASIC PHYSICS as its name it is a physics group here you all can ask and share anythings which is related physics or Quantum physics. Warm welcome all of you in this group. If you do well in this group then we will make you moderator of this group. Thank you. Enjoy a lot.",
      "members": "304K",
      "info": "Public · 304K members · 10 posts a day",
      "postsFrequency": "10 posts a day",
      "privacy": "Public"
    },
    {
      "id": "145676439380557",
      "name": "Physics of Everything (news group)",
      "url": "https://facebook.com/145676439380557",
      "description": "When we look deeply into any branch of science, physics is at its core . . . Love physics? Get involved in discovery and physics fun. Science ultimately is to explain how matter works, whether in black holes or brain cells . . . and our fascination is useful. So, explore with us, science in the making. Explore with us the big questions . . . science concerned with the nature and properties of matter and energy that includes mechanics, heat, light and other radiation, sound, electricity, magnetism, the structure of atoms, . . . and evolve physics. Please read the rules and announcements before joining. Please read the group rules, < goo.gl/tMoGL1 > here. Please read our welcome post < goo.gl/TLq52L > here. You can read about the group founder, < goo.gl/h35xeh > here. We DO NOT usually approve requests to join the group for Facebook accounts that are brand new and we look at accounts > as potentially not suitable for joining. IMPORTANT IMPORTANT rules news.... https://www.facebook.com/groups/PhysicsThing/permalink/662695077678688/ . .",
      "members": "98K",
      "info": "Public · 98K members · 6 posts a day",
      "postsFrequency": "6 posts a day",
      "privacy": "Public"
    },
    {
      "id": "160587383555070",
      "name": "Physics & Mathematics Lovers",
      "url": "https://facebook.com/160587383555070",
      "description": "This group is aimed at helping each other to solve problems in physics and mathematics",
      "members": "1.3M",
      "info": "Private · 1.3M members · 10+ posts a day",
      "postsFrequency": "10+ posts a day",
      "privacy": "Private"
    },
    {
      "id": "1719412901612923",
      "name": "Physics Astronomy...",
      "url": "https://facebook.com/1719412901612923",
      "description": "a group for physics enthusiasts especially physics astronomy ",
      "members": "157K",
      "info": "Public · 157K members · 2 posts a week",
      "postsFrequency": "2 posts a week",
      "privacy": "Public"
    },
    {
      "id": "3000799099957887",
      "name": "Quantum physics",
      "url": "https://facebook.com/3000799099957887",
      "description": "This is a scientific group where people are allowed to discuss physics specifically quantum physics as its name indicates. Nothing else can be approved by the admin and posting anything related to religion, advertisment, business, politics, etc will not be approved and will be discouraged at all cost. The group members who are trying to post anything outside of the domain of science (physics) will be permanently banned and only English written and spoken post will be allowed.",
      "members": "278K",
      "info": "Private · 278K members · 10+ posts a day",
      "postsFrequency": "10+ posts a day",
      "privacy": "Private"
    },
    {
      "id": "2200011799",
      "name": "Physics",
      "url": "https://facebook.com/2200011799",
      "description": "A group for all physics majors and anyone interested in physics. Feel free to arrange study groups, socialize, stalk each other, or any combination of those fun things.Please remember that this group is meant for people who are really interested in the subject. It is not meant for learners and students. Persons wishing to join the group must provide in their Facebook profile,their place of residence,occupation,age and other relevant particulars.The language of posting is English and if not so,a translated copy be sent.PLEASE DO NOT SEND ANY ADVERTISING MATERIAL. Please ensure that your posts do not hurt religious feelings.",
      "members": "26K",
      "info": "Public · 26K members · 8 posts a week",
      "postsFrequency": "8 posts a week",
      "privacy": "Public"
    },
    {
      "id": "2400894903489739",
      "name": "Physics and Astronomy",
      "url": "https://facebook.com/2400894903489739",
      "description": "This group is created to bring together all the passionate of physics on one platform.",
      "members": "14K",
      "info": "Public · 14K members · 3 posts a week",
      "postsFrequency": "3 posts a week",
      "privacy": "Public"
    },
    {
      "id": "1797462407192575",
      "name": "Quantum Physics News",
      "url": "https://facebook.com/1797462407192575",
      "description": "All the latest Quantum Physics News including news about Colliders such as the LHC, Quantum Cosmology, Quantum Optics, Quantum Field Theory, Bose–Einstein condensate (BEC) and theory from the strange world of Entanglement and SuperPosition of States are posted and discussed in this group.",
      "members": "569K",
      "info": "Public · 569K members · 5 posts a day",
      "postsFrequency": "5 posts a day",
      "privacy": "Public"
    },
    {
      "id": "473920566008054",
      "name": "Quantum Physics",
      "url": "https://facebook.com/473920566008054",
      "description": "The aim of this group is to try to MAKE PHYSICAL SENSE of the empirical evidence from the quantum world. We are looking for a purely rational and causal, matter-in-motion, qualitative physical worldview for Quantum Physics.",
      "members": "69K",
      "info": "Public · 69K members · 4 posts a day",
      "postsFrequency": "4 posts a day",
      "privacy": "Public"
    },
    {
      "id": "616316208710725",
      "name": "Astronomy & Physics",
      "url": "https://facebook.com/616316208710725",
      "description": "Astronomy & Physics",
      "members": "150K",
      "info": "Private · 150K members · 10+ posts a day",
      "postsFrequency": "10+ posts a day",
      "privacy": "Private"
    },
    {
      "id": "371350337872613",
      "name": "Quantum Physics",
      "url": "https://facebook.com/371350337872613",
      "description": "Fact and Science",
      "members": "336K",
      "info": "Private · 336K members · 6 posts a day",
      "postsFrequency": "6 posts a day",
      "privacy": "Private"
    },
    {
      "id": "381395472694750",
      "name": "Wonders of Physics",
      "url": "https://facebook.com/381395472694750",
      "description": "Are you a physics lover?. Maybe you are the chosen one by the universe so hope in and have fun in the knowledge of the forces and cosmic world..!",
      "members": "43K",
      "info": "Public · 43K members · 2 posts a week",
      "postsFrequency": "2 posts a week",
      "privacy": "Public"
    },
    {
      "id": "1790761467631151",
      "name": "Quantum Cosmology and Mathematical Physics",
      "url": "https://facebook.com/1790761467631151",
      "description": "This is a no-nonsense public group where we only allow posts related to physics, quantum physics, cosmology, etc. We don't approve math puzzles and games. If that is your interest, join the Functional Mathematics group. This group is for serious, hardcore parties interested in physics and its mathematics. Spam and off-topic posts and uncivil discourse will be deleted (or not approved)-- and the offending members may be banned without notice. ",
      "members": "131K",
      "info": "Public · 131K members · 10 posts a day",
      "postsFrequency": "10 posts a day",
      "privacy": "Public"
    }
  ],
  "page_info": {
    "start_cursor": null,
    "end_cursor": "AbqZWU9-NBR9VV8ZVI30Gb_pUnScB1bw1cJ5WjN7UKiA1MLmcNqh3Vf_Wt8eZq5sGYsL_f8yvYyuldUhzuYyMMc9gdjLHB0NbaboHpjdbGxgbB5vk_cNl0bIuz9IMnxW85QSBdJqPS85ixQ9BLCoQqRrnvXDDz0W3zoGgQrywBUonY2TsHniSVlCeElNZzuyCJauPIuRUu-UVO7mgwwAC-iPKquMKoGRFodBEOzYhf87qSAlX7IX3CMLm2WDp9lpba0m2N-uyQv-cPV1UcYuEfvVWynAJE16QRc8LuJ-5nJK5-Wu5E_FAj9ys2hYmxf-0pQ-28I1J4llYhTGSbeWAHTtRTULGZ2EqCIS0i0acx2Fax6PCDoK8I3AIJLBazPLlQQ5-jr0m6pHWCIEiEmGgYPLQZ1oixX-XWrUBcQG1o2E9lX7HDfl1nXOh8z30Qxj-Cx0TKGftfHMSU2PxmmtL8HP-5-C2FJnSpclMr-lsFypbxjE_Sc0JhpU6mdI8nOK5KDgNDuPano7AopRqx2Ait2U9pTEWLyZrF4-hrz52zYElZIkLnmN7J1WSbIV6TVMYbJJzYZA5PfA85Ax4I0QctVeqiepkLrzYRUtuY18Kf9pjUCrEqJEStbkTr6rG9Drc6LF2j1DSCU5qr6julMoRw7ZNwxHMwNiGCg906noIzejq6UISO-8YWqPMOMXqX3e6ugzZWXbR2e0IpbJoFIwU9LDQFEzP-urYfI1lOWUK7HMlZ9EKyFSk4f_3VThL0QK5mHY5JA2WWhxcRoXuqykz1wKva4hq49mJT_OoXPt-gx1GEYNEEAaDIJ5g-RREZcRqyda_hUVyktmisUj3c91uqNWoBS87irdMf39pOaPrE7PqLHL5_IMfhe7h_wLzc68TVA4nSOMiReHMuU8ndRv8MjFI123sa8mEDdnx_Bge2BSEUhDoRG7ANaqc00Mtca3XOETHr8GFyh5d2G_hW_tzaR0fQOFyT-ALBe4UOzBO89hwmRIDdkO7iYFNdkYicsFcAkb3Gf0rZ6ZShQJFsiTHatMJLzHv2jxHLEaOrFVqiSo7VKZM7KAhjq3PPie1eJXuYaIFWq2hUhP8-9E23EniDGEc_LS7P6V9M0Qiez5GXfaOZwLOctEpgqYo1fe-7qAk7jcmQtj6wiS1rhOTWlxk6RJ7fyiYIFJXg5LVm9vWTW-fWhKtGdDMowQYxByRTzQyeWrXE1Xw3wPvn_2BQGxMYEKt0m1dErKAfK4lMtdZ8hAegomhWRHgi23HpCI4_11kp_QImIzRJH8UtaQLUIoo6OkMXSs1v77K_PsG6REPZ0A_flHsN88G1gzAloDVkjz6PXTsh65HJnYA3HOyS55BTOezvy5y6Ex-9L8ykqsT2gchMFqyDmoe2AOQqC-usnRkdcTAYBuWGkwa-aF7haHWwCksmNKXpvP5mi4vKH0vYO3fVpkEIbXM_sUcMfGyCMfuIKVOGA5JCbD6VQ6fTGaQe7MtZsJZNr2pPngte41krX0--rwNqGcz2jKUYx7naj7rC2DyCdu2c_ZacSJcMIgbH_GfHu1_IVGlX06jRfUEuj0h0v20TlWcBkHPKQBZRI8E0ZC2FqyjjZatV7xKgQOSdN2VLxrEx_A7S9Pusu60RRy_eRUN5IeKWhWl9ZUtjewzTbhjBdm5ZrYQDNC4QHmegKkn8t80JQOy6eMqb_uIfJuH0RZhVl5WKu2IvYHD6sv3SM",
    "has_previous_page": true,
    "has_next_page": true
  }
}

---

Search Hashtags

Description

This endpoint allows you to search for users on Facebook that match the provided query. It retrieves user profiles that contain the specified search term.

Endpoint

POST api/v1/realtime/social/facebook/v1/search/hashtags

Parameters

Param	Required	Param Type	Description
hashtag	Yes	Body Param	String | The search query string used to find hashtag content across Facebook.
session_id	Yes	Body Param	String | A UUID version 5 used for ranking and pagination. For each request, generate a new UUID, and use the same rank_token for all pagination requests
topic_results_paginating_after_cursor	No	Body Param	String | The cursor to paginate
filter	No	Body Param	Enum: recent_posts | videos | reels_tab

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/search/hashtags' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "hashtag": "olympics2024",
    "session_id": "a34b35f4-8a56-4c38-a00b-77bc40c4b12d"
}'

Example Response

{
    "data": {
        "topic_deep_dive": {
            "title": "#olympics2024",
            "secondary_menu_nt_action": null,
            "header_nt": {...},
            "tabs_nt": {...},
            "results": {
                "page_info": {...},
                "edges": [...]
            }
        }
    }
}

---

Search Pages

Description

This endpoint allows you to search for pages on Facebook that match the provided query. It retrieves pages that contain the specified search term.

Endpoint

POST api/v1/realtime/social/facebook/v1/search/hashtags

Parameters

Param	Required	Param Type	Description
typed_query	Yes	Body Param	String | The search query string used to find matching content across Facebook.
end_cursor	No	Body Param	String | The cursor to paginate
disable_blocks	No	Body Param	Boolean | This parameter allows you to decide the data structure of the response from Facebook, whether to return data in Bloks or JSON form. Bloks is a proprietary format of Facebook, so we suggest setting this parameter to true
recent_post	No	Body Param	Boolean | set true add a recent posts search filter
location_id	No	Body Param	String | Filter by locations.
category_id	No	Body Param	Enum: Local Business or Place - 1006 Company, Organization or Institution - 1013 Brand or Product - 1009 Artist, Band or Public Figure - 1007 Entertainment - 1019 Cause or Community - 2612

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/search/hashtags' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "typed_query": "olympics2024"
}'

Example Response

{
    "data": {
        "search_query": {
            "cache_id": "4152264581553602556",
            "query_function": "keywords_pages(olympics2024)",
            "logging_unit_id": "browse_serp:f532eb99-a6fb-4d95-8a19-b757487232e7",
            "combined_results": {
                "page_info": {
                    "start_cursor": null,
                    "end_cursor": "AboPottPKeNeqHGvdCsLcyQr3m2wGRv1YluMDorG2qlGZA-oiQi6ALdbX5Tz_lRQCvNUfv5z-zG7e_iyRY0iBFpBMssLAh6AXm5kPxQ_y4DPNJ2pkcebQo2E5TJwbuVbaZ8fJxNUKgA7mG8sFx_kBELr-2oF-Xj1oigIbs3i696chrRWn1Ls9SWgkMUYYipbVjIIBG0CqP-9kNZiISmEPbXaiozRzr4kh7cq0z8yh1pf7-7xk4DZtUQXGTeMlXOyeLRgr9fF3PwwBtTP_603Y2rtZn1Rjp5WPRVvUgyITI0feoan6L3VrqY-zzUoHkeMxx-oz6JAbuFg56mgkuQqKdVLD7ecCE8kWzB2F_UqmGFJo1fc6rMjyezhmX4UUPmNOVioPw1uvPP1sOd4Lwcjmi5c5RXaTBJXF6PiX-sN1qGsBhSMe2sdhXoKsbmhyDIDePuEJQnRENoErraLi1y4TeYJ9_v2eBmI5wncc4uGsG4P5mmX8NvUdhm4vZeLCc8kEZfmyDZdsqU09sUCfnSxcQfSDTtxBrLWqHMtRZjNBauA89HO9ZdQ2iqFtUz1DTVkwzjzfll7zyrMtS26tWlOjyWoq9PfumlN3wkh0wS35RQkH6DXV4IerVvXtCXbHCGu_61cQ53UtNV8SWKfbuGAIdI53VQpjzwsMz1ydmUVmsL9bdGeUc2C0ysFNbNuIB6uOXmnrdruwRG3vLVgpUIWgO1krRsEt_l25Bsv3lf82A3wjSS8kwhTpqjoBK9oJu4Pl8KFqRZQ5X6XDqWgnhbEltvYMZMN3az_rOws2aKpLOWvnhsmciQqAdrnqkl06kzGlpbZ_LIa0xWczq5nmBR-D6rxC9OlpbPjXcaK43mwOdLtDEN6IHdsOgll8eKKnC1Tli8-IrWZOfBXu1MsSxzjAHMmgNcxM1dp9ZV675TR6bFGAuk1F2B4UUYr5eN6ZfIBq4hBAvdFVJYa-FK_nnSw4RJVKchdT-dND3YDQXQ0eM5_67vYtCgmoU5Une1kdovoGYndlpQkm-X_0ZfeEfCf2QK8tqe54Wzg0d-JiKCCuBvTKwJbbnvaVjcdkH3irKrHQSZEl_tqCDOsOONpqziuOHVujcpec_vVzg1hRufW5BxIucc7nxL9wKk78D1SxvK6FFHgE22R1mXXO3vOJHrUR-iSDJFfvR5DLfqWFE11cXeY7ucAqHjFPaUoJkqfcbvFgWP7nRpRdt2mSFV4I-svHHi6FA5vIagcyaJSYZGyV1VMpA-dFsJJUsiWTLI-r03AJIO04KO4nRAjI2QHgaUzVE5dG2kP74_rv3GfyLq4cyKA7fJNGZ4VSojJIR8VOSNJieAPnmSDxUGCHUanxKF8QmSWxoSFt4xkXYq8ls-QAC5USxPenaaq-PaTYynp0z4igwUzdtWdhQ91uy1nDz3H8FErpACIORvNfdmT3Lz1v_E4CP3xeUBm-nvIS0HpKdPzj9Vegur_q5sjuU5AoUVcNvykFymdtiiuif6c75QkrPYAce_Xz0ssg2srynQ2GwhaEuSwFKUF5j57Qe8yKJZDWV7oOYI5OYyzzr-7a5STuBfcIJ1NzihAuzan4Lt_RptnDB4lUNVY36vVJlnBBjCoWWPj8y4o8l8FXF_YsYL0IO8VHcqcBb05WX8LYNHbLT6acbwEWktw1mNbxr-lVRlTNDSv4ECzxptFK5TMtmtakipzpbRhMyajjfqezqy7bKy98fXIq7qRgdROqAT90_qqd2mKvOuWwKoK0pjyv-GoG1w_uof39suYSUQhBe0osmfmg82vX8BdThPHCgvzsJzDsXgPEh5ATU197y3cUJaxEVy6Xh8FxLg7KuKIlU1KoZfoLwHxyuziZa1wTgBVOwQ8wNLBw7w_R90e1NoBCY-Z0d3ZUycdhUA_XcVNbdZe_Dgb6CuIM468Tj3o-lKNljoetmkwsjgfmPzoAIaUh4DLpFPs0HL2Awr7air4Y2K6ABDsbwwtBRU8nQ-CcDTBik8xHvXGrwv_7x752rW9gjUNK2G8JVGgcnsGB8kXYkj2re98enw4YU7JB-DfxhojqfMUiIBFNsl9SgEHo2dtINNVpmfTcYQXUrJcG3JnAWSVlqItOR_EznWhskrtQjkuk8AxXjwh_MEMFkmfW7uIx1e2SSLh9h367gx3UchDHNG5ebrW6bPDM0827XWcclAU_mqKgXIsslWKGaRAv3GcvNGvR6WXibaM-5M3koQoMJ_klqSDCBplEIfMk5k3E-ECJ7oEY-QQab78iSejNwuj3bFa-TzhqkDP_eQSHLjtOJhg8FpmV90ww72B3jC4Qm5N8zDWQvjsof0snX7-x4rBdpeHLI9qToiw2QBqlgQ9D8fuGNTJscQH_wJ9GTv7l5wv2K47dBHD6Lfpddxz6YG77ohxP2aO4lEJGWK5fRTGyjG10p4_Qnj0hOHCtYy2LYKIpKEA5opGDsyO6s9TVNAmzb7KesGnHpD4C2_M5p-OpstKhQtGVnz_3YkbP_w_H3v2I7jSVomH7ygDUJTJgykbEwaECNTymf6jdhylyTUft5m6oAl1SIsf1izsZMM7TKLBz3XVRGuTd7pUzUGthNly9oVPpbtiSfQC57XUkRigan9WS2m6w5HQ15hJ3tpQROGfpNBVS4AFgEqETxgpW3qxesHCdt1W8SKuVCmfXzGf9gJXM9uuvc0AJpeMBx_BTXmWT4xlJmKM",
                    "has_previous_page": true,
                    "has_next_page": true
                },
                "has_hcm": false,
                "degradation_level": null,
                "has_iem_triggered": false,
                "is_cache_hit": null,
                "edges": [...],
                "speller_confidence": "NONE",
                "speller_nt_view": null,
                "corrected_query": null
            },
            "filter_type_sets": [...]
        }
    }
}

---

Search Filters (Helpers)

Description

This endpoint allows you to apply filters to your Facebook search results based on the specified criteria. It helps refine search results to match particular filter types.

Endpoint

POST api/v1/realtime/social/facebook/v1/search/filters

Parameters

Param	Required	Param Type	Description
filter_type	Yes	Body Param	String | The type of filter to apply to the search results: city education work
query	Yes	Body Param	String | The value to filter by, such as a city name.

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/facebook/v1/search/filters' \
--header 'Authorization: Basic <credential string>' \ 
--data '{
    "filter_type": "city",
    "query": "tel aviv"
}'

Example Response

{
    "data": {
        "node": {
            "__typename": "GraphSearchQueryFilter",
            "strong_id__": "-7047591408286873279",
            "id": "Z3NxZjp7IjAiOiJicm93c2VfaW5zdGFudF9maWx0ZXIiLCIxIjoia2V5d29yZHNfdXNlcnMoXHUwMDI1MkEpIiwiMyI6IjMwY2ZjMTc5LWIwMzMtNGVjMy1iZDg0LTExMmY5ODdhMjhlMiIsImN1c3RvbV92YWx1ZSI6IkJyb3dzZVVzZXJzQ2l0eUluc3RhbnRGaWx0ZXJDdXN0b21WYWx1ZSJ9",
            "cache_id": "9205233257289478448",
            "filter_values": {
                "edges": [...]
            }
        }
    },
    "extensions": {
        "server_metadata": {
            "request_start_time_ms": 1724679881350,
            "time_at_flush_ms": 1724679881617
        },
        "is_final": true
    }
}