Thanks to visit codestin.com
Credit goes to aidirectory.wiki

API Documentation

Integrate AI Directory's comprehensive database into your applications. Access tools, categories, and reviews through our RESTful API.

Quick Start

Get started with our API in minutes

Base URL

https://api.aidirectory.wiki/v1

Authentication

All API requests require an API key. Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get Your API Key

Sign up for a free account to get your API key and start building.

API Endpoints

Explore our comprehensive API endpoints

GET

/tools

Retrieve a list of AI tools with optional filtering and pagination.

Query Parameters

category Filter by category slug
search Search in name and description
pricing Filter by pricing model
page Page number (default: 1)
limit Items per page (default: 20)

Example Request

GET /v1/tools?category=writing&search=content&page=1&limit=10
GET

/tools/{slug}

Retrieve detailed information about a specific AI tool.

Path Parameters

slug Tool's unique slug identifier

Example Request

GET /v1/tools/chatgpt
GET

/categories

Retrieve a list of all available categories and subcategories.

Query Parameters

parent Filter by parent category
include_tools Include tool count (boolean)

Example Request

GET /v1/categories?include_tools=true

Response Format

All API responses follow a consistent JSON format

Success Response

{
  "success": true,
  "data": {
    "tools": [...],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 150,
      "pages": 8
    }
  },
  "message": "Tools retrieved successfully"
}

Error Response

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid",
    "details": "Please check your API key and try again"
  }
}

Rate Limits

Fair usage policies to ensure optimal performance for all users

๐Ÿ†“

Free Tier

1,000

requests per month

๐Ÿ’ผ

Pro Tier

50,000

requests per month

๐Ÿข

Enterprise

Unlimited

requests per month

Rate Limit Headers

Every API response includes rate limit information in the headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200

SDKs and Libraries

Official SDKs and community libraries for popular programming languages

๐Ÿ

Python

Official Python SDK

pip install aidirectory
๐ŸŸจ

JavaScript

Official Node.js SDK

npm install aidirectory
๐Ÿฆซ

Go

Official Go SDK

go get aidirectory

Need Help?

Our developer support team is here to help you integrate our API successfully.