Introduction | Titlize Docs

Titlize is an API-first service that automatically generates professional social media preview images (Open Graph images) by overlaying text on existing images.

What is Titlize?#

When you share a link on social media platforms like Twitter, Facebook, or LinkedIn, these platforms display a preview card with an image. This image is known as the Open Graph image or OG image.

Titlize makes it easy to generate these images automatically by:

Overlaying your title text on a background image
Automatically detecting the best text placement
Applying smart gradients for text readability
Generating optimized images for social media

Key Features#

Automatic Text Placement#

Our contrast detection algorithm analyzes your background image and automatically positions your text in the most readable location.

Smart Gradients#

A subtle gradient is applied to ensure your text stands out, regardless of the background image colors.

API-First Design#

Titlize is built as an API-first service, making it easy to integrate with any platform or workflow.

Bash

1 curl -X POST https://api.titlize.com/generate \
2   -H "Authorization: Bearer your_api_token" \
3   -F "[email protected]" \
4   -F "title=My Amazing Blog Post"

Multiple Integrations#

We provide official integrations for popular platforms:

WordPress - One-click plugin for automatic OG image generation
Next.js - React components and API helpers
Zapier - No-code automation workflows

Quick Start#

There are two ways to get to your first generated image. Pick either.

Let your agent do it#

If you code with an AI agent — Claude Code, Codex, Cursor or similar — copy this sentence and paste it in. Your agent installs the Titlize skills, registers the MCP server, asks you for an API token, and generates one image to prove it worked. The three manual steps below are exactly what it automates.

See the AI agents guide for what the prompt contains and which agents are covered.

Or set it up by hand#

Sign up for an account
Create an API token from your dashboard
Make your first API request

Here's a simple example using JavaScript:

JavaScript

1 const formData = new FormData();
2 formData.append('image', imageFile);
3 formData.append('title', 'My Blog Post Title');
4  
5 const response = await fetch('https://api.titlize.com/generate', {
6   method: 'POST',
7   headers: {
8     'Authorization': 'Bearer your_api_token',
9   },
10   body: formData,
11 });
12  
13 const result = await response.json();
14 console.log('Generated image URL:', result.url);

Next Steps#

Read the API Authentication guide
Explore the API Endpoints reference
Set up the WordPress Integration

1	curl -X POST https://api.titlize.com/generate \
2	-H "Authorization: Bearer your_api_token" \
3	-F "[email protected]" \
4	-F "title=My Amazing Blog Post"

1	const formData = new FormData();
2	formData.append('image', imageFile);
3	formData.append('title', 'My Blog Post Title');
4
5	const response = await fetch('https://api.titlize.com/generate', {
6	method: 'POST',
7	headers: {
8	'Authorization': 'Bearer your_api_token',
9	},
10	body: formData,
11	});
12
13	const result = await response.json();
14	console.log('Generated image URL:', result.url);