Developer API

We're opening up parts of the platform so other tools serving small businesses can build on them. Free, rate-limited, no account required.

Available now

Industry benchmark segments

Returns model-generated customer segment estimates for a business type, optionally narrowed to a location. This is the same generation path used by Benchmark mode in the app.

MethodGETURL/api/v0/benchmark

Query parameters

Parameter	Required	Description
industry	Yes	One of: cafe, retail, salon, restaurant, home_services, fitness, consulting, ecommerce, trades, healthcare, creative, other.
location	No	Free-text city, region, or market to tailor the segments to (e.g. "Austin, TX").

Example request

curl "https://ai4smbhub.com/api/v0/benchmark?industry=cafe&location=Austin%2C%20TX"

Example response

{
  "industry": "cafe",
  "location": "Austin, TX",
  "result": {
    "summary": "Austin cafe customers split mainly into remote-working regulars and weekend social visitors, with a smaller but high-value group of specialty coffee enthusiasts.",
    "segments": [
      {
        "name": "Laptop Regulars",
        "percentage": 40,
        "color": "blue",
        "description": "Remote workers and freelancers who treat the cafe as a daytime office.",
        "characteristics": ["Visits on weekdays", "Stays 2+ hours", "Orders one drink, refills often"],
        "recommendations": ["Offer a weekday punch card", "Add reliable Wi-Fi and outlets as a stated amenity"],
        "propensityScore": "medium",
        "lifetimeValueTier": "medium",
        "intent": "A quiet, reliable place to work",
        "bestChannels": [
          { "channel": "instagram", "fit": "medium", "reason": "Visual proof of a laptop-friendly space" }
        ],
        "avoidChannels": [
          { "channel": "google", "reason": "Low intent to search for a workspace" }
        ],
        "messagingAngle": "Your desk away from your desk",
        "offerSuggestion": "Weekday 2-for-1 refill after 1pm",
        "toneGuidance": "Calm and practical",
        "reasoning": "Typical pattern for cafes near coworking and residential density in this market."
      }
    ],
    "quickWins": ["Post weekday hours and Wi-Fi availability on Google Business Profile"],
    "dataQuality": "This is a typical pattern for cafe businesses in Austin, TX, not a measurement of any specific business. Upload your own data for personalized segments. No customer data file was analyzed for this result, so segment sizes cannot be counted and the percentages are the model's estimates."
  },
  "meta": {
    "source": "model-generated",
    "note": "These segments are model-generated estimates for this business type and location. They are not computed from other businesses' data."
  }
}

Rate limited to 10 requests per hour per client. Exceeding it returns HTTP 429.

Planned

These are not available yet — they're on the roadmap for this API, with no dates set.

Segmentation from uploaded data

Planned

Planned. Submit your own customer data (CSV or similar) and receive the same kind of segment analysis the in-app Segment tool produces.

Campaign generation

Planned

Planned. Generate a full multi-channel campaign brief the way the in-app Generate tool does, from a single API call.

Post formatting

Planned

Planned. Reformat a piece of content for a specific channel's conventions and constraints.

Terms of use

•Free to use for tools and services that serve small businesses.
•Attribution to AI4SMB Insights is requested but not required.
•Requests are rate-limited; limits may change without notice.
•No guarantee of availability or uptime — this is a free, best-effort service.

Need higher limits, or building something?

Reach out and tell us what you're building.

info@ai4smbhub.com