Review Velocity

Track review count trends, rating changes, reply rates, and top sentiment themes over time for any business.

When to use this

You want to know if your review game is improving or falling behind. Are you getting more reviews each month? Is your rating going up or down? Are competitors getting reviews faster than you? This tells you all of that in one call.

POST/v1/reviews/velocity

Cost: 6 credits ($0.03)

Rate Limit: Varies by plan

Response: ~3-6 seconds

Parameters

Parameter	Type	Required	Description
business_name	string	Yes	Business name
location	string	Yes	City and state
period	string	No	"30d", "90d", "6m", "1y". Default: "90d"

Example Request

curl -X POST https://api.localseodata.com/v1/reviews/velocity \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"business_name": "Joe\'s Pizza", "location": "Brooklyn, NY", "period": "90d"}'

Example Response

JSON

{
  "status": "success",
  "credits_used": 6,
  "data": {
    "period": "90d",
    "reviews_per_month": 12.3,
    "rating_trend": "stable",
    "current_rating": 4.6,
    "reply_rate": 0.60,
    "sentiment_themes": {
      "positive": ["fast delivery", "great crust", "friendly staff"],
      "negative": ["weekend wait times", "small seating area"]
    },
    "velocity_vs_competitors": {
      "business_monthly": 12.3,
      "competitor_avg_monthly": 15.8,
      "gap": -3.5
    }
  }
}

Response Fields

Field	Type	Description
reviews_per_month	float	Average new reviews per month in the period
rating_trend	string	"improving", "stable", or "declining"
reply_rate	float	Percentage of reviews with owner replies (0-1)
sentiment_themes	object	Top positive and negative themes from review text
velocity_vs_competitors	object	Review velocity compared to local competitors

Notes

Reply rate above 90% correlates with higher ratings over time.
Use the velocity_vs_competitors field to show clients how they stack up.