Skip to content
v1.0.0
Stable

API Reference

Programmatically interact with your directory data using our REST API.

Authentication

All API requests must be authenticated using a Bearer Token. You can generate an API key in your dashboard settings.

Authorization: Bearer YOUR_API_KEY

Base URL

https://api.directories.ai/v1

Endpoints

GET
/directories
List all directories

Retrieves a list of all directories belonging to your organization.

[
  {
    "id": "dir_123456789",
    "name": "AI Tools Directory",
    "slug": "ai-tools",
    "created_at": "2023-11-19T12:00:00Z"
  }
]
GET
/directories/:id/listings
List listings

Retrieves a paginated list of listings for a specific directory.

Query Parameters

page
integer
Page number (default: 1)
limit
integer
Items per page (default: 20)
POST
/directories/:id/listings
Create listing

Creates a new listing in the specified directory.

{
  "title": "New AI Tool",
  "description": "A revolutionary AI tool...",
  "website_url": "https://example.com",
  "category": "Productivity"
}

Need Client Libraries?

We provide official SDKs for TypeScript, Python, and Go.