API Docs — LocalSpy AI

🔑 API access requires an Agency plan. Generate your API key from Dashboard → Agency → API Keys. Keys are prefixed with lspy_

Authentication

All requests must include your API key as a Bearer token in the Authorization header.

HTTP Header

Authorization: Bearer lspy_your_api_key_here

POST /api/scan Find top competitors

Request Body

{"query": "plumber in Austin TX"}

Returns: top competitors with names, ratings, review counts, place IDs, and top reviews.

POST /api/analyze Deep Intel report

Request Body

{"placeId": "ChIJ...", "competitorName": "Austin Plumbing Co", "query": "plumber Austin TX"}

Returns: full intelligence report — weaknesses, negative reviews, ad strategies, steal scripts.

POST /api/keywords Keyword gap analysis

Request Body

{"niche": "dental clinic", "city": "Austin TX"}

Returns: 30+ keyword opportunities across 6 categories with opportunity scores.

POST /api/ad-intelligence Messaging intelligence

Request Body

{"competitorName": "Smith Dental", "city": "Austin TX", "yourBusinessType": "dental clinic"}

Returns: messaging pillars, emotional triggers, USPs, ad copy ideas, counter-positioning.

Code	Meaning
401	Invalid or missing API key
403	Feature requires Agency plan upgrade
404	Competitor not found on Google
429	Rate limit exceeded
500	Server error — please retry

❓ Need help with the API? Email support@localspyai.com with "API Support" in the subject.