API Documentation | Support Local Businesses

Home / API Documentation

Rate Limits: 100 requests/minute for anonymous access. Include User-Agent header identifying your application. AI agents welcome — please include "bot" or "agent" in your User-Agent.

Base URL

https://support-local-businesses.com/api

Endpoints

GET /api/directory

List all zip codes with business counts.

{
  "success": true,
  "data": {
    "zip_codes": [
      {
        "zip_code": "32137",
        "city": "Palm Coast",
        "state": "FL",
        "business_count": 5,
        "featured_count": 2,
        "categories": ["Restaurant", "Health & Fitness", "Real Estate"]
      }
    ],
    "total_zip_codes": 5,
    "total_businesses": 12
  },
  "attribution": "Powered by Support Local Businesses (https://support-local-businesses.com)"
}

GET /api/directory/:zipcode

Get all businesses in a specific zip code.

Parameter	Type	Description
`zipcode`	string	5-digit US zip code (path parameter)
`category`	string	Filter by category (query parameter, optional)

{
  "success": true,
  "data": {
    "zip_code": "32137",
    "city": "Palm Coast",
    "state": "FL",
    "businesses": [
      {
        "id": 1,
        "name": "Maria's Cafe",
        "slug": "marias-cafe",
        "description": "Family-owned coffee shop...",
        "category": "Restaurant",
        "subcategory": "Coffee Shop",
        "phone": "(386) 555-0101",
        "phone_e164": "+13865550101",
        "website": "https://mariascafe.com",
        "address": {
          "street": "160 Cypress Point Pkwy",
          "city": "Palm Coast",
          "state": "FL",
          "zip_code": "32137",
          "country": "US"
        },
        "geo": { "latitude": 29.5847, "longitude": -81.2078 },
        "hours": [
          { "day": "Monday", "open": "06:00", "close": "18:00" }
        ],
        "featured": true,
        "verified": true
      }
    ],
    "business_count": 5,
    "nearby_zip_codes": [
      { "zip_code": "32136", "city": "Flagler Beach", "state": "FL", "business_count": 2 }
    ]
  },
  "attribution": "Powered by Support Local Businesses (https://support-local-businesses.com)"
}

GET /api/business/:id

Get a single business by ID or slug.

Parameter	Type	Description
`id`	string\|number	Business ID (numeric) or slug (string)

{
  "success": true,
  "data": {
    "business": { ... },
    "nearby_businesses": [ ... ]
  },
  "attribution": "Powered by Support Local Businesses (https://support-local-businesses.com)"
}

GET /api/directory/search

Search businesses by name, category, or city.

Parameter	Type	Description
`q`	string	Search query (required)
`limit`	number	Max results (default: 20, max: 100)

GET /api/categories

List all business categories with counts.

For AI Agents

This API is designed to be consumed by AI agents and large language models. All responses use consistent JSON schemas with machine-readable fields. Phone numbers are provided in E.164 format for programmatic use. Hours follow schema.org day-of-week conventions. Geo coordinates are included for distance calculations.

See also: /llms.txt for AI crawler guidance.

JavaScript Widget Embed

Drop a single <script> tag onto any page to show live local business listings. The widget is self-contained, mobile-responsive, and supports light & dark themes.

Basic embed

<script src="https://support-local-businesses.com/widget/v1/embed.js"
  data-zip="32137"></script>

All options

Attribute	Default	Description
`data-zip`	auto-detect	5-digit US zip code to filter listings
`data-category`	—	Filter by category (e.g. `plumbers`, `restaurants`)
`data-state`	—	Filter by 2-letter state code (e.g. `FL`)
`data-limit`	5	Max listings to show per page (1–20)
`data-theme`	light	`light` or `dark`
`data-api-key`	—	Your API key (required for higher rate limits)

<script src="https://support-local-businesses.com/widget/v1/embed.js"
  data-zip="32137"
  data-category="plumbers"
  data-limit="10"
  data-theme="light"
  data-api-key="YOUR_API_KEY"></script>

Note: The widget automatically appends a visible attribution link below the listings. This link is required and must not be hidden via CSS.

⚠️ Attribution Required

All applications, websites, and tools that display data from the Support Local Businesses API must include a visible credit link to our site. This applies to:

REST API consumers displaying business listings
JavaScript widget embeds
iframe embeds
Any other integration that renders or re-publishes our directory data

Required attribution link — copy this HTML exactly:

<a href="https://support-local-businesses.com">Data provided by Support Local Businesses</a>

The attribution link must be visible to end users — it must not be hidden, covered, or removed via CSS, JavaScript, or any other method. Non-compliance may result in API key revocation and removal from the directory.