Fake WhatsApp chat API

WhatsApp chat screenshot API.

Send JSON. Preview the exact WhatsApp scene. Export a screenshot or animated chat video from your server.

PNG · JPEGMP4 · WebMScoped API keys

POST/api/v1/screenshots

PNG or JPEG request. The same scene also renders MP4 or WebM.

Request body

Type a quoted field. Press Tab to complete it.

Autocomplete

{
  "template": "chat-vertical",
  "format": "png",
  "scale": 2,
  "scene": {
    "platform": "whatsapp",
    "showDeviceFrame": true,
    "header": {
      "name": "Maya",
      "status": "online",
      "time": "9:41"
    },
    "settings": {
      "contentZoom": 106,
      "darkMode": false,
      "showStatusBar": true,
      "showMessageTimes": true
    },
    "messages": [
      {
        "id": "brief",
        "type": "text",
        "text": "Did the launch clip export?",
        "direction": "incoming",
        "status": "read",
        "sentAt": "2026-09-03T09:41:00"
      },
      {
        "id": "reply",
        "type": "text",
        "text": "Yes. The WhatsApp scene is ready.",
        "direction": "outgoing",
        "status": "read",
        "sentAt": "2026-09-03T09:42:00"
      },
      {
        "id": "check",
        "type": "text",
        "text": "Great. Send the vertical version too.",
        "direction": "incoming",
        "status": "read",
        "sentAt": "2026-09-03T09:43:00"
      },
      {
        "id": "done",
        "type": "text",
        "text": "Rendering the video now.",
        "direction": "outgoing",
        "status": "read",
        "sentAt": "2026-09-03T09:44:00"
      }
    ]
  }
}

Valid request. Preview matches this scene.

Live WhatsApp preview

PNG · chat-vertical

9:41

Maya

online

Did the launch clip export?09:41

Yes. The WhatsApp scene is ready.09:42

Great. Send the vertical version too.09:43

Rendering the video now.09:44

Preview here. Export through the API.

A subscription unlocks screenshot and video render credits.

Get API access

Shared editor previewStructured JSONRevocable keysPrivate video jobs

One scene, two outputs

Render the frame. Or let the conversation move.

The same WhatsApp scene can become a static asset for a page, deck, or thumbnail, then a timed video for TikTok, Reels, or Shorts.

Screenshot

PNG or JPEG

POST /api/v1/screenshots

Returns the rendered image immediately.

Video

MP4 or WebM

POST /api/v1/video-renders

Creates a private job you can poll and download.

JSON to WhatsApp

Make repeatable chat visuals without rebuilding them by hand.

Use the WhatsApp conversation API for automated creator pipelines, product demos, fictional support scenes, test fixtures, thumbnails, and story-driven video batches.

01
Send the scene
Set the contact, messages, direction, status, timestamps, theme, and output template in JSON.
02
Check the preview
Use the browser playground to catch copy, spacing, and message-flow mistakes before a paid render.
03
Render by API
Create a scoped key, call the screenshot or video endpoint, and deliver the file inside your workflow.

Need the full template reference, retry behavior, and credit rules?

Read the API reference

API subscription

Preview first. Pay when you are ready to render.

Screenshot and video scopes

API Starter

One plan for screenshots and video.

Create scoped keys, render from your server, and revoke access whenever you need to.

200 credits monthly · scoped keys · cancel anytime

Monthly

$15/mo

200 credits included

No trial. Studio Pro is separate.

200 monthly credits Scoped, revocable keys Failed renders return credits

Questions

Before your first request.

The preview is open. Rendering requires API Starter and a server-side key.

What is a WhatsApp chat screenshot API?

It converts structured JSON into a WhatsApp-style conversation image. Send the contact details, messages, direction, timestamps, and output settings, then save the returned PNG or JPEG.

Can the API generate animated WhatsApp chat videos?

Yes. Use the video render endpoint to create an MP4 or WebM with timed message reveals. The response gives you a private job to poll before downloading the completed file.

Does the preview use the same WhatsApp renderer as the editor?

Yes. The playground uses TheFake's shared WhatsApp preview, so bubble styling, read receipts, timestamps, headers, and supported message types match the scene you are preparing to render.

Can I control zoom, theme, framing, and output quality?

Yes. Set content zoom from 100% to 130%, switch light or dark mode, include or remove the phone frame, choose the output layout, and render at 1× to 4× resolution. Content zoom changes the WhatsApp UI size; output scale changes the final pixel density and credit cost.

Do I need a subscription to use the API?

Yes. The playground preview is available on this page, while API keys and server renders require API Starter at $15/mo. The plan includes 200 monthly credits.

Is this the official WhatsApp Business API?

No. TheFake creates fictional WhatsApp-style mockups for creative, educational, and production workflows. It does not send real WhatsApp messages and is not affiliated with WhatsApp or Meta.

Create fictional scenes for creative, educational, and production use. Do not impersonate people, fabricate evidence, or mislead an audience.

Open the visual editor Acceptable use