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
/directoriesRetrieves 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/listingsRetrieves 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/listingsCreates 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.