API Documentation

Build with Verified Directory

Access trusted, verified business data through our REST API. Structured for humans and AI agents alike.

Verified Data
All businesses go through our moderation and verification process. Trust scores and verification status included.
Structured Data
Clean, normalized JSON responses with explicit fields, enums, and machine-readable metadata.
AI-Ready
Designed for AI consumption with semantic fields, AI-generated summaries, and MCP tool compatibility.
API Reference
Base URL: https://api.verifieddirectory.com

Public endpoints require no authentication. Rate limited to 100 requests/minute. Only returns approved and published businesses.

GET
/v1/businesses

List all published businesses with pagination and filtering

Public
GET
/v1/businesses/{id}

Get a specific business by ID

Public
GET
/v1/businesses/slug/{slug}

Get a business by URL slug

Public
GET
/v1/businesses/featured

Get curated featured businesses - verified and hand-picked

Public
GET
/v1/businesses/nearby

Find businesses near a lat/lng coordinate with radius

Public
GET
/v1/search

Search businesses by keyword, category, or location

Public
GET
/v1/categories

List all available categories

Public
GET
/v1/categories/{slug}/businesses

Get all businesses in a specific category

Public
GET
/v1/locations

List featured locations

Public
GET
/v1/stats

Directory statistics - totals, verification rates, top categories

Public
GET
/v1/health

API health check endpoint

Public
GET
/v1/businesses/by-zip

Find businesses by ZIP/postal code

Public
GET
/v1/businesses/by-region

Find businesses by region, metro area, or state (smart matching)

Public
GET
/v1/businesses/trending

Get trending businesses based on recent activity

Public
GET
/v1/businesses/open-now

Find businesses currently open based on their hours

Public
GET
/v1/businesses/random

Get random verified businesses for discovery

Public
GET
/v1/autocomplete

Smart autocomplete - businesses, categories, and locations

Public
GET
/v1/reports/industry

Industry/category insights and statistics

Public
GET
/v1/reports/geographic

Geographic coverage and density insights

Public
Example Response
GET /v1/businesses/biz_01h8x9y2z3
{
  "id": "biz_01h8x9y2z3",
  "slug": "acme-technologies",
  "legal_name": "Acme Technologies Inc.",
  "display_name": "Acme Technologies",
  "description_short": "Leading provider of innovative tech solutions",
  "categories": [
    "Technology",
    "Software"
  ],
  "tags": [
    "saas",
    "enterprise",
    "ai"
  ],
  "city": "San Francisco",
  "state": "CA",
  "country": "US",
  "verification_status": "verified",
  "publication_status": "published",
  "ai_summary": "Acme Technologies is a leading software company...",
  "ai_keywords": [
    "technology",
    "software",
    "innovation"
  ],
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-02-20T14:45:00Z"
}
Status Enums
Standard status values across the API

verification_status

unverifiedpendingpartially_verifiedverifiedfailedrevoked

publication_status

unpublishedpublishedhiddensuspendedarchived

moderation_status

draftpending_reviewin_reviewapprovedrejectedflagged
Data Safety
What the public API exposes
Only approved + published listings
No internal admin notes
No user PII or private data
Verification status is public
AI-generated summaries included

Ready to Integrate?

Get your API key and start building with verified business data today.