⚡Quick Start

Infinite Craft API Documentation: Get Started in 5 Minutes

Start using the Infinite Craft API in minutes. This quick start guide will have you making your first API call and accessing Infinite Craft recipes programmatically in no time.

Get Your API Key

First, you'll need an API key to authenticate your requests. Contact us through our contact form to request access. We typically approve requests within 24 hours.

💡

Tip: Include information about your project and intended use case in your request. This helps us process your application faster.

Set Up Authentication

Once you have your API key, include it in the Authorization header of every request:

Authorization: Bearer YOUR_API_KEY

Never expose your API key in client-side code or public repositories. Always use environment variables or secure configuration management.

Make Your First Request

The most common endpoint is /api/merge, which combines two items. Here's how to use it:

JavaScript Example

const response = await fetch(
  'https://nonstopcraft.com/api/merge?itemA=fire&itemB=water',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const result = await response.json();
console.log(result);
// { name: 'steam', icon: '💨', isNew: false }

Python Example

import requests

response = requests.get(
    'https://nonstopcraft.com/api/merge',
    params={'itemA': 'fire', 'itemB': 'water'},
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

result = response.json()
print(result)
"color: #676e95;"># {'name': 'steam', 'icon': '💨', 'isNew': False}

cURL Example

curl -X GET \
  "https://nonstopcraft.com/api/merge?itemA=fire&itemB=water" \
  -H "Authorization: Bearer YOUR_API_KEY"

Understand the Response

The API returns a JSON object with three fields:

name:The name of the resulting item (e.g., "steam")
icon:The emoji representing the item (e.g., "💨")
isNew:Boolean indicating if this combination was just discovered (true) or already existed (false)

Explore More Endpoints

Now that you've made your first call, explore other endpoints:

GET /api/database

Retrieve all crafting combinations. Supports optional search parameter.

GET /api/crafts/by-result

Find all recipes that produce a specific item.

GET /api/database/batch

Fetch multiple crafts efficiently with pagination.

GET /api/game/random-craft

Get a random craft for game mode challenges.

Common Use Cases

Recipe Finder

Use /api/crafts/by-result to find all ways to craft a specific item. Perfect for building recipe lookup tools.

Crafting Calculator

Build a tool that calculates the shortest path to craft any item by recursively calling /api/merge.

Data Export

Use /api/database to export all recipes to CSV, JSON, or your preferred format.

Ready for More?

Check out our complete API documentation for detailed endpoint descriptions, error handling, rate limits, and advanced features.

Full Documentation Complete Developer Guide