Review Velocity

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

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.