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 "image=@background.jpg" \
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#

Sign up (opens in new tab) 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 "image=@background.jpg" \
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);