API Documentation

Build amazing integrations with Ink and Anvil's powerful API. Access D&D content, user data, and marketplace features programmatically.

API Coming Soon!

We're working hard on our public API to enable developers to build amazing integrations with Ink and Anvil. The API is currently in development and will be available in early 2025.

Interested in early access? We're looking for developers to help us test and refine the API before the public launch.

Join the Beta Program

Planned API Features

Here's what you'll be able to do with the Ink and Anvil API when it launches.

Content Access
Retrieve D&D homebrew content with full metadata
  • • Search and filter content
  • • Get content by type or creator
  • • Access purchase information
  • • Retrieve content files and attachments
User Management
Manage user accounts and creator profiles
  • • User authentication and profiles
  • • Creator statistics and analytics
  • • Library and purchase history
  • • Follower and subscription data
Content Creation
Programmatically create and manage content
  • • Upload and publish content
  • • Manage drafts and revisions
  • • Set pricing and availability
  • • Handle file attachments
Commerce
Handle purchases and payment processing
  • • Process purchases securely
  • • Manage payment methods
  • • Handle refunds and disputes
  • • Creator earnings and payouts
Analytics
Access detailed usage and performance data
  • • Content views and downloads
  • • Revenue and sales analytics
  • • User engagement metrics
  • • Trend analysis and insights
Webhooks
Real-time notifications for important events
  • • New purchases and downloads
  • • Content published or updated
  • • User account changes
  • • Payment and payout events

Getting Started (Preview)

Here's how easy it will be to start using the Ink and Anvil API.

1. Authentication

Secure API access using OAuth 2.0 or API keys for different use cases.

# Get your API token
curl -X POST https://api.inkandanvil.com/auth/token \
-H "Content-Type: application/json" \
-d '{"client_id": "your_id", "client_secret": "your_secret"}'
2. Fetch Content

Retrieve content with powerful filtering and pagination options.

# Search for spell content
curl -H "Authorization: Bearer your_token" \
"https://api.inkandanvil.com/v1/content?type=spell&sort=popular"
3. Create Content

Programmatically create and publish new D&D content.

# Create a new spell
curl -X POST https://api.inkandanvil.com/v1/content \
-H "Authorization: Bearer your_token" \
-H "Content-Type: application/json" \
-d '{"title": "Magic Missile", "type": "spell", ...}'

API Use Cases

Discover what you can build with the Ink and Anvil API.

Discord Bots

Create Discord bots that can search and share D&D content directly in your server.

  • • Spell lookup commands
  • • Random content generators
  • • Creator showcase features
  • • Purchase notifications
VTT Integrations

Integrate homebrew content directly into Virtual Tabletop platforms.

  • • Import spells and items
  • • Sync character options
  • • Auto-update content
  • • Creator attribution
Companion Apps

Build mobile apps that enhance the D&D experience with homebrew content.

  • • Character builders
  • • DM reference tools
  • • Content browsers
  • • Campaign managers
Analytics Tools

Create dashboards and analytics tools for creators and the community.

  • • Creator performance metrics
  • • Content trend analysis
  • • Market insights
  • • Community statistics

API Specification (Preview)

RESTful API with JSON responses and comprehensive documentation.

Endpoints Overview
GET/v1/content
POST/v1/content
GET/v1/content/{id}
PUT/v1/content/{id}
GET/v1/creators
GET/v1/creators/{id}
GET/v1/analytics
Response Format
// Successful response
{
"success": true,
"data": {...},
"pagination": {
"page": 1,
"limit": 20,
"total": 150
}
}
Rate Limits & Best Practices

Best Practices

  • • Use pagination for large datasets
  • • Cache responses when appropriate
  • • Handle rate limits gracefully
  • • Use webhooks for real-time updates
  • • Implement proper error handling

Rate Limits

  • Free Tier: 1,000 requests/hour
  • Creator Tier: 5,000 requests/hour
  • Business Tier: 25,000 requests/hour
  • Enterprise: Custom limits

Join the API Beta Program

Be among the first developers to access the Ink and Anvil API. Help us build something amazing for the D&D community.