Nimble HomeLoginCreate an Account

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

Last updated