# Facebook API Reference Canonical: https://monsterapi.co/docs/api/facebook Read the Facebook API reference. Review parameters, response fields, examples, and current credit prices. OpenAPI specification: [Facebook](https://monsterapi.co/docs/openapi/platforms/facebook.yaml). --- Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request. --- # Facebook: Ad audience and transparency `GET /facebook/api/ads/details` Documentation: https://monsterapi.co/docs/api/facebook#facebook-ad-audience-and-transparency Operation ID: `facebook_ads_details` Returns advertiser, audience and transparency details for an ad. Pass both ad_id and its advertiser page_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `ad_id` (query, required): Ad archive ID from `ads[].id` or `ad.id` in [/ads/library](https://monsterapi.co/docs/api/facebook-ads#facebook-ad-summaries). - `page_id` (query, required): Advertiser page ID for this ad from `ads[].author.id` or `ad.author.id` in [/ads/library](https://monsterapi.co/docs/api/facebook-ads#facebook-ad-summaries). ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/ads/details' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Ad summaries `GET /facebook/api/ads/library` Documentation: https://monsterapi.co/docs/api/facebook#facebook-ad-summaries Operation ID: `facebook_ads_library_root` Returns ad summaries by keyword, advertiser or ad ID. Give exactly one of q, page_id and ad_id. The country and the filters by delivery status, media type, platforms, languages, advertisers and impression dates narrow a search by q or page_id. With ad_id, a non-default value returns bad_request. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, optional): Keyword to search for. Give exactly one of `q`, `page_id` and `ad_id`. Up to 256 characters of visible text and spaces. Tabs, line breaks and invisible characters return `bad_request`. - `page_id` (query, optional): Advertiser page ID. Give exactly one of `q`, `page_id` and `ad_id`. - `ad_id` (query, optional): Ad archive ID. Give exactly one of `q`, `page_id` and `ad_id`. A lookup by `ad_id` takes no `country` and no filter other than the defaults `country=ALL`, `active_status=all` and `media_type=all`. Another value returns `bad_request`. - `country` (query, optional): Country value in uppercase two-letter form, such as `US`, or `ALL` for every country (default). Syntax is checked; Facebook determines whether a validly formed value is accepted. With `ad_id`, a value other than `ALL` returns `bad_request`. - `active_status` (query, optional): Delivery status of the listed ads: `all` (default), `active` or `inactive`. - `media_type` (query, optional): Media of the listed ads: `all` (default), `image`, `meme`, `image_and_meme`, `video`, or `none` for ads without an image or a video. - `publisher_platforms` (query, optional): Platforms of the listed ads, comma-separated, each at most once: `facebook`, `instagram`, `audience_network`, `messenger`, `whatsapp` and `threads`. Without this parameter, the list includes ads on every platform. - `content_languages` (query, optional): Content languages of the listed ads, comma-separated, each at most once, up to 50. Each value is a lowercase language code of two or three letters, such as `en` or `es`. The service checks only the syntax. A code that Facebook does not know, such as `zz`, returns an empty list. Without this parameter, the list includes ads in every language. - `page_ids` (query, optional): Page IDs of the advertisers of the listed ads, comma-separated, each at most once, up to 50: `ads[].author.id` in [/ads/library](https://monsterapi.co/docs/api/facebook-ads#facebook-ad-summaries). Without this parameter, the list includes ads of every advertiser. - `date_min` (query, optional): First day of the impression date range, `YYYY-MM-DD`. The range includes this day, and the list includes ads with impressions on this day or later. If you also give `date_max`, this day must be earlier. The day must exist in the calendar. Facebook can ignore a range outside the last seven years, such as a future range, and return the list without the date filter. - `date_max` (query, optional): Day after the last day of the impression date range, `YYYY-MM-DD`. The range does not include this day, and the list includes ads with impressions before this day. For a range that ends on 16 October 2026, give `2026-10-17`. The day must exist in the calendar. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/ads/library' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Ad summaries with pagination `GET /facebook/api/ads/library/page` Documentation: https://monsterapi.co/docs/api/facebook#facebook-ad-summaries-with-pagination Operation ID: `facebook_ads_library_page` Returns further ad summaries after the cursor, which does not carry the filters. Pass cursor and repeat exactly one of q, page_id and ad_id with the same country and filters. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, optional): Same keyword used for the first page. Give exactly one of `q`, `page_id` and `ad_id`. Up to 256 characters of visible text and spaces. Tabs, line breaks and invisible characters return `bad_request`. - `page_id` (query, optional): Same advertiser page ID used for the first page. Give exactly one of `q`, `page_id` and `ad_id`. - `ad_id` (query, optional): Same ad archive ID used for the first page. Give exactly one of `q`, `page_id` and `ad_id`. - `country` (query, optional): Country value in uppercase two-letter form, such as `US`, or `ALL` for every country (default). Syntax is checked; Facebook determines whether a validly formed value is accepted. - `active_status` (query, optional): Delivery status of the listed ads: `all` (default), `active` or `inactive`. - `media_type` (query, optional): Media of the listed ads: `all` (default), `image`, `meme`, `image_and_meme`, `video`, or `none` for ads without an image or a video. - `publisher_platforms` (query, optional): Platforms of the listed ads, comma-separated, each at most once: `facebook`, `instagram`, `audience_network`, `messenger`, `whatsapp` and `threads`. Without this parameter, the list includes ads on every platform. - `content_languages` (query, optional): Content languages of the listed ads, comma-separated, each at most once, up to 50. Each value is a lowercase language code of two or three letters, such as `en` or `es`. The service checks only the syntax. A code that Facebook does not know, such as `zz`, returns an empty list. Without this parameter, the list includes ads in every language. - `page_ids` (query, optional): Page IDs of the advertisers of the listed ads, comma-separated, each at most once, up to 50: `ads[].author.id` in [/ads/library](https://monsterapi.co/docs/api/facebook-ads#facebook-ad-summaries). Without this parameter, the list includes ads of every advertiser. - `date_min` (query, optional): First day of the impression date range, `YYYY-MM-DD`. The range includes this day, and the list includes ads with impressions on this day or later. If you also give `date_max`, this day must be earlier. The day must exist in the calendar. Facebook can ignore a range outside the last seven years, such as a future range, and return the list without the date filter. - `date_max` (query, optional): Day after the last day of the impression date range, `YYYY-MM-DD`. The range does not include this day, and the list includes ads with impressions before this day. For a range that ends on 16 October 2026, give `2026-10-17`. The day must exist in the calendar. - `cursor` (query, required): `next_cursor` from [/ads/library](https://monsterapi.co/docs/api/facebook-ads#facebook-ad-summaries) or this endpoint. Pass it unchanged with the same subject, country and filters. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/ads/library/page' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Album details and photos `GET /facebook/api/album` Documentation: https://monsterapi.co/docs/api/facebook#facebook-album-details-and-photos Operation ID: `facebook_album_details` Returns album identity, description, counts, contributors, audience and engagement, with the first photos and the posts that added them. Pass set. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `set` (query, required): Album set `a.{album_id}`: the `set` query value of `items[].url` for an item whose `type` is `Album` in [/page/collection/list](https://monsterapi.co/docs/api/facebook-page#facebook-page-albums-and-profiles). The album ID part accepts 1 to 32 digits. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/album' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Album photos with pagination `GET /facebook/api/album/photos` Documentation: https://monsterapi.co/docs/api/facebook#facebook-album-photos-with-pagination Operation ID: `facebook_album_photos` Returns photos and videos of an album, one page per call. Pass set and optionally cursor to continue the list. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `set` (query, required): Album set `a.{album_id}`: the same `set` as in [/album](https://monsterapi.co/docs/api/facebook-post#facebook-album-details-and-photos). The album ID part accepts 1 to 32 digits. - `cursor` (query, optional): `next_cursor` from [/album](https://monsterapi.co/docs/api/facebook-post#facebook-album-details-and-photos) or from this endpoint for the same `set`. Pass it unchanged. Omit it to get the first photos of the album. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/album/photos' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Comment actions `GET /facebook/api/comments/menu` Documentation: https://monsterapi.co/docs/api/facebook#facebook-comment-actions Operation ID: `facebook_comments_menu` Returns available action types, labels and reporting links for a comment. Pass comment_id and feed_location. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `comment_id` (query, required): Opaque comment ID from `comments_page[].id` in [/comments/root](https://monsterapi.co/docs/api/facebook-comments#facebook-post-comments-first-page), [/comments/page](https://monsterapi.co/docs/api/facebook-comments#facebook-post-comments-with-pagination) or [/comments/replies](https://monsterapi.co/docs/api/facebook-comments#facebook-comment-replies). - `feed_location` (query, required): Comment context, such as `PERMALINK` or `POST_PERMALINK_DIALOG`. Use the same value for continuation and replies. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/comments/menu' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Post comments with pagination `GET /facebook/api/comments/page` Documentation: https://monsterapi.co/docs/api/facebook#facebook-post-comments-with-pagination Operation ID: `facebook_comments_page` Returns comments for a post or video. Pass feedback_id and feed_location, with cursor for continuation and optionally intent_token for the comment view. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `feedback_id` (query, required): Feedback ID of a post, video, reel, photo or album, passed unchanged: `post.feedback_id` or `post.shared.feedback_id` in [/post/dialog](https://monsterapi.co/docs/api/facebook-post#facebook-post-details-by-story-id); `posts[].feedback_id` or `posts[].shared.feedback_id` in [/page/timeline](https://monsterapi.co/docs/api/facebook-page#facebook-page-posts-by-profile-id), [/page/render/timeline](https://monsterapi.co/docs/api/facebook-page#facebook-page-post-previews), [/page/render](https://monsterapi.co/docs/api/facebook-page#facebook-page-profile-and-previews), [/user/render](https://monsterapi.co/docs/api/facebook-people#facebook-person-profile-and-previews) or [/group/render](https://monsterapi.co/docs/api/facebook-groups#facebook-group-details-and-posts); `feedback_id` or `shared.feedback_id` in [/group/post/render](https://monsterapi.co/docs/api/facebook-groups#facebook-group-post-details); `video.feedback_id` in [/video/hero](https://monsterapi.co/docs/api/facebook-post#facebook-video-details-by-id); `reel.feedback_id` in [/reel](https://monsterapi.co/docs/api/facebook-post#facebook-reel-details); `reels[].feedback_id` in [/page/render/reels](https://monsterapi.co/docs/api/facebook-page#facebook-page-reel-previews) or [/page/collection/reels](https://monsterapi.co/docs/api/facebook-page#facebook-page-reel-collection); `feedback_id` in [/photo](https://monsterapi.co/docs/api/facebook-post#facebook-photo-details-and-neighbors); `album.feedback_id` in [/album](https://monsterapi.co/docs/api/facebook-post#facebook-album-details-and-photos). - `feed_location` (query, required): Comment context, such as `PERMALINK` or `POST_PERMALINK_DIALOG`. Use the same value for continuation and replies. - `intent_token` (query, optional): Comment view, with the same values as `intent_token` in [/comments/root](https://monsterapi.co/docs/api/facebook-comments#facebook-post-comments-first-page). If you omit it in a call without `cursor`, the view is Newest. With `cursor`, the page keeps the comment view of the answer that gave the cursor. If Facebook does not accept the value, the answer is `bad_request`. - `cursor` (query, optional): `next_cursor` from [/comments/root](https://monsterapi.co/docs/api/facebook-comments#facebook-post-comments-first-page), from this endpoint or from [/video/hero](https://monsterapi.co/docs/api/facebook-post#facebook-video-details-by-id). Pass it unchanged with the same feedback ID. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/comments/page' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Comment replies `GET /facebook/api/comments/replies` Documentation: https://monsterapi.co/docs/api/facebook#facebook-comment-replies Operation ID: `facebook_comments_replies` Returns replies to a comment, including replies to replies. Pass the comment feedback_id, matching expansion_token and feed_location; cursor continues the list. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `feedback_id` (query, required): The chosen comment's `comments_page[].feedback_id` from [/comments/root](https://monsterapi.co/docs/api/facebook-comments#facebook-post-comments-first-page), [/comments/page](https://monsterapi.co/docs/api/facebook-comments#facebook-post-comments-with-pagination) or this endpoint. - `expansion_token` (query, required): The same comment’s `comments_page[].expansion_token` from a fresh response. Keep it paired with that comment’s feedback ID; accepts letters, digits, `-` and `_`, up to 2048 characters. - `feed_location` (query, required): Comment context, such as `PERMALINK` or `POST_PERMALINK_DIALOG`. Use the same value for continuation and replies. - `cursor` (query, optional): `next_cursor` from this endpoint for the same comment. Pass it unchanged with the same feedback ID, expansion token and context. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/comments/replies' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Post comments, first page `GET /facebook/api/comments/root` Documentation: https://monsterapi.co/docs/api/facebook#facebook-post-comments-first-page Operation ID: `facebook_comments_root` Returns the first comments and the total comment count of a post or video. Pass feedback_id and feed_location, and optionally intent_token to select the comment view. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `feedback_id` (query, required): Feedback ID of a post, video, reel, photo or album, passed unchanged: `post.feedback_id` or `post.shared.feedback_id` in [/post/dialog](https://monsterapi.co/docs/api/facebook-post#facebook-post-details-by-story-id); `posts[].feedback_id` or `posts[].shared.feedback_id` in [/page/timeline](https://monsterapi.co/docs/api/facebook-page#facebook-page-posts-by-profile-id), [/page/render/timeline](https://monsterapi.co/docs/api/facebook-page#facebook-page-post-previews), [/page/render](https://monsterapi.co/docs/api/facebook-page#facebook-page-profile-and-previews), [/user/render](https://monsterapi.co/docs/api/facebook-people#facebook-person-profile-and-previews) or [/group/render](https://monsterapi.co/docs/api/facebook-groups#facebook-group-details-and-posts); `feedback_id` or `shared.feedback_id` in [/group/post/render](https://monsterapi.co/docs/api/facebook-groups#facebook-group-post-details); `video.feedback_id` in [/video/hero](https://monsterapi.co/docs/api/facebook-post#facebook-video-details-by-id); `reel.feedback_id` in [/reel](https://monsterapi.co/docs/api/facebook-post#facebook-reel-details); `reels[].feedback_id` in [/page/render/reels](https://monsterapi.co/docs/api/facebook-page#facebook-page-reel-previews) or [/page/collection/reels](https://monsterapi.co/docs/api/facebook-page#facebook-page-reel-collection); `feedback_id` in [/photo](https://monsterapi.co/docs/api/facebook-post#facebook-photo-details-and-neighbors); `album.feedback_id` in [/album](https://monsterapi.co/docs/api/facebook-post#facebook-album-details-and-photos). - `feed_location` (query, required): Comment context, such as `PERMALINK` or `POST_PERMALINK_DIALOG`. Use the same value for continuation and replies. - `intent_token` (query, optional): Comment view. If you omit it, the view is Newest: all comments, newest first (`REVERSE_CHRONOLOGICAL_UNFILTERED_INTENT_V1`). Facebook also offers logged-out visitors two other views. Most relevant (`RANKED_FILTERED_INTENT_V1`) shows comments of friends and the most engaging comments first. Facebook removes some comments from this view. All comments shows all comments, including potential spam. For posts and videos of pages, the value of All comments is `RANKED_UNFILTERED_CHRONOLOGICAL_REPLIES_INTENT_V1`, a ranked view. For group posts, the value of All comments is `CHRONOLOGICAL_UNFILTERED_INTENT_V1`, oldest first. Facebook accepts `CHRONOLOGICAL_UNFILTERED_INTENT_V1` for posts and videos of pages too. Ranked views can repeat or skip comments between pages. Use `id` to find and remove duplicate comments. If Facebook does not accept the value, the answer is `bad_request`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/comments/root' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Event venue and ticket details `GET /facebook/api/events/about` Documentation: https://monsterapi.co/docs/api/facebook#facebook-event-venue-and-ticket-details Operation ID: `facebook_events_about` Returns event description, schedule, venue, creator, attendance and ticket link when available. Pass event_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `event_id` (query, required): Numeric event ID. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/events/about' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Event identity and schedule `GET /facebook/api/events/header` Documentation: https://monsterapi.co/docs/api/facebook#facebook-event-identity-and-schedule Operation ID: `facebook_events_header` Returns event identity, start time, location, cover and attendance summary when available. Pass event_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `event_id` (query, required): Numeric event ID. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/events/header' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Event link preview `GET /facebook/api/events/mobile` Documentation: https://monsterapi.co/docs/api/facebook#facebook-event-link-preview Operation ID: `facebook_events_mobile` Returns event link-preview metadata, including title, description and image when available. Pass event_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `event_id` (query, required): Numeric event ID. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/events/mobile' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Place events with pagination `GET /facebook/api/events/place/page` Documentation: https://monsterapi.co/docs/api/facebook#facebook-place-events-with-pagination Operation ID: `facebook_events_place_page` Returns events for a place with names, dates, locations and cover images. Pass location_id and optionally cursor to continue. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `location_id` (query, required): Numeric city page ID. An ID that is not a city page, such as a page profile ID, returns `upstream_shape`. A city page without events returns an empty `events` list. - `cursor` (query, optional): `next_cursor` from [/events/place/render](https://monsterapi.co/docs/api/facebook-events#facebook-place-details-and-event-previews) or this endpoint. Pass it unchanged with the same `location_id`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/events/place/page' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Place details and event previews `GET /facebook/api/events/place/render` Documentation: https://monsterapi.co/docs/api/facebook#facebook-place-details-and-event-previews Operation ID: `facebook_events_place_render` Returns place information, event previews, categories and continuation. Pass location_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `location_id` (query, required): Numeric city page ID. Facebook answers an ID that is not a city page, such as a page profile ID, with a server error, and the request returns `upstream_error`. In every measurement, a repeated request with such an ID got the same refusal. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/events/place/render' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Group posts by group ID `GET /facebook/api/group/feed` Documentation: https://monsterapi.co/docs/api/facebook#facebook-group-posts-by-group-id Operation ID: `facebook_group_feed` Returns group posts, attachments and engagement, up to three posts per call. Pass the numeric group id and optionally cursor to continue; a private group returns an empty list. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (query, required): Numeric group ID: `id` in [/group/render](https://monsterapi.co/docs/api/facebook-groups#facebook-group-details-and-posts) or [/group/render/about](https://monsterapi.co/docs/api/facebook-groups#facebook-group-history-rules-and-activity). - `cursor` (query, optional): `next_cursor` from this endpoint or [/group/render](https://monsterapi.co/docs/api/facebook-groups#facebook-group-details-and-posts) for the same group. Pass it unchanged with the same `id`; omit it for the first page. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/group/feed' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Group link preview `GET /facebook/api/group/mobile` Documentation: https://monsterapi.co/docs/api/facebook#facebook-group-link-preview Operation ID: `facebook_group_mobile` Returns group link-preview metadata, including title, description and image when available. Pass the group id or name. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (query, required): Group ID or username. The group ID is `route.group_id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for a group path. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/group/mobile' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Group post details `GET /facebook/api/group/post/render` Documentation: https://monsterapi.co/docs/api/facebook#facebook-group-post-details Operation ID: `facebook_group_post_render` Returns a group post with author, text, attachments, engagement and comment previews. Pass both group id and post_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (query, required): Group ID or username. The group ID is `route.group_id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for a group post path. - `post_id` (query, required): Numeric post ID within this group: `route.post_id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for the group post path. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/group/post/render' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Group details and posts `GET /facebook/api/group/render` Documentation: https://monsterapi.co/docs/api/facebook#facebook-group-details-and-posts Operation ID: `facebook_group_render` Returns group identity, privacy, member summaries, description, available posts and a cursor for later posts. Pass the group id or name. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (query, required): Group ID or username. The group ID is `route.group_id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for a group path. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/group/render' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Group history, rules and activity `GET /facebook/api/group/render/about` Documentation: https://monsterapi.co/docs/api/facebook#facebook-group-history-rules-and-activity Operation ID: `facebook_group_render_about` Returns group identity, description, privacy, visibility, creation time, history, rules and activity counts. Pass the group id or name. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (query, required): Group ID or username, such as `pythondevelopers`. The numeric group ID is `id` in [/group/render](https://monsterapi.co/docs/api/facebook-groups#facebook-group-details-and-posts). ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/group/render/about' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Marketplace nearby listings `GET /facebook/api/marketplace/browse` Documentation: https://monsterapi.co/docs/api/facebook#facebook-marketplace-nearby-listings Operation ID: `facebook_marketplace_browse` Returns listing summaries around a location. Supply lat and lng together or omit both to let Facebook choose the area; radius and cursor are optional. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `lat` (query, optional): Latitude of the area center in degrees, from -90 to 90. Supply with `lng`. Without `lat` and `lng`, Facebook chooses the area itself, and the area can differ between requests. `coordinates.latitude` in [/marketplace/location/render](https://monsterapi.co/docs/api/facebook-marketplace#facebook-marketplace-location-details) gives the latitude of a Marketplace location. - `lng` (query, optional): Longitude of the area center in degrees, from -180 to 180. Supply with `lat`. `coordinates.longitude` in [/marketplace/location/render](https://monsterapi.co/docs/api/facebook-marketplace#facebook-marketplace-location-details) gives the longitude of a Marketplace location. - `radius` (query, optional): Radius of the area around its center, in kilometers, 0 or more. Without `radius`, Facebook's default radius applies. Facebook can return listings outside the radius. Around San Francisco, with `radius=1`, at least 6 of 26 listings on the first page were 5 to 49 km from the center. All 6 listings on the next page were 5 to 63 km from the center. With `radius=20`, at least 3 of 26 listings on the first page were 27 to 49 km from the center. The distances use the coordinates of each listing or of its Marketplace location. For a strict area, compare the coordinates of each listing with the center. [GET /marketplace/item](https://monsterapi.co/docs/api/facebook-marketplace#facebook-marketplace-listing-details) gives the coordinates of one listing. [GET /marketplace/location/render](https://monsterapi.co/docs/api/facebook-marketplace#facebook-marketplace-location-details) gives the coordinates of the Marketplace location in `listings[].location_id`. A listing can be several kilometers from the coordinates of its location. - `cursor` (query, optional): `next_cursor` from this endpoint for the same `lat`, `lng` and `radius`. Pass it unchanged. An absent `next_cursor` means that no continuation is available. A listing can appear on more than one page. In three walks of 3 to 4 pages around San Francisco and London, one page repeated a listing. The second page of a walk around London repeated 1 of its 6 listings from the first page. To count each listing once, deduplicate by `listings[].id`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/marketplace/browse' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Marketplace listing details `GET /facebook/api/marketplace/item` Documentation: https://monsterapi.co/docs/api/facebook#facebook-marketplace-listing-details Operation ID: `facebook_marketplace_item` Returns listing identity, title, description, price, seller, location and primary photo when available. Pass id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (query, required): Numeric listing ID. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/marketplace/item' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Marketplace listing media `GET /facebook/api/marketplace/item/media` Documentation: https://monsterapi.co/docs/api/facebook#facebook-marketplace-listing-media Operation ID: `facebook_marketplace_item_media` Returns photos and videos for a listing. Pass id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (query, required): Numeric listing ID. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/marketplace/item/media' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Marketplace location details `GET /facebook/api/marketplace/location/render` Documentation: https://monsterapi.co/docs/api/facebook#facebook-marketplace-location-details Operation ID: `facebook_marketplace_location_render` Returns location identity, name, city and coordinates. Pass id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (query, required): Numeric Marketplace location ID. `listings[].location_id` in [GET /marketplace/search](https://monsterapi.co/docs/api/facebook-marketplace#facebook-marketplace-listing-search) and [GET /marketplace/browse](https://monsterapi.co/docs/api/facebook-marketplace#facebook-marketplace-nearby-listings) gives the ID of the location named in `listings[].location`. An ID that names no Marketplace location returns `not_found`. On 2026-10-20, an ID that does not exist, a page profile ID and a group ID each returned `not_found`. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/marketplace/location/render' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Marketplace listing search `GET /facebook/api/marketplace/search` Documentation: https://monsterapi.co/docs/api/facebook#facebook-marketplace-listing-search Operation ID: `facebook_marketplace_search` Returns listing summaries matching a keyword or category and optional filters. Give exactly one of q and category; lat and lng together set the area center; cursor continues the results. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, optional): Listing search term. Give exactly one of `q` and `category`. Up to 256 characters of visible text and spaces. Tabs, line breaks and invisible characters return `bad_request`. - `category` (query, optional): Listing category: the last path segment of a Facebook Marketplace category address, such as `vehicles` in `https://www.facebook.com/marketplace/category/vehicles/`. Give exactly one of `q` and `category`. The Facebook Marketplace navigation lists categories for a logged-out visitor, and this list can change. On 2026-10-20, it listed `apparel`, `classifieds`, `electronics`, `entertainment`, `family`, `free`, `garden`, `hobbies`, `home`, `home-improvements`, `instruments`, `office-supplies`, `pets`, `propertyforsale`, `propertyrentals`, `sports`, `toys` and `vehicles`. A listed category that Facebook shows a logged-out visitor as unavailable returns `requires_auth`. On 2026-10-20, this was `propertyforsale`. The category of each listing is `marketplace_listing_category_id` in `data.marketplace_search.feed_units.nodes[].listing`. The service also accepts a value that the navigation does not list. On 2026-10-20, `bicycles` returned bicycles and `furniture` returned furniture, and all these listings carried the category ID of `electronics`. An unknown value returned no listings. `propertyrentals` returns rentals together with other listings. Of 24 listings in each search, Facebook put 13 to 19 around San Francisco and 14 to 16 around London in its rental category. The other listings were goods such as sofas, services such as handyman work, and rentals that Facebook put in other categories. - `lat` (query, optional): Latitude of the area center in degrees, from -90 to 90. Supply with `lng`. Without `lat` and `lng`, Facebook chooses the area itself, and the area can differ between requests. `coordinates.latitude` in [/marketplace/location/render](https://monsterapi.co/docs/api/facebook-marketplace#facebook-marketplace-location-details) gives the latitude of a Marketplace location. - `lng` (query, optional): Longitude of the area center in degrees, from -180 to 180. Supply with `lat`. `coordinates.longitude` in [/marketplace/location/render](https://monsterapi.co/docs/api/facebook-marketplace#facebook-marketplace-location-details) gives the longitude of a Marketplace location. - `min_price` (query, optional): Lowest price as Facebook writes `minPrice` in its Marketplace address: a decimal number without a sign that is a whole number of hundredths, such as `50`, `49.99` or `1.5e+06`, from 0 to 2147483647. The amount is in the currency Facebook uses for the search, such as US dollars for a search in the United States, and is not converted. - `max_price` (query, optional): Highest price, written and read like `min_price` and not below it. From 0 to 2147483647. - `radius` (query, optional): Radius of the area around its center, in kilometers, 0 or more. Without `radius`, Facebook's default radius applies. Facebook can return listings outside the radius. With `q`, a search with `radius=1` returned a listing 135 km from the center. With `category`, the result depends on the category. Around San Francisco and London, `toys` stayed near the radius. With `radius=1`, all `toys` listings were in the city of the center. With `radius=20` and `radius=100`, the farthest measured Marketplace location of a `toys` listing was 19 and 91 km from San Francisco. Around London, the farthest measured location was 22 and 91 km from the center. With `radius=1` around San Francisco, all `home` and `electronics` listings were in San Francisco too. `vehicles`, `classifieds`, `office-supplies` and `pets` did not stay near the radius. With `radius=1`, `vehicles` returned a listing 62 km from each center. In two measurements around San Francisco, 11 and 12 of the 13 `vehicles` listings with `radius=1` were also in the results with `radius=100`. With `radius=1`, `classifieds` returned a listing 158 km from San Francisco and a listing 166 km from London. With `radius=1`, `office-supplies` and `pets` returned listings 140 km and 87 km from San Francisco. The distances use the coordinates of each listing or of its Marketplace location. A listing can be several kilometers from the coordinates of its location. For a strict area, compare the coordinates of each listing with the center. [GET /marketplace/location/render](https://monsterapi.co/docs/api/facebook-marketplace#facebook-marketplace-location-details) gives the coordinates of the Marketplace location in `listings[].location_id`, and [GET /marketplace/item](https://monsterapi.co/docs/api/facebook-marketplace#facebook-marketplace-listing-details) gives the coordinates of one listing. - `days` (query, optional): Listing age limit in whole days from 0 to 365, written as Facebook writes `daysSinceListed` in its Marketplace address. With `q`, Facebook applies this filter by its own day boundary, which is not midnight UTC. Facebook can also add older listings to the results: a search with `days=1` returned listings 13 days old. With `category`, the result depends on the category. With `days=1` around San Francisco, `vehicles` returned 15 listings 0.1 to 5.2 days old, and `toys` returned listings up to 210 days old. For a strict age window, filter by `listings[].created_time` or `listings[].created_at` of each listing. - `condition` (query, optional): Item condition, written as Facebook writes `itemCondition` in its Marketplace address, such as `new` or `used_like_new`. The condition of a listing is the `value` of the `Condition` entry of `data.marketplace_product_details_page.target.attribute_data` in [/marketplace/item](https://monsterapi.co/docs/api/facebook-marketplace#facebook-marketplace-listing-details). - `cursor` (query, optional): `next_cursor` from this endpoint for the same `q` or `category` and the same filters. Pass it unchanged. An absent `next_cursor` means that no continuation is available. A listing can appear on more than one page. In six walks of three pages by category around San Francisco and London, 9 of the 402 returned listings repeated a listing of an earlier page. To count each listing once, deduplicate by `listings[].id`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/marketplace/search' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Post embedding details `GET /facebook/api/oembed/post` Documentation: https://monsterapi.co/docs/api/facebook#facebook-post-embedding-details Operation ID: `facebook_oembed_post` Returns embedding code and display details for a post or photo. Pass its url; an empty embedding record can still be a valid response. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): Public Facebook post or photo URL. The URL uses `http` or `https`, names the host `www.facebook.com`, `facebook.com`, `m.facebook.com` or `fb.watch`, and carries no user name or password. Percent-encode spaces and non-ASCII characters. ## Responses - 200: Details for the requested object. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/oembed/post' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Video embedding details `GET /facebook/api/oembed/video` Documentation: https://monsterapi.co/docs/api/facebook#facebook-video-embedding-details Operation ID: `facebook_oembed_video` Returns embedding code and display details for a video. Pass its url; supported unavailable video addresses return not_found. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): Public Facebook video URL. The URL uses `http` or `https`, names the host `www.facebook.com`, `facebook.com`, `m.facebook.com` or `fb.watch`, and carries no user name or password. Percent-encode spaces and non-ASCII characters. ## Responses - 200: Details for the requested object. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/oembed/video' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page albums and profiles `GET /facebook/api/page/collection/list` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-albums-and-profiles Operation ID: `facebook_page_collection_list` Returns albums or profiles from a page collection. Pass collection_id and use cursor for continuation. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `collection_id` (query, required): Album or profile collection ID from `sections[].collections[].id` in [/page/render](https://monsterapi.co/docs/api/facebook-page#facebook-page-profile-and-previews) or `section.collections[].id` in [/page/section](https://monsterapi.co/docs/api/facebook-page#facebook-page-section-contents). - `cursor` (query, optional): `next_cursor` from this endpoint for the same subject and filters. Pass it unchanged; absent `next_cursor` means no continuation is available. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/collection/list' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page photo collection `GET /facebook/api/page/collection/photos` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-photo-collection Operation ID: `facebook_page_collection_photos` Returns photos from a page collection. Pass collection_id and use cursor for continuation. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `collection_id` (query, required): Photo collection ID from `sections[].collections[].id` in [/page/render](https://monsterapi.co/docs/api/facebook-page#facebook-page-profile-and-previews) or `section.collections[].id` in [/page/section](https://monsterapi.co/docs/api/facebook-page#facebook-page-section-contents). - `cursor` (query, optional): `next_cursor` from this endpoint for the same subject and filters. Pass it unchanged; absent `next_cursor` means no continuation is available. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/collection/photos' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page reel collection `GET /facebook/api/page/collection/reels` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-reel-collection Operation ID: `facebook_page_collection_reels` Returns reels from a page collection. Pass collection_id and use cursor for continuation. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `collection_id` (query, required): Reel collection ID from `collection_id` in [/page/render/reels](https://monsterapi.co/docs/api/facebook-page#facebook-page-reel-previews) or `section.collections[].id` in [/page/section](https://monsterapi.co/docs/api/facebook-page#facebook-page-section-contents) for a reels section. - `cursor` (query, optional): `next_cursor` from this endpoint for the same subject and filters. Pass it unchanged; absent `next_cursor` means no continuation is available. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/collection/reels' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page identity by profile ID `GET /facebook/api/page/header` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-identity-by-profile-id Operation ID: `facebook_page_header` Returns page identity, avatar, cover and follower summaries. Pass user_id; missing profiles return not_found. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `user_id` (query, required): Page profile ID from `route.id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for a page path. This differs from `classic_id`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/header' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page profile picture `GET /facebook/api/page/picture` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-profile-picture Operation ID: `facebook_page_picture` Returns a page picture URL and its dimensions. Pass id and optionally type; a person named by numeric ID receives a placeholder picture. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (query, required): Page username or classic page ID from `classic_id` in [/page/render](https://monsterapi.co/docs/api/facebook-page#facebook-page-profile-and-previews). A profile ID gives a placeholder; a person's username returns `not_found`. - `type` (query, optional): Picture size: `small`, `normal`, `album`, `large` or `square`; default `large`. Actual dimensions are given by `width` and `height`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/picture' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page profile and previews `GET /facebook/api/page/render` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-profile-and-previews Operation ID: `facebook_page_render` Returns page identity, profile details, section links and photo and post previews. Pass exactly one of name or id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (query, optional): Page username, such as `NASA`. Give exactly one of `name` and `id`. - `id` (query, optional): Numeric page profile ID. Give exactly one of `name` and `id`. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/render' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page contact details `GET /facebook/api/page/render/contact` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-contact-details Operation ID: `facebook_page_render_contact` Returns page category, contact details, address, opening status and coordinates when available. Pass its name. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (query, required): Page username, such as `NASA`. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/render/contact' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page reel previews `GET /facebook/api/page/render/reels` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-reel-previews Operation ID: `facebook_page_render_reels` Returns reel previews, engagement, collection_id and continuation for a page. Pass its name; a page not listing its reels publicly returns not_found, and its reels stay in [/page/videos](https://monsterapi.co/docs/api/facebook-page#facebook-page-videos-first-page) and [/reel](https://monsterapi.co/docs/api/facebook-post#facebook-reel-details). ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (query, required): Page username, such as `NASA`. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/render/reels' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page post previews `GET /facebook/api/page/render/timeline` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-post-previews Operation ID: `facebook_page_render_timeline` Returns post previews, attachments, engagement and continuation for a page. Pass its name. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (query, required): Page username, such as `NASA`. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/render/timeline' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page ownership and ads `GET /facebook/api/page/render/transparency` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-ownership-and-ads Operation ID: `facebook_page_render_transparency` Returns page creation date, ownership and advertising status. Pass its name. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (query, required): Page username, such as `NASA`. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/render/transparency' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page reviews, first page `GET /facebook/api/page/reviews` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-reviews-first-page Operation ID: `facebook_page_reviews` Returns the first reviews of a page with their text, author, publication time and engagement. Pass user_id, and continue the list with [/page/reviews/page](https://monsterapi.co/docs/api/facebook-page#facebook-page-reviews-with-pagination). ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `user_id` (query, required): Page profile ID: `route.id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for a page path, such as `/Logitech/reviews/`, or `page.id` in [/page/header](https://monsterapi.co/docs/api/facebook-page#facebook-page-identity-by-profile-id). This differs from `classic_id`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/reviews' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page reviews with pagination `GET /facebook/api/page/reviews/page` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-reviews-with-pagination Operation ID: `facebook_page_reviews_page` Returns further reviews of a page with their text, author, publication time and engagement. Pass user_id and cursor. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `user_id` (query, required): Page profile ID: `route.id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for a page path, such as `/Logitech/reviews/`, or `page.id` in [/page/header](https://monsterapi.co/docs/api/facebook-page#facebook-page-identity-by-profile-id). This differs from `classic_id`. - `cursor` (query, required): `next_cursor` from [/page/reviews](https://monsterapi.co/docs/api/facebook-page#facebook-page-reviews-first-page) or this endpoint for the same page. Pass it unchanged with the same `user_id`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/reviews/page' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page rating `GET /facebook/api/page/reviews/rating` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-rating Operation ID: `facebook_page_reviews_rating` Returns the rating of a page from 0 to 5 and the number of people it is based on. Pass user_id; a page without a rating returns null values. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `user_id` (query, required): Page profile ID: `route.id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for a page path, such as `/Meta/reviews/`, or `page.id` in [/page/header](https://monsterapi.co/docs/api/facebook-page#facebook-page-identity-by-profile-id). This differs from `classic_id`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/reviews/rating' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page section contents `GET /facebook/api/page/section` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-section-contents Operation ID: `facebook_page_section` Returns section information and its collection items. Pass user_id, section_token and, when /route names one, collection_token; a section Facebook does not show logged-out visitors, such as NASA's reels, returns not_found. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `user_id` (query, required): Page profile ID from `route.id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for a page path. This differs from `classic_id`. - `section_token` (query, required): Section token: `route.section_token` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for the section path, such as `/NASA/photos_by` or `/zuck/reels`. - `collection_token` (query, optional): Collection token: `route.collection_token` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for the same path. Omit it when that value is null, as for `/NASA/photos` or `/zuck/reels`; the section then answers its default collection. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/section' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page posts by profile ID `GET /facebook/api/page/timeline` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-posts-by-profile-id Operation ID: `facebook_page_timeline` Returns page posts, attachments and engagement, usually up to three posts per call. Pass user_id and optionally cursor, since and until to continue or limit the publication period. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `user_id` (query, required): Page profile ID from `route.id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for a page path. This differs from `classic_id`. - `cursor` (query, optional): `next_cursor` from this endpoint or [/page/render/timeline](https://monsterapi.co/docs/api/facebook-page#facebook-page-post-previews) for the same page. Pass unchanged with its profile ID in `user_id` and the same filters. - `since` (query, optional): Inclusive lower publication time, in Unix seconds, not later than `until`. - `until` (query, optional): Inclusive upper publication time, in Unix seconds. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/timeline' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page owner, history and managers `GET /facebook/api/page/transparency` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-owner-history-and-managers Operation ID: `facebook_page_transparency` Returns the organization confirmed as responsible for a page, its name history, the countries of its managers and its ad status. Pass the classic page ID in page_id, because a profile ID returns not_found. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `page_id` (query, required): Classic page ID: `page_id` in [/page/render/transparency](https://monsterapi.co/docs/api/facebook-page#facebook-page-ownership-and-ads), `page.classic_id` in [/page/header](https://monsterapi.co/docs/api/facebook-page#facebook-page-identity-by-profile-id), or `route.classic_id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for a page path such as `/NASA/videos`. A profile ID, such as `route.id`, returns `not_found`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/transparency' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page videos, first page `GET /facebook/api/page/videos` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-videos-first-page Operation ID: `facebook_page_videos` Returns the initial videos for a page, including titles, duration and engagement. Pass page_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `page_id` (query, required): Classic page ID: `route.classic_id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for the page's videos path, such as `/NASA/videos`, `page.classic_id` in [/page/header](https://monsterapi.co/docs/api/facebook-page#facebook-page-identity-by-profile-id), or `classic_id` in [/page/render](https://monsterapi.co/docs/api/facebook-page#facebook-page-profile-and-previews) or [/plugin/page](https://monsterapi.co/docs/api/facebook-plugin#facebook-page-follower-details-by-url). A profile ID, such as `route.id`, returns `not_found`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/videos' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page videos with pagination `GET /facebook/api/page/videos/page` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-videos-with-pagination Operation ID: `facebook_page_videos_page` Returns videos for a page, including titles, duration and engagement. Pass page_id and optionally cursor to continue the list. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `page_id` (query, required): Classic page ID: `route.classic_id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for the page's videos path, such as `/NASA/videos`, `page.classic_id` in [/page/header](https://monsterapi.co/docs/api/facebook-page#facebook-page-identity-by-profile-id), or `classic_id` in [/page/render](https://monsterapi.co/docs/api/facebook-page#facebook-page-profile-and-previews) or [/plugin/page](https://monsterapi.co/docs/api/facebook-plugin#facebook-page-follower-details-by-url). A profile ID, such as `route.id`, returns `not_found`. - `cursor` (query, optional): `next_cursor` from [/page/videos](https://monsterapi.co/docs/api/facebook-page#facebook-page-videos-first-page) or this endpoint. Pass it unchanged with the same `page_id`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/page/videos/page' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Photo details and neighbors `GET /facebook/api/photo` Documentation: https://monsterapi.co/docs/api/facebook#facebook-photo-details-and-neighbors Operation ID: `facebook_photo_details` Returns a photo, owner, containing post text, engagement and neighboring photo IDs. Pass fbid and optionally set to choose the album, the uploads or the post's photos. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `fbid` (query, required): Numeric photo ID from a photo preview, attachment, collection, `photos[].id` in [/album](https://monsterapi.co/docs/api/facebook-post#facebook-album-details-and-photos) or [/album/photos](https://monsterapi.co/docs/api/facebook-post#facebook-album-photos-with-pagination), `prev_id` or `next_id`. Accepts 1 to 32 decimal digits. A page profile ID, such as `route.id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for a page path, returns `not_found`. The ID of a video and the ID of an occurrence of a recurring event also return `not_found`. - `set` (query, optional): Album `a.{album_id}` or profile uploads `pb.{owner_id}.-{number}` from the photo URL, or the photos of a post `pcb.{post_id}`: `data.node_v2.attachments[].styles.attachment.mediaset_token` of an album post in [/post/dialog](https://monsterapi.co/docs/api/facebook-post#facebook-post-details-by-story-id). Each numeric part accepts 1 to 32 digits; omitted uses the photo’s album. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/photo' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Page follower details by URL `GET /facebook/api/plugin/page` Documentation: https://monsterapi.co/docs/api/facebook#facebook-page-follower-details-by-url Operation ID: `facebook_plugin_page` Returns page identity, follower count, verification status and avatar when available. Pass the page url. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): Public Facebook page URL. The URL uses `http` or `https`, names the host `www.facebook.com`, `facebook.com`, `m.facebook.com` or `fb.watch`, and carries no user name or password. Percent-encode spaces and non-ASCII characters. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/plugin/page' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Post details by URL `GET /facebook/api/plugin/post` Documentation: https://monsterapi.co/docs/api/facebook#facebook-post-details-by-url Operation ID: `facebook_plugin_post` Returns post text, author, publication time, image and engagement. Pass the post url. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): Public Facebook post URL. The URL uses `http` or `https`, names the host `www.facebook.com`, `facebook.com`, `m.facebook.com` or `fb.watch`, and carries no user name or password. Percent-encode spaces and non-ASCII characters. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/plugin/post' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Video playback details `GET /facebook/api/plugin/video` Documentation: https://monsterapi.co/docs/api/facebook#facebook-video-playback-details Operation ID: `facebook_plugin_video` Returns video playback files, dimensions, owner and availability information. Pass the video url. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): Public Facebook video URL. The URL uses `http` or `https`, names the host `www.facebook.com`, `facebook.com`, `m.facebook.com` or `fb.watch`, and carries no user name or password. Percent-encode spaces and non-ASCII characters. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/plugin/video' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Post details by story ID `GET /facebook/api/post/dialog` Documentation: https://monsterapi.co/docs/api/facebook#facebook-post-details-by-story-id Operation ID: `facebook_post_dialog` Returns post text, author, attachments, engagement and comment previews. Pass story_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `story_id` (query, required): Story ID from `route.story_id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for the post path. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/post/dialog' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Profile About section `GET /facebook/api/profile/about` Documentation: https://monsterapi.co/docs/api/facebook#facebook-profile-about-section Operation ID: `facebook_profile_about` Returns the headings and fields of one About section of a page or a person, such as details, privacy and legal information, or work and education. Pass name and section. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (query, required): Username of the page or person, such as `NASA` or `zuck`. - `section` (query, required): About section key, such as `about_details`. In [/page/section](https://monsterapi.co/docs/api/facebook-page#facebook-page-section-contents) for an About path of the profile, such as `/NASA/about_details`, each `section.collections[].url` ends with the key of one section that the profile shows. `sections[].collections[].key` of the section whose `key` is `about` in [/page/render](https://monsterapi.co/docs/api/facebook-page#facebook-page-profile-and-previews) or [/user/render](https://monsterapi.co/docs/api/facebook-people#facebook-person-profile-and-previews) gives the keys in one call. This list can include sections that the profile does not show, such as `about_work_and_education` of NASA. Such a section returns `not_found`. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/profile/about' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Reel details `GET /facebook/api/reel` Documentation: https://monsterapi.co/docs/api/facebook#facebook-reel-details Operation ID: `facebook_reel_root` Returns reel text, owner, playback details, reactions, comments and shares, without play and view counts. Pass video_id, and get exact play and view counts from [/video/hero](https://monsterapi.co/docs/api/facebook-post#facebook-video-details-by-id) with the same video_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `video_id` (query, required): Numeric video ID. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/reel' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Path identifiers `GET /facebook/api/route` Documentation: https://monsterapi.co/docs/api/facebook#facebook-path-identifiers Operation ID: `facebook_route_definition` Returns profile, page, group, post and video topic identifiers, section tokens and related links for the Facebook path in route, such as /NASA or /groups/123/posts/456. Some paths that Facebook shows as unavailable, such as /NASA/reviews/, return not_found. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `route` (query, required): Facebook path, such as `/NASA` or `/groups/1234/posts/5678`. A path without its leading `/`, such as the `redirect_url` `SF`, is read from the root as `/SF`. The root path and paths with literal or encoded `.` or `..` segments are invalid, and so is a path that starts with `//` or names a scheme, such as `https:`. Up to 512 characters with the leading `/`, all printable ASCII except `\`, `#`, `<`, `>`, `"` and `'`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/route' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Event search `GET /facebook/api/search/events` Documentation: https://monsterapi.co/docs/api/facebook#facebook-event-search Operation ID: `facebook_search_events` Returns matching event names, dates, places and covers. Pass q and optionally cursor to continue the results. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, required): Event search term. Up to 256 characters of visible text and spaces. Tabs, line breaks and invisible characters return `bad_request`. - `cursor` (query, optional): `next_cursor` from this endpoint for the same subject and filters. Pass it unchanged; absent `next_cursor` means no continuation is available. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/search/events' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Profile search `GET /facebook/api/search/people` Documentation: https://monsterapi.co/docs/api/facebook#facebook-profile-search Operation ID: `facebook_search_people` Returns matching profile names, identifiers, pictures and links. Pass a name in q. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, required): Profile name to search for. Up to 256 characters of visible text and spaces. Tabs, line breaks and invisible characters return `bad_request`. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/search/people' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Video search with pagination `GET /facebook/api/search/videos` Documentation: https://monsterapi.co/docs/api/facebook#facebook-video-search-with-pagination Operation ID: `facebook_search_videos` Returns video summaries matching a search term, including titles and durations. Pass q and optionally cursor, and get more details from [/video/hero](https://monsterapi.co/docs/api/facebook-post#facebook-video-details-by-id) with `videos[].id` as `video_id`. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, required): Video search term. Up to 256 characters of visible text and spaces. Tabs, line breaks and invisible characters return `bad_request`. - `cursor` (query, optional): `next_cursor` from this endpoint or from [/search/videos/render](https://monsterapi.co/docs/api/facebook-search#facebook-video-search-previews) for the same `q`. Pass it unchanged. An absent `next_cursor` means that no continuation is available. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/search/videos' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Video search previews `GET /facebook/api/search/videos/render` Documentation: https://monsterapi.co/docs/api/facebook#facebook-video-search-previews Operation ID: `facebook_search_videos_render` Returns video previews matching a search term, including available duration and engagement, but compact previews have no title. Pass q, and use [/search/videos](https://monsterapi.co/docs/api/facebook-search#facebook-video-search-with-pagination) for compact previews with titles. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, required): Video search term. Up to 256 characters of visible text and spaces. Tabs, line breaks and invisible characters return `bad_request`. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/search/videos/render' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Person profile and previews `GET /facebook/api/user/render` Documentation: https://monsterapi.co/docs/api/facebook#facebook-person-profile-and-previews Operation ID: `facebook_user_render` Returns a person profile, section links, photo and post previews and available engagement summaries. Pass its name. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (query, required): Profile username. ## Responses - 200: Requested information; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/user/render' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Video transcript and links `GET /facebook/api/video/aux` Documentation: https://monsterapi.co/docs/api/facebook#facebook-video-transcript-and-links Operation ID: `facebook_video_aux` Returns a video transcript and navigation links when available. Pass video_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `video_id` (query, required): Numeric video ID. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/video/aux' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Video details by ID `GET /facebook/api/video/hero` Documentation: https://monsterapi.co/docs/api/facebook#facebook-video-details-by-id Operation ID: `facebook_video_hero` Returns video identity, publication times, duration, dimensions, engagement and available comments. Pass video_id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `video_id` (query, required): Numeric video ID. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/video/hero' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Video actions `GET /facebook/api/video/menu` Documentation: https://monsterapi.co/docs/api/facebook#facebook-video-actions Operation ID: `facebook_video_menu` Returns available action types, labels and reporting links for a video. Pass video_id and video_menu_location. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `video_id` (query, required): Numeric video ID. - `video_menu_location` (query, required): Menu context: `VIDEO_HOME_VIDEO_STORY` or `VIDEO_HOME_TAHOE_CONTEXT`. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/video/menu' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Video feed sections `GET /facebook/api/watch/render` Documentation: https://monsterapi.co/docs/api/facebook#facebook-video-feed-sections Operation ID: `facebook_watch_render` Returns video-feed sections, video previews and available continuation values. No parameters are required. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs ## Responses - 200: Requested information; unavailable optional values are null. - 400: #/components/responses/GatewayBadRequest - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/watch/render' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Video feed section videos `GET /facebook/api/watch/section` Documentation: https://monsterapi.co/docs/api/facebook#facebook-video-feed-section-videos Operation ID: `facebook_watch_section` Returns videos for one feed section. Pass section_id and optionally cursor; pages may repeat videos, which are identified by id. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `section_id` (query, required): Section ID from `sections[].id` in [/watch/render](https://monsterapi.co/docs/api/facebook-watch#facebook-video-feed-sections) or [/watch/topic](https://monsterapi.co/docs/api/facebook-watch#facebook-video-topic-sections). - `cursor` (query, optional): `next_cursor` from [/watch/render](https://monsterapi.co/docs/api/facebook-watch#facebook-video-feed-sections) or [/watch/topic](https://monsterapi.co/docs/api/facebook-watch#facebook-video-topic-sections) for its populated section, or this endpoint for the same section. Pass it unchanged; videos can repeat between pages. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/watch/section' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Video topic sections `GET /facebook/api/watch/topic` Documentation: https://monsterapi.co/docs/api/facebook#facebook-video-topic-sections Operation ID: `facebook_watch_topic` Returns a video topic with its subtopics and video sections. Pass topic_id and section_id from `route.topic_id` and `route.section_id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for the topic path, such as `/watch/topic/947722281917040/`. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `topic_id` (query, required): Numeric topic ID: `route.topic_id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for the topic path, such as `/watch/topic/947722281917040/`, or `topics[].id` in [/watch/topics](https://monsterapi.co/docs/api/facebook-watch#facebook-video-topics). An ID that names no topic returns `500` with code `upstream_shape`. That code does not show whether the topic exists. - `section_id` (query, required): Section ID of the same topic: `route.section_id` in [/route](https://monsterapi.co/docs/api/facebook-route#facebook-path-identifiers) for the topic path. The topic comes from `topic_id` and the videos from this section, so pass both from one answer. ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: A request parameter is invalid. Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/watch/topic' \ -H 'Authorization: Bearer ' ``` --- # Facebook: Video topics `GET /facebook/api/watch/topics` Documentation: https://monsterapi.co/docs/api/facebook#facebook-video-topics Operation ID: `facebook_watch_topics` Returns the video topics with their IDs, names and icon names, and the names of the trending hashtags. No parameters are required. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs ## Responses - 200: Requested information in data and its named fields; unavailable optional values are null. - 400: #/components/responses/GatewayBadRequest - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: The requested object is absent, or Facebook does not show it to logged-out visitors. An empty page of an object that exists does not return `404`. - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: `rate_limited`: Facebook limited the requests or asked a logged-out visitor to sign in. Wait for the seconds in `Retry-After`, then repeat the request. Facebook publishes no numbers for these limits. Refused at the gateway: the account calls faster than its rate limit allows - 500: The requested information could not be returned. - 501: The requested information is unavailable without signing in or is not supported. - 503: The requested information is temporarily unavailable. Repeat the request later. `code` gives the cause: - `upstream_error`: no answer came from Facebook, or Facebook answered with a server error. Wait for the seconds in `Retry-After`, then repeat the request. - `upstream_stale`: the service is renewing its access to this information. - `no_proxies`: the service cannot get this kind of information at the moment. - `overloaded`: the service is handling too many requests at the same time. Repeat the request after a short pause, or send fewer requests at the same time. Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/facebook/api/watch/topics' \ -H 'Authorization: Bearer ' ```