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.

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.

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.

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.

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.

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.

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.

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

{
    "data": {
        "search_query": {
            "cache_id": "-6852826511010237196",
            "query_function": "keywords_groups(olympics2024)",
            "logging_unit_id": "browse_serp:83c6573e-5e12-45a6-9b88-8ab18eee8072",
            "combined_results": {
                "page_info": {
                    "start_cursor": null,
                    "end_cursor": "AbrHgF7zu7zW4XfFcNJsPjMo2xlmM51dbUoNN1weLJmGX262kPGQrLILTBiiP_1t6MXqnDxtqd7hWOMx8geAhZJU6coR3lA47IRbwHptLE09x3JNMUzRSnkTykGzHLR6lad3J-wBMYAgu4GOxlrQ0Cu4xsp4N3Q9MWiGguGCyjazUFVzHf414s1Y51s6CpVr8KFKo4bof_OygYgfI9LUmy2jr2P9pKp8YHbf3JaLbbKVpCOnO3rMfbW6XaH8HQaxQfSpg4KJ4lVW9TW40Um__-LtUypXU2Z5yBa7VgXsEXZDzl4lpbbnPeblP1M8EjOkx14B-8DlfK5vTF_Tj8irWsh6VA_tBCQWqV74I1IryM-gbVP3PvpGzcc7nfxz9KxCft4Wv-qbvHcdSbC8M-2LbKvlyPE3yaixIWe3aFCHLRyXJI5qnhj0EPObj7rV_DZn-x073LXi-FyrCuWirHJyQCKrM4Fdw1GuEl6fPWXsfjUc0ZQT3S-YSbK4bzflbI5pFiTl_EyWjuuSojs5GbZLDJ1AH7OSazSO2B9_PpxSuQBFRTPn07-YhZkfp-iApY5o_Fjekucw6pz136VDhAIyIgCAf7F5TIFVgZ1ZDctldmOw2hmmJwIV6OOOdO3YHHq3_kMGh4YdWpUhFBy-U00dv_cmYMPvH9FMPGGmr3EyGEj1-uUE34e-xWtD1LERYEt5WARKx8teYVGvE6uzWHxh_AvcPY4BU2sFPZyB-7xJ9CxJ4YW4vPub6lAW-K3-weBvRG65D9XxW8FSXFOakxQ3LdE-wN-EokD3P7Z0cl_u5adJbF9d9_ZBgR-FU4OfSvuBTiwT6HiHcCrPrZvZohfrlBcNHzNKYE3_TDFIssuzIeqOtZjpXsuyJ2egA9T93SA8HL-V5FdD5UtoOZ8Enu6wvI20kTOVG3RG5XXUgzWWr18DB3qLVqP6VyAvmg0d-hZNW7FBJSPQX3dMloJ7v5OYmKJrRvwBn-n0tLt2JuVOPELQfi_VPoUTh_t7r4ViHwpTG-W0PDPwFsr0Bht8DF_gU5Y8ltDmUaSWkeQknBP8hkZQ3axN93C2u4cu2QqMYt7DzoXKc6kNTjlH8XZwm2Ulwv1iRV0u5OdARFHlQY2X9Bu1RSi6uomGp75Lrc7uMtZG5Ah2wwTb9lUw7mTWTC2-3QxaKzHsDOMw9rtyZj2M__FXo5cffsa-qMR8pStwOXv-v8_zBZ519KAJTR5pvcSXE5HOlG52e-HKL3UgbLLHk5f9LnTwmrpZwh8s5xadOYiK7XSZ856Ey0c6AEm2UPZb89GtgPLQ135fImBEqBU0BNAx_F_Iqx6gyYv6jFBT4SdkOtHJW8KurTnvs0ktV-QeqIcufu_eFJqMjQF5cTMy94Kq1hKW-sTG0tRNBa-NpPIx6kk1DZ1yaQ9UMBqzfqApFnJt5ZMrptT1RF9hvotAlCv5JGJ0id-qf4jgY8vsIJnpKpiDDy3pWu1d48AaXccdd4vQ5CcwP4FxCRtuv9r6I1R_UbdpmOqU0RBBIb_XfyXGA8HQztYW6Y1RqTQaMiOc7jVEAk4VkhgTTEizq9AvqcKsyCgahCdVsWqJtS9AnOCJNLcwjYfPjrReIofhHNS1YQfbvmoyTUOmbZgBDmgg3E4NtWh9IGMhs_h19M7YJhEMKbqIjRVobvJbKiN551f5z6StqjZDhEyRoilK5GYe7yxItyCARIpnEVOrdWJ81l-LMBA-vFSVFCA0Eueif3Kn8jHwTcqIllyyplbifrsDKQtVsg",
                    "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 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. (see here)

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.

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
    }
}