Give me Markdown

API Documentation

Programmatic access to URL-to-Markdown conversion

Public API Coming Soon!

We're preparing to launch our public API with rate limiting, authentication, and usage analytics. Be the first to know when it's ready!

Help us prioritize! Your interest helps us understand which features to launch first. We respect your privacy and won't spam you.

Authentication

All API requests require authentication using a Bearer token (JWT). Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Getting an API key: Sign up at https://give-me-markdown.com to generate your API key.

Pricing Plans

Free

$0/month
1,000 API calls/month
Standard support
Community forum access
Perfect for testing and small projects
POPULAR

Medium

$2.99/month
25,000 API calls/month
Priority support
Usage analytics dashboard
Higher rate limits
Ideal for growing applications

Enterprise

$5.99/month
Unlimited API calls
Dedicated support
SLA guarantee
Custom integration support
For high-volume production use

POST /api/convert

Request

{
  "url": "https://example.com/article",
  "options": {
    "includeImages": true,
    "includeLinks": true
  }
}

Response

{
  "success": true,
  "markdown": "# Article Title\n\nContent...",
  "metadata": {
    "title": "Article Title",
    "url": "https://example.com/article"
  }
}

Parameters

urlrequired

The URL of the web page to convert to markdown

options.includeImagesoptional

Boolean. Include images in output (default: true)

options.includeLinksoptional

Boolean. Include hyperlinks in output (default: true)

Code Examples

curl -X POST https://give-me-markdown.com/api/convert \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"url": "https://example.com/article"}'

Error Responses

400

Bad Request

Missing or invalid URL

401

Unauthorized

Missing or invalid API key

429

Too Many Requests

Rate limit exceeded for your plan

500

Server Error

Conversion failed