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.

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

Last updated