API Access & Documentation

Integrate DirConnect's comprehensive business directory into your application. RESTful, JSON-driven, and developer-friendly.

BASE: https://api.dirconnect.com/v1
🔑 API Key Management

Include your API key in every request header: X-API-Key: your_key_here

🚀 Quick Start Guide
  1. Generate an API key from the dashboard above.
  2. Attach it to the X-API-Key header in your requests.
  3. All responses are returned as JSON. Errors follow standard HTTP status codes.
  4. Rate limits are enforced per key. Monitor your usage in the developer console.

Authentication: Bearer Token & API Key supported. All endpoints require HTTPS.

📡 Available Endpoints
Method Endpoint Description
GET /categories Retrieve all available business categories with IDs.
GET /businesses List businesses with pagination, filtering & sorting.
GET /businesses/:id Fetch detailed profile for a specific business.
POST /search Full-text search across listings, supporting geo & category filters.
GET /reviews?business_id=:id Get paginated customer reviews with sentiment scores.
💻 Code Examples
# GET /businesses?page=1&limit=10 curl -X GET "https://api.dirconnect.com/v1/businesses?page=1&limit=10" \ -H "X-API-Key: drc_live_sk_8f7g6h5j4k3l2m1n" \ -H "Accept: application/json"
// Fetch businesses using Fetch API const response = await fetch( 'https://api.dirconnect.com/v1/businesses?page=1', { headers: { 'X-API-Key': 'drc_live_sk_8f7g6h5j4k3l2m1n', 'Accept': 'application/json' } } ); const data = await response.json(); console.log(data.results);
# Python requests example import requests headers = { "X-API-Key": "drc_live_sk_8f7g6h5j4k3l2m1n", "Accept": "application/json" } response = requests.get( "https://api.dirconnect.com/v1/businesses", params={"page": 1, "limit": 10}, headers=headers ) data = response.json() print(data["results"])
📊 Rate Limits & Tiers

100

Requests / Minute (Free)

1,000

Requests / Minute (Pro)

50 MB

Max Payload Size

99.9%

Uptime SLA

API Key copied to clipboard!