Competitor Gap Report

Compare a business against its top 5 local competitors on rankings, review count, rating, profile completeness, and primary category. One call returns the full competitive landscape.

POST/v1/report/competitor-gap

Cost: 10 credits ($0.05)

Rate Limit: Varies by plan

Response: ~4-8 seconds

Parameters

Parameter	Type	Required	Description
business_name	string	Yes	Business name to analyze
location	string	Yes	City and state
keyword	string	No	Primary keyword. Auto-detected if omitted
competitors	integer	No	Number of competitors. Default: 5, max: 10

Example Request

curl -X POST https://api.localseodata.com/v1/report/competitor-gap \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"business_name": "Joe\'s Pizza", "location": "Brooklyn, NY", "keyword": "pizza"}'

Example Response

JSON

{
  "status": "success",
  "credits_used": 10,
  "data": {
    "business": {
      "name": "Joe's Pizza",
      "local_pack_rank": 2,
      "rating": 4.6,
      "reviews": 847,
      "profile_completeness": 78
    },
    "competitors": [
      {
        "name": "Brooklyn Pizza Co.",
        "local_pack_rank": 1,
        "rating": 4.8,
        "reviews": 1203,
        "profile_completeness": 95,
        "advantages": ["More reviews", "Higher rating", "Complete profile"]
      },
      {
        "name": "Sal's Famous Slice",
        "local_pack_rank": 3,
        "rating": 4.5,
        "reviews": 632,
        "profile_completeness": 82,
        "advantages": ["Fewer reviews", "Lower rating"]
      }
    ],
    "gaps": [
      "Review count: 356 fewer than #1 competitor",
      "Profile completeness: 17 points below top competitor",
      "Missing: menu link, recent photos (last upload 4 months ago)"
    ]
  }
}

Response Fields

Field	Type	Description
business	object	Target business summary with rank, rating, reviews, profile score
competitors	array	Top competitors with the same metrics and advantages list
gaps	string[]	Specific gaps between the business and top competitors

Notes

Great for client onboarding — show prospects exactly where they stand.
Combine with geogrid-scan to understand geographic competitive dynamics.