---
title: "Convert a Facebook Post Embed"
description: "Render a Facebook embed as an image with the HTML API. Multi-language code and the cache pitfalls to know."
url: "https://html2img.com/docs/examples/facebook-post/"
---
# How to Convert a Facebook Post Embed to an Image
Render a Facebook post embed as a PNG. Useful for archiving posts, embedding in email newsletters, or including in printed materials.
> **Note**
>
> Want it faster? Use the [Facebook Post template](https://html2img.com/templates/facebook-post/) and skip the SDK entirely. Send the post text and author as JSON and get a styled card back.
## HTML and CSS
```html
```
```css
body { margin: 0; padding: 16px; background: white; }
.fb-post { margin: 0 auto !important; }
#fb-root { min-width: 500px; }
```
## ms_delay
The Facebook SDK loads asynchronously. Use [ms_delay](https://html2img.com/docs/parameters/ms_delay/) of 1000ms minimum so the post renders before capture.
## Code examples
### cURL
```bash
curl -X POST https://app.html2img.com/api/html \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"html": "",
"css": "body { margin: 0; padding: 16px; background: white; } .fb-post { margin: 0 auto !important; } #fb-root { min-width: 500px; }",
"width": 500,
"height": 196,
"ms_delay": 1000
}'
```
### PHP
```php
$ch = curl_init('https://app.html2img.com/api/html');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('HTML2IMG_API_KEY'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'html' => '',
'css' => 'body { margin: 0; padding: 16px; background: white; } .fb-post { margin: 0 auto !important; } #fb-root { min-width: 500px; }',
'width' => 500,
'height' => 196,
'ms_delay' => 1000,
]),
]);
$url = json_decode(curl_exec($ch), true)['url'];
curl_close($ch);
```
### Node.js
```javascript
const response = await fetch('https://app.html2img.com/api/html', {
method: 'POST',
headers: { 'X-API-Key': process.env.HTML2IMG_API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({
html: '',
css: 'body { margin: 0; padding: 16px; background: white; } .fb-post { margin: 0 auto !important; } #fb-root { min-width: 500px; }',
width: 500,
height: 196,
ms_delay: 1000,
}),
});
const { url } = await response.json();
```
### Python
```python
import os, requests
response = requests.post(
'https://app.html2img.com/api/html',
headers={'X-API-Key': os.environ['HTML2IMG_API_KEY']},
json={
'html': '',
'css': 'body { margin: 0; padding: 16px; background: white; } .fb-post { margin: 0 auto !important; } #fb-root { min-width: 500px; }',
'width': 500, 'height': 196, 'ms_delay': 1000,
},
)
url = response.json()['url']
```
## Common pitfalls
- **SDK script blocked.** Privacy extensions and corporate proxies sometimes block `connect.facebook.net`. Use the [Facebook Post template](https://html2img.com/templates/facebook-post/) for predictable output.
- **Post is private.** Posts on private profiles render an empty card. Verify visibility before relying on this flow.
- **Render exceeds 30 seconds.** The SDK can be slow. Add a [webhook_url](https://html2img.com/docs/parameters/webhook-url/) and process the response asynchronously.
## See also
- [PHP integration guide](https://html2img.com/integrations/php/), [Python integration guide](https://html2img.com/integrations/python/)
- [css parameter](https://html2img.com/docs/parameters/css/), [ms_delay parameter](https://html2img.com/docs/parameters/ms_delay/)