Keyword Opportunities

Discover the top 10 local keywords with search difficulty, competitor rankings, and whether the target business currently appears for each keyword.

POST/v1/keywords/local-opportunities

Cost: 4 credits ($0.02)

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
category	string	No	Business category to expand keywords beyond primary

Example Request

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

Example Response

JSON

{
  "status": "success",
  "credits_used": 4,
  "data": {
    "keywords": [
      { "keyword": "pizza brooklyn", "difficulty": 42, "your_rank": 2, "top_competitor": "Brooklyn Pizza Co.", "competitor_rank": 1 },
      { "keyword": "pizza delivery brooklyn", "difficulty": 38, "your_rank": null, "top_competitor": "Domino's", "competitor_rank": 1 },
      { "keyword": "best pizza nyc", "difficulty": 78, "your_rank": 8, "top_competitor": "Di Fara Pizza", "competitor_rank": 1 },
      { "keyword": "late night pizza brooklyn", "difficulty": 22, "your_rank": null, "top_competitor": "L&B Spumoni", "competitor_rank": 2 }
    ]
  }
}

Response Fields

Field	Type	Description
keyword	string	Local search keyword
difficulty	integer	Estimated difficulty score (0-100)
your_rank	integer \| null	Business's current rank (null = not ranking)
top_competitor	string	Top-ranking competitor for this keyword
competitor_rank	integer	Top competitor's rank

Notes

Keywords with your_rank = null are opportunities where you don't yet rank.
Low difficulty + null rank = quick wins for local content and GBP optimization.