Quick Start: Get your free API key and make your first conversion request in under 5 minutes. No credit card required!
Step-by-Step Tutorial
1
Register for Your Free API Key
Start by registering with your email address to get a free API key with 100 monthly requests.
curl -X POST https://t3xtr.org/api/register \
-H "Content-Type: application/json" \
-d '{"email":"your@email.com"}'
Tip: If the backslashes don't work in your terminal, use this single-line version instead:
curl -X POST https://t3xtr.org/api/register -H "Content-Type: application/json" -d '{"email":"your@email.com"}'
Response
{
"message": "User registered successfully",
"api_key": "tk_abc123def456...",
"user_id": "user_xyz789...",
"plan": "free",
"created_at": "2025-06-20T12:00:00.000Z"
}
Save your API key! Copy the
api_key from the response - you'll need it for all future requests.
2
Make Your First Conversion
Let's convert some Markdown text to HTML using your new API key.
curl -X POST https://t3xtr.org/api/markdown-to-html \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: text/plain" \
-d "# Welcome to T3XTR\nThis is **bold** text.\n\n## Features\n- Fast conversions"
Better method (preserves formatting):
printf "# Welcome to T3XTR\nThis is **bold** text.\n\n## Features\n- Fast conversions" | curl -X POST https://t3xtr.org/api/markdown-to-html -H "X-API-Key: your_api_key_here" -H "Content-Type: text/plain" --data-binary @-
Response
{
"success": true,
"result": "<h1>Welcome to T3XTR</h1>\n<p>This is <strong>bold</strong> text and this is <em>italic</em>.</p>\n<h2>Features</h2>\n<ul>\n<li>Fast conversions</li>\n<li>Multiple formats</li>\n<li>Simple API</li>\n</ul>",
"processing_time": 25
}
3
Check Your Usage
Monitor your API usage and remaining requests with the usage endpoint.
curl -H "X-API-Key: your_api_key_here" \
https://t3xtr.org/api/usage
Single-line alternative:
curl -H "X-API-Key: your_api_key_here" https://t3xtr.org/api/usage
Response
{
"user_id": "user_xyz789...",
"plan": "free",
"monthly_limit": 100,
"monthly_usage": 1,
"monthly_remaining": 99,
"credits_balance": 0,
"current_period": "2025-06",
"next_reset": "2025-07-01T00:00:00.000Z"
}
Popular Use Cases
📝 Documentation
Convert README files between Markdown and HTML for different platforms
📊 Data Processing
Transform CSV data to JSON for web applications and APIs
⚙️ Configuration
Convert between JSON and YAML configuration formats
📄 Reports
Generate PDF reports from HTML content programmatically
More Examples
Convert JSON to YAML
curl -X POST https://t3xtr.org/api/json-to-yaml \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"database": {
"host": "localhost",
"port": 5432,
"name": "myapp"
},
"cache": {
"enabled": true,
"ttl": 300
}
}'
Convert CSV to JSON
curl -X POST https://t3xtr.org/api/csv-to-json \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: text/plain" \
-d "name,email,role
John Doe,john@example.com,developer
Jane Smith,jane@example.com,designer"
Generate PDF from HTML
curl -X POST https://t3xtr.org/api/html-to-pdf \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: text/plain" \
-d "<html>
<head><title>My Report</title></head>
<body>
<h1>Monthly Report</h1>
<p>This is a sample report generated from HTML.</p>
</body>
</html>" \
--output report.pdf
Response Headers
All API responses include helpful headers to track your usage:
X-Monthly-Usage: 25 # Requests used this month
X-Monthly-Limit: 100 # Your monthly limit
X-Credits-Remaining: 50 # Pay-per-use credits available
X-RateLimit-Remaining: 275 # Requests left in rate limit window
Troubleshooting
Curl Command Issues
"URL rejected: Malformed input": This usually means the backslashes in multi-line curl commands aren't working in your terminal. Use the single-line versions provided instead.
"Validation failed: Email is required": Make sure you're using proper JSON formatting with double quotes:
{"email":"your@email.com"}
Common API Errors
The API returns standard HTTP status codes. Here are the most common ones:
401 Unauthorized: Check that your API key is correct and included in the
X-API-Key header.
402 Payment Required: You've exceeded your monthly limit and don't have enough credits. Add credits to continue.
429 Too Many Requests: You're hitting the rate limit. Wait a moment before making more requests.
Adding Credits
When you exceed your free monthly limit, requests cost $0.002 each. Add credits to your account:
curl -X POST https://t3xtr.org/api/credits/add \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"amount": 10.00}'
Integration Examples
JavaScript/Node.js
const fetch = require('node-fetch');
async function convertText(content, apiKey) {
try {
const response = await fetch('https://t3xtr.org/api/markdown-to-html', {
method: 'POST',
headers: {
'X-API-Key': apiKey,
'Content-Type': 'text/plain'
},
body: content
});
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const result = await response.json();
console.log('Conversion result:', result.result);
console.log('Monthly usage:', response.headers.get('X-Monthly-Usage'));
return result;
} catch (error) {
console.error('Conversion failed:', error);
}
}
// Usage
convertText('# Hello World\nThis is **bold**.', 'your_api_key_here');
Python
import requests
def convert_markdown_to_html(markdown, api_key):
url = 'https://t3xtr.org/api/markdown-to-html'
headers = {
'X-API-Key': api_key,
'Content-Type': 'text/plain'
}
try:
response = requests.post(url, headers=headers, data=markdown)
response.raise_for_status() # Raises exception for bad status codes
result = response.json()
print(f"Conversion successful: {result['success']}")
print(f"Monthly usage: {response.headers.get('X-Monthly-Usage')}")
return result['result']
except requests.exceptions.RequestException as e:
print(f"Conversion failed: {e}")
return None
# Usage
html = convert_markdown_to_html('# Hello World\nThis is **bold**.', 'your_api_key_here')
print(html)
🎉 You're all set! You now know how to use the T3XTR API. Check out the full documentation for more advanced features and all available endpoints.