Login Get started
Get started
Login Get started
social template

Tweet Mockup Card API

Send display name, handle, and tweet body as JSON, get back a 1200x800 PNG styled like a tweet card.

1200x800Dimensions
sRGBColor space
Not supportedTransparency
70 KB to 220 KBFile size range
Get started free Read the Tweet Mockup Card API reference

Marketing teams and presentation builders use the tweet mockup image API to display real customer tweets and quotes in branded artwork rather than embedding the live tweet. The 1200x800 layout reads as familiar but lives on your domain, so the page does not load tracking pixels or stutter on the Twitter widget. You post the display name, handle, body, and optional metrics as JSON, and the response holds a PNG that drops cleanly into a slide deck, newsletter, or blog post.

bash 
curl -X POST https://app.html2img.com/api/v1/templates/tweet-mockup-card \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"display_name":"Jordan Whitfield","handle":"@jwhitfield","body":"shipped a tiny side project this weekend and it already has more users than my last YC company\n\nfunny how that works","avatar_url":"https://i.pravatar.cc/160?img=15","verified":"blue","timestamp":"8:14 AM \u00b7 Apr 30, 2026","replies":"124","retweets":"512","likes":"4.2K","views":"182K","theme":"light"}'

A single cURL call to render a Tweet Mockup Card as a PNG. Add "format": "pdf" to the payload to get a PDF instead. For the full PHP, Node and Python equivalents, plus every input the template accepts, see the Tweet Mockup Card API reference. Setting up your key is covered in the authentication guide.

API reference

View the Tweet Mockup Card API reference: inputs, defaults, error responses and cURL, PHP, Node and Python code samples. Read the docs.

Tweet Mockup Card template preview, a social image generated by the HTML to Image API
Tweet Mockup Card 1200x800

Use cases

Marketing teams sharing real tweets in newsletters

Showing real social proof in a newsletter beats writing testimonials yourself. Render the customer's actual tweet (handle, body, timestamp, metrics) as a card, embed in the email body, and the newsletter shows lived feedback rather than corporate prose. The artwork stays consistent across many tweets because the styling is yours, not Twitter's. Halberd Software pulls 6 to 8 customer tweets per month into its weekly newsletter through this template.

Presentations illustrating social proof

Sales decks and conference talks benefit from screenshots of customer tweets, but live screenshots have inconsistent styling and resolution. Render with the actual handle and body, set theme to "light" or "dark" to match your slide template, and every customer quote in the deck looks uniform. Wren Analytics' enterprise sales deck includes 12 customer tweet cards rendered through this exact pattern.

Blog posts quoting tweets without Twitter's embed

The Twitter embed widget loads JavaScript, sets cookies, and slows page load. Render the tweet you want to quote as a static PNG, embed via a regular <img> tag, and the page stays fast and tracker-free. Northwind Studio's tutorial blog uses this for every tweet quoted in long-form content, and the page weight dropped 380 KB on average.

Legal-safe testimonial styling

Some industries (finance, healthcare) require testimonial usage approval before display. Render approved tweets with consistent styling that includes any mandated disclaimers in a footer slot, and the testimonial display stays compliant across every channel where the tweet card appears. Linden & Co's financial services clients run this pattern for tweet-style testimonial pages, and compliance review time dropped from two weeks to two days because the visual treatment is fully repeatable.

Internal recognition cards

HR and people teams collect kind words from peer recognition channels and surface them on internal Slack or town-hall slides. Render with the colleague's name and the message body, and the recognition feels weighted in a way a chat screenshot cannot match. Riverside Bakery recognizes one team member each Friday this way.

Output specifications

Dimensions
1200x800
Color space
sRGB
Transparency
Not supported
File size range
70 KB to 220 KB

Matches the spec at Tweet card visual styling reference.

These specifications describe the default PNG output. The template can also return a PDF document with selectable text through the HTML to PDF API: set format to pdf in the request. See the format parameter docs for how PDF output behaves.

How it works

1

Send a JSON payload

POST to the template endpoint with the values you want rendered. Authenticate with your API key.

2

We render the image

The template is rendered server-side as a 1200x800 PNG, or as a PDF document if you set format to pdf.

3

You get back a URL

Cache it, embed it in your page, attach it to an email.

Common pitfalls

Putting words in real people's mouths

A fabricated quote rendered with a real handle is a legal and ethical problem regardless of intent. Always use this template with content the named author actually posted, or with consenting in-house participants in the case of internal recognition cards.

Live tweet capture is the wrong tool here

For genuine quotes from existing tweets, screenshotting the live tweet via the Screenshot API is more accurate because it captures the actual published timestamp and metrics. Use this template only when you need consistent custom styling across many sources.

Avatar URL fallbacks look generic

A 404 on avatar_url falls back to a placeholder shape that may not match your brand. Validate the avatar URL before posting, or supply a fallback host image that does match your design language so the failure case stays branded.

Inputs at a glance

A quick summary of what the Tweet Mockup Card template accepts. The full reference, with example values and array shapes, is in the docs.

Name Type Required
display_name string Required
handle string Required
body string Required
avatar_url url Optional
verified enum Optional
image_url url Optional
timestamp string Optional
replies string Optional
retweets string Optional
likes string Optional
views string Optional
theme enum Optional

See the full inputs reference for descriptions, examples and validation rules.

Related templates

Other templates in the social media category.

Facebook Post Image template preview, a social image generated by the HTML to Image API
Facebook Post Image Facebook post

Bold share images sized for Facebook feed posts
Instagram Square Post template preview, a social image generated by the HTML to Image API
Instagram Square Post Instagram square post

Bold square images sized for the Instagram feed
Instagram Story template preview, a social image generated by the HTML to Image API
Instagram Story Instagram story

Vertical 9:16 covers for Instagram and TikTok stories
LinkedIn Post Image template preview, a social image generated by the HTML to Image API
LinkedIn Post Image LinkedIn post

Polished share images sized for LinkedIn feed posts
Pinterest Pin template preview, a social image generated by the HTML to Image API
Pinterest Pin Pinterest pin

Vertical 2:3 pins with strong typography that stand out in feed
Twitter/X Post Image template preview, a social image generated by the HTML to Image API
Twitter/X Post Image Twitter post

Generate share-ready images sized for Twitter/X posts
YouTube Thumbnail template preview, a social image generated by the HTML to Image API
YouTube Thumbnail YouTube thumbnail

High-contrast 16:9 thumbnails optimized for click-through

Browse by category

A starting point from each of the other two template categories.

Business and commerce

Content and marketing

See the full template gallery for every design grouped by category.

Related guides

FAQ

Is this for fake tweets?

No. Use this template for genuine tweet content displayed in your own brand-safe styling, or for internal-recognition messages where the source person has consented. Putting fabricated words into real people's mouths via this tool is a misuse and creates legal risk.

How is this different from screenshotting a real tweet?

A live screenshot captures the actual rendered tweet with current metrics, while this template lets you render the same content in your own styling. Use the Screenshot API for accuracy and this template for brand consistency. Either route can also return format: "pdf" when the quoted post needs to sit in a report or an evidence file as a document.

Can I include the metrics?

Yes, pass replies, retweets, likes, and views as separate string fields. The renderer prints them in the metrics row at the bottom of the card. Omit fields you do not want shown, and the row collapses to fit only the values you supplied.

What if I do not have an avatar URL?

The renderer falls back to a default avatar shape if avatar_url is missing or returns a 404. The shape uses the accent_color, so it stays consistent with the rest of your brand styling rather than looking like a generic placeholder.

Will it look like the real Twitter UI?

Close, but deliberately not pixel-identical. Use the rendered card as styled artwork that conveys the message, not as evidence of an actual published tweet. For attestation, take a screenshot of the live URL via the Screenshot API.

Can I include media inside the tweet card?

Yes, pass image_url with a public URL to a photo or graphic that appeared in the original tweet. The renderer composites it into the media slot below the body text. Most teams skip the media slot for clean text-only quotes.

Try it free

25 renders a month on the free tier. See the pricing page for higher-volume plans.

Create a free account Read the API reference