> ## Documentation Index > Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt > Use this file to discover all available pages before exploring further. # Post > Get a public Facebook post or reel by url. πŸ’³ **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/facebook/post openapi: 3.1.0 info: title: SociaVault API version: 1.0.0 description: >- # SociaVault API Documentation The SociaVault API provides comprehensive access to social media data extraction across multiple platforms. ## Features - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter, Reddit, Threads, and more - **Credit-Based System**: Pay-as-you-go pricing with transparent credit costs - **High Performance**: Fast, reliable data extraction - **Comprehensive Data**: Detailed user profiles, videos, posts, comments, and analytics ## Authentication All API requests require authentication using an API key in the `X-API-Key` header: ```bash X-API-Key: sk_live_your_api_key_here ``` Get your API key from the [SociaVault Dashboard](https://sociavault.com/dashboard). ## Credits Each endpoint consumes credits based on data complexity: - Simple requests (profiles): 1 credit - Complex requests (demographics): 20+ credits - Paginated requests: Credits per page Check your credit balance in the dashboard or via the API. ## Support - **Documentation**: https://docs.sociavault.com - **Email**: support@sociavault.com - **Discord**: https://discord.gg/sociavault contact: name: SociaVault Support email: support@sociavault.com url: https://sociavault.com/support license: name: Commercial url: https://sociavault.com/terms servers: - url: https://api.sociavault.com description: Production API security: - ApiKeyAuth: [] tags: - name: account description: Account management and credit balance externalDocs: description: Learn more url: https://docs.sociavault.com/account - name: tiktok description: Scrape TikTok profiles, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok - name: tiktok-shop description: Everything about TikTok Shop externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok-shop - name: instagram description: Gets Instagram profiles, posts, and reels externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/instagram - name: youtube description: Scrape YouTube channels, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/youtube - name: linkedin description: Scrape LinkedIn externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedin - name: facebook description: Get public Facebook profiles and posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebook - name: facebookAdLibrary description: Scrapes the Facebook (Meta) Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookAdLibrary - name: facebookMarketplace description: Search Facebook Marketplace and pull full listing details externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookMarketplace - name: googleAdLibrary description: >- Scrape the Google Ad Transparency Library. *This only gets the public ads. Some ads you need to log in for and sadly we can't get those. Also, since there are so many variations, the return types might not all be 100% the same. externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/googleAdLibrary - name: linkedinAdLibrary description: Search the LinkedIn Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedinAdLibrary - name: twitter description: Get Twitter profiles, tweets, followers and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/twitter - name: reddit description: Scrape Reddit posts and comments externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/reddit - name: threads description: Get Threads posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/threads - name: google description: Scrape Google search results externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/google paths: /v1/scrape/facebook/post: get: tags: - facebook summary: Post description: Get a public Facebook post or reel by url. operationId: facebook_Post parameters: - name: url in: query description: The URL of the post to get required: true schema: type: string example: https://www.facebook.com/reel/1535656380759655 responses: '200': description: >- Successful response **Key Response Fields:** - `data.post_id`: Unique post/reel ID - `data.url`: Direct URL to the post or reel - `data.description`: Post caption/description text - `data.like_count`: Total like count - `data.comment_count`: Total comment count - `data.share_count`: Total share count - `data.view_count`: Total video view count (for videos/reels) - `data.video.id`: Video ID - `data.video.sd_url`: SD video stream URL - `data.video.hd_url`: HD video stream URL - `data.video.thumbnail`: Video thumbnail image URL - `data.video.length_in_second`: Video duration in seconds - `data.video.captions_url`: SRT captions/subtitles URL (if available) - `data.author.name`: Name of the post author - `data.author.is_verified`: Whether the author is a verified account - `data.music.track_title`: Audio track title (if applicable) content: application/json: example: success: true data: success: true post_id: '25118307061088489' like_count: 8784 comment_count: 99 share_count: 444 view_count: 316000 description: >- Air Fryer Chocolate Cake 100% f*cks, super simple and comes out gooey in the middle. πŸ† πŸ‘¨β€πŸ³ Ingredients: βœ… 1 large banana – 100 g (3.5 oz) βœ… 80 g vanilla YoPro yogurt (2.8 oz / β…“ cup) βœ… 15 g Cadbury Bournville cocoa (0.5 oz / 1 tbsp) βœ… 80 ml egg whites (2.7 fl oz / β…“ cup) βœ… 50 g oat flour (1.75 oz / Β½ cup) βœ… 1 tsp vanilla extract (5 ml) βœ… Β½ tsp baking powder (2.5 g) πŸ‘‰ Optional: 1 square dark chocolate (10 g / 0.35 oz, ~55 cals) πŸ”₯ Method: 1. Mix banana, egg whites, yogurt, cocoa and vanilla until smooth 2. Stir in oat flour and baking powder 3. Pour into a ramekin or muffin tin 4. Add chocolate square to the centre if using 5. Air fry at 160Β°C / 320Β°F for 20 minutes πŸ“Š Macros (whole recipe): Without choc: 378 cals | 27 g protein | 61.9 g carbs | 6 g fat With choc: 433 cals | 27 g protein | 61.9 g carbs | 11.5 g fat πŸ“Š Macros (per serve β€” 2 serves): Without choc: 189 cals | 13.5g protein | 31 g carbs | 3 g fat With choc: 217 cals | 13.5 g protein | 31 g carbs | 5.8 g fat I also added low-calorie Peters ice cream and a small drizzle of Biscoff, but it honestly doesn’t need it. Tastes great on its own! If you would like to make changes to this recipe yourself please do, but I like this EXACTLY the way it is. 🀝🫑 feedback_id: ZmVlZGJhY2s6MjUxMTgzMDcwNjEwODg0ODk= url: https://www.facebook.com/reel/1535656380759655 image_url: null video: id: '1535656380759655' sd_url: >- https://video-mad2-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQP26h3cF_x-zEqNiL22tbkM8vRrcYmq5O3IHLNA-ibZVh613E_-SBR25nd0qXxlNWxOfbRGXJx4jBskIIfW0H5CKtNCb_db46moK5c.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=video-mad2-1.xx.fbcdn.net&_nc_ohc=1r-eQN17uJoQ7kNvwE8T30m&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLmRhc2hfYmFzZWxpbmVfM192MSIsInhwdl9hc3NldF9pZCI6ODExMzk0ODE0NzQ2OTYwLCJhc3NldF9hZ2VfZGF5cyI6MTQ0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MjMsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=fdcb49c72d2cc2d1&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8wMTQzOURBOUFFRUU5NzVDQTEzMjcwNDRCMTM0MzRBQ192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC83ODUxMTI3NDQ0ODc5NDdfMzQ5ODEwNjcwMTM3Njk5MDc1OC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmoIWlu7L98AIVAigCQzMsF0A3ZmZmZmZmGBJkYXNoX2Jhc2VsaW5lXzNfdjERAHUCZeadAQA&_nc_gid=4irDPvq76xudZSFJYx1sDg&_nc_zt=28&oh=00_AftMhaYFKV4Gpe5lppa6s19te9d8fSolksUrU31DWvbrUQ&oe=698AE799&bitrate=313048&tag=dash_baseline_3_v1 hd_url: >- https://video-mad1-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQM7Ez8-u4M80Wm9tTwV9bEH6kAzzPN5-OItb-_hFmYJ8FCWTovPjH6rggWTTISlhmy7nFZivFjpRPRpRVDlHVVdyvdGJvwkMi6Nd4Y.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=video-mad1-1.xx.fbcdn.net&_nc_ohc=Bn5shJBdUnwQ7kNvwFUjVoA&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6ODExMzk0ODE0NzQ2OTYwLCJhc3NldF9hZ2VfZGF5cyI6MTQ0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MjMsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=adb24d6c8ae70f7f&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9FNjQyNEY1M0I4MjZDMEVFNUJENzI4OTM2ODlCRkZBRl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC83ODUxMTI3NDQ0ODc5NDdfMzQ5ODEwNjcwMTM3Njk5MDc1OC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmoIWlu7L98AIVAigCQzMsF0A3ZmZmZmZmGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHUCZeadAQA&_nc_gid=4irDPvq76xudZSFJYx1sDg&_nc_zt=28&oh=00_AfvTOohWFv6BslKAtB9I-AWl3C6wX_WSjhOFFSBsTCV_RQ&oe=698B1450&bitrate=1087975&tag=dash_baseline_1_v1 height: 1920 width: 1080 length_in_second: 23.4 thumbnail: >- https://scontent-mad1-1.xx.fbcdn.net/v/t51.82787-10/549761436_18521992156021539_7633323777597918486_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=103&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=HR6AKX5XWvAQ7kNvwFp8F1L&_nc_oc=AdnDIehXjw5WjXdKeCWXlRuT7Q4IkMsbTf9X9Nqfo5a-kMCu52zW0n0qzYN0WFal_8Q&_nc_zt=23&_nc_ht=scontent-mad1-1.xx&_nc_gid=4irDPvq76xudZSFJYx1sDg&oh=00_AfvXV9FfuutlFiSlZt1N5qVp-5uKljsUsvmx85g__LDgUA&oe=698EDBA8 captions_url: >- https://scontent-mad1-1.xx.fbcdn.net/v/t39.2093-6/548496336_1535656704092956_4849526113470105591_n.srt?_nc_cat=105&ccb=1-7&_nc_sid=c211c2&_nc_ohc=Wy1FvJW_gA0Q7kNvwESFiVO&_nc_oc=Adkg2MoqpWXVqCSA3XZGYxK1HkKoLQ8rPQ0XNEiHiwuKKi9RohQ4zbUaIYU-QMQBwbo&_nc_zt=14&_nc_ht=scontent-mad1-1.xx&_nc_gid=4irDPvq76xudZSFJYx1sDg&oh=00_AfvayFlm1WL45dWioGjolcauWfGGMHdyl1R4aOz9epJVXw&oe=698EFC5F author: id: '100000076236457' name: Matt West is_verified: true url: https://www.facebook.com/matt.west.184 image: >- https://scontent-mad2-1.xx.fbcdn.net/v/t39.30808-1/485744182_9938984382780671_4072259528431711152_n.jpg?stp=cp0_dst-jpg_s40x40_tt6&_nc_cat=1&ccb=1-7&_nc_sid=1d2534&_nc_ohc=9pdXqH1nJ2EQ7kNvwGWEhL0&_nc_oc=AdnPNcRGt0uieLDauHozKNUeUZlQfnV5-CnP4wETRYvv6bBPdNUt6oTKap73un0hhFs&_nc_zt=24&_nc_ht=scontent-mad2-1.xx&_nc_gid=4irDPvq76xudZSFJYx1sDg&oh=00_AfsNtl4AAtyqDx4Szc57Bi9lvSA449bzsfiZh8UhaeDvAw&oe=698ED766 music: id: '1506592770696336' type: CUSTOM_AUDIO track_title: Matt West Β· Original audio music_album_art: >- https://scontent-mad2-1.xx.fbcdn.net/v/t39.30808-1/485744182_9938984382780671_4072259528431711152_n.jpg?stp=cp0_dst-jpg_s64x64_tt6&_nc_cat=1&ccb=1-7&_nc_sid=1d2534&_nc_ohc=9pdXqH1nJ2EQ7kNvwGWEhL0&_nc_oc=AdnPNcRGt0uieLDauHozKNUeUZlQfnV5-CnP4wETRYvv6bBPdNUt6oTKap73un0hhFs&_nc_zt=24&_nc_ht=scontent-mad2-1.xx&_nc_gid=4irDPvq76xudZSFJYx1sDg&oh=00_AftbWHDoy_xrL4KN3hzZwmJj4V5DBaq1I4f6J7OAlkPKpg&oe=698ED766 transcript: |- 1 00:00:00,000 --> 00:00:02,561 A recipe that **** Throw one ripe banana into a bowl and 2 00:00:02,561 --> 00:00:05,121 give it a mash. Followed by vanilla protein yogurt, cocoa 3 00:00:05,121 --> 00:00:08,161 powder, egg whites, oat flour, baking powder, some vanilla 4 00:00:08,161 --> 00:00:10,881 extract and give it a good mix and pour into a baking tin. Add 5 00:00:10,881 --> 00:00:12,881 in a cheeky square of dark chocolate if you please and 6 00:00:12,881 --> 00:00:14,961 bake in the air fryer for 20 minutes and now you got 7 00:00:14,961 --> 00:00:18,241 yourself a dessert that 100% **** packing 27 grams of 8 00:00:18,241 --> 00:00:20,961 protein. Full recipe's in the description so until next time. 9 00:00:20,961 --> 00:00:24,881 Bon appetite and we'll see you in the next video. comments: '0': id: Y29tbWVudDoyNTExODMwNzA2MTA4ODQ4OV8xNDYyNDE4MzkxNjMzMTk3 text: >- Air Fryer Chocolate Cake 100% f*cks, super simple and comes out gooey in the middle. πŸ† πŸ‘¨β€πŸ³ Ingredients: βœ… 1 large banana – 100 g (3.5 oz) βœ… 80 g vanilla YoPro yogurt (2.8 oz / β…“ cup) βœ… 15 g Cadbury Bournville cocoa (0.5 oz / 1 tbsp) βœ… 80 ml egg whites (2.7 fl oz / β…“ cup) βœ… 50 g oat flour (1.75 oz / Β½ cup) βœ… 1 tsp vanilla extract (5 ml) βœ… Β½ tsp baking powder (2.5 g) πŸ‘‰ Optional: 1 square dark chocolate (10 g / 0.35 oz, ~55 cals) πŸ”₯ Method: 1. Mix banana, egg whites, yogurt, cocoa and vanilla until smooth 2. Stir in oat flour and baking powder 3. Pour into a ramekin or muffin tin 4. Add chocolate square to the centre if using 5. Air fry at 160Β°C / 320Β°F for 20 minutes πŸ“Š Macros (whole recipe): Without choc: 378 cals | 27 g protein | 61.9 g carbs | 6 g fat With choc: 433 cals | 27 g protein | 61.9 g carbs | 11.5 g fat πŸ“Š Macros (per serve β€” 2 serves): Without choc: 189 cals | 13.5g protein | 31 g carbs | 3 g fat With choc: 217 cals | 13.5 g protein | 31 g carbs | 5.8 g fat I also added low-calorie Peters ice cream and a small drizzle of Biscoff, but it honestly doesn’t need it. Tastes great on its own! If you would like to make changes to this recipe yourself please do, but I like this EXACTLY the way it is. 🀝🫑 created_at: '2025-09-18T07:24:22.000Z' reply_count: 3 reaction_count: 25 author: id: '100000076236457' name: Matt West gender: MALE short_name: Matt credits_used: 1 endpoint: facebook/post '400': description: Bad Request - Invalid parameters or missing required fields content: application/json: schema: type: object properties: error: type: string example: 'Missing required parameter: handle' endpoint: type: string credits_required: type: integer required: - error '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: string example: Invalid API key docs: type: string example: https://docs.sociavault.com/authentication required: - error '402': description: Payment Required - Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 description: Credits required for this request available: type: integer example: 0 description: Credits currently available required: - error - required - available '500': description: Internal Server Error - Service configuration or processing error content: application/json: schema: type: object properties: error: type: string example: Service configuration error required: - error components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](https://sociavault.com/dashboard). ````