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.