Name: Twitter/X Screenshot – Tweet to Image | Free · $10/mo | API.market
Brand: eiconstela
SKU: api-eiconstela-x-screenshot
Availability: InStock
Rating: 5.00 (2 reviews)
Author: API Market

M Razif Rizqullah

# Twitter / X Screenshot API

Welcome to the Twitter / X Screenshot API!
This API allows you to generate **4K-quality screenshots** of Twitter (X) posts effortlessly.
Provide a tweet URL and customize the output with options like theme, padding, zoom level, and element visibility.

---

## Base Information

* **Endpoint**: `POST /screenshot`
* **Host**: `YOUR_API_HOST` (replace with your actual API host, e.g. `https://api.example.com`)
* **Content-Type**: `application/json`
* **Authentication**: API Key (if enabled by your deployment)

---

## API Overview

The API takes a **tweet URL** and customization parameters to generate a screenshot of the tweet.
You can control the theme, background transparency, padding, text size, zoom level, and show/hide individual UI elements.

### Example cURL Request

```bash
curl --location 'https://your-api-host.com/screenshot' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
  "url": "https://x.com/X/status/1932065354290786718",
  "light_mode": "dark",
  "transparent": false,
  "padding": [300, 150, 300, 150],
  "datetime_size": 0.9,
  "zoom_level": 2.1,
  "show_views": true,
  "show_reply": false,
  "show_like": false,
  "show_retweet": false,
  "show_bookmark": false,
  "show_datetime": true,
  "format": "bytes"
}'
```

---

## Request Details

### `POST /screenshot`

#### Headers

| Header          | Value              | Description                              |
| --------------- | ------------------ | ---------------------------------------- |
| `Content-Type`  | `application/json` | Specifies the request body format        |
| `Authorization` | `Bearer <API_KEY>` | Optional: Required if API key is enabled |

---

### Request Body Parameters

| Parameter       | Type                            | Required | Default | Description                                                                                                                                  |
| --------------- | ------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`           | `string`                        | Yes      | N/A     | The full URL of the Twitter (X) post (e.g., `https://x.com/username/status/123456789`)                                                       |
| `light_mode`    | `string`                        | No       | `dark`  | Theme: `light`, `dim`, or `dark`                                                                                                             |
| `transparent`   | `boolean`                       | No       | `false` | Whether the background should be transparent                                                                                                 |
| `padding`       | `int` or `[int, int, int, int]` | No       | `50`    | Padding around screenshot. Can be a single value (applied to all sides) or an array `[y_padding, x_padding]` or `[top, right, bottom, left]` |
| `format`        | `string`                        | No       | `bytes` | Output format: `bytes` (binary PNG) or `base64` (encoded string)                                                                             |
| `show_views`    | `boolean`                       | No       | `true`  | Display view count                                                                                                                           |
| `show_reply`    | `boolean`                       | No       | `true`  | Display reply count                                                                                                                          |
| `show_like`     | `boolean`                       | No       | `true`  | Display like count                                                                                                                           |
| `show_retweet`  | `boolean`                       | No       | `true`  | Display retweet count                                                                                                                        |
| `show_bookmark` | `boolean`                       | No       | `true`  | Display bookmark count                                                                                                                       |
| `show_datetime` | `boolean`                       | No       | `true`  | Display date & time of the tweet                                                                                                             |
| `datetime_size` | `float`                         | No       | `1.0`   | Scaling factor for the datetime text size (allowed range: `0 < size < 5.0`)                                                                  |
| `zoom_level`    | `float`                         | No       | `2.0`   | Zoom level for rendering (allowed range: `0 < zoom < 5.0`)                                                                                   |

---

### Example Request Body

```json
{
  "url": "https://x.com/X/status/1932065354290786718",
  "light_mode": "dark",
  "transparent": false,
  "padding": [300, 150, 300, 150],
  "datetime_size": 0.9,
  "zoom_level": 2.1,
  "show_views": true,
  "show_reply": false,
  "show_like": false,
  "show_retweet": false,
  "show_bookmark": false,
  "show_datetime": true,
  "format": "bytes"
}
```

---

## Response Details

### Success Response

* **Status Code**: `200 OK`
* **Content-Type**: Depends on `format`
* **Body**: Screenshot data

| Format   | Response Type | Description                       |
| -------- | ------------- | --------------------------------- |
| `bytes`  | Binary data   | Raw screenshot (PNG file content) |
| `base64` | JSON string   | Base64-encoded screenshot image   |

**Example Response (`base64` format)**

```json
{
  "status": "success",
  "message": "Screenshot OK",
  "data": {
    "base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAD7QAACLLCAYAAA..."
  }
}
```

### Error Responses

| Status Code | Description                 |
| ----------- | --------------------------- |
| `400`       | Bad Request (invalid input) |
| `422`       | Unprocessable Entity        |
| `429`       | Too Many Requests           |
| `500`       | Server Error                |

---

## Usage Examples

**1. Dark-Themed Screenshot with Custom Padding & Zoom**

```bash
curl --location 'https://your-api-host.com/screenshot' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
  "url": "https://x.com/X/status/1932065354290786718",
  "light_mode": "dark",
  "padding": [300, 150, 300, 150],
  "zoom_level": 2.1,
  "format": "bytes"
}'
```

**2. Transparent Light Mode with Smaller Datetime**

```bash
curl --location 'https://your-api-host.com/screenshot' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
  "url": "https://x.com/X/status/1932065354290786718",
  "light_mode": "light",
  "transparent": true,
  "datetime_size": 0.8,
  "show_datetime": true,
  "format": "base64"
}'
```

---

## Notes

* `padding` can be **one number** (applies equally) or **four numbers** for `[top, right, bottom, left]`.
* `datetime_size` lets you fine-tune how big/small the date text appears.
* `zoom_level` can be between `0.1` and `5.0` (recommended `1.5–2.5` for best results).
* For binary (`bytes`) responses, save to a file (e.g., `screenshot.png`) or process in-memory.

---

## Changelogs

* 2025/08/27 – Bug fixing and added customization: new `datetime_size` & flexible `padding` options
* 2025/07/30 – Performance enhancement and bug fixes
* 2025/07/15 – Enhanced error handling for private/unavailable tweets
* 2025/06/16 – Fixed URL handling issue with `https://twitter.com`
* 2025/06/12 – Added uptime healthcheck endpoint
* 2025/06/10 – Added show/hide UI elements & zoom level
* 2025/05/25 – Bug fix due to Twitter/X updates
* 2025/04/09 – Fixed transparency mask bug
* 2025/02/12 – Initial release

---

## Support

For issues or questions, contact us at: **[razifrizqullah@gmail.com](mailto:razifrizqullah@gmail.com)**

Happy screenshotting 🚀

Generate 4K screenshots of any X post via API. Customize theme, padding & zoom. Free 100 calls/mo, from $10/mo. Start free on API.market.

Twitter/X Screenshot – Tweet to Image | Free · $10/mo | API.market

Free

Constela API

Mega

Giga

Very good APi, works really well to take screenshot of any status progrmatically. 