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.polsia.app/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.polsia.app)"
}

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.polsia.app)"
}

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.polsia.app)"
}

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.