LSD
APIEndpoint 41 of 41Audits / Profile / Completeness & Optimization

Business Profile Health API

The profile health audit API for the new local SEO stack.

Profile health audits used to mean logging into BrightLocal, running a GBP audit, and manually comparing your profile to competitors. This is one POST call. Your agent gets a completeness score (0–100), list of missing fields (no hours, no description), incomplete fields (a too-short description), photo count, verification status, and specific optimization recommendations. All in structured JSON in 3–5 seconds.

POST /v1/profile/health · 5 credits / call

POST /v1/audit/profile-healthJoe's Pizza Brooklyn
Profile Health Score
78out of 100
Rankings25%82
Reviews30%91
Profile completeness25%67
Citation consistency20%74
▌ Ask your agent

These prompts are the new profile-health workflow.

Connect Local SEO Data as an MCP server once (60 seconds, below). Then your agent audits profile completeness on schedule. Replace bracketed business names with your own.

Pre-pitch profile health check

Pull the profile health score for [Joe's Pizza in Brooklyn, NY]. Show me their completeness score, what fields are missing (hours, categories, description), and what they should fix first to rank better.

Multi-location profile audit

Run profile health audits for all 12 client locations. Flag any location with a score below 85 or missing critical fields like business hours or primary photo.

Profile optimization roadmap

Pull the health score for [my business]. List every missing or incomplete field. Prioritize them by impact — which fixes will improve ranking the most?

Competitive profile intelligence

Compare profile health scores for [my business] vs my top 3 local competitors. Who has the most complete profile. What categories and attributes are they claiming that I'm missing.

▌ Real response

What you get back

Live response from POST /v1/profile/health for a sample Brooklyn pizzeria.

response · application/json~3–5s · 5 credits
{
  "status": "success",
  "credits_used": 5,
  "data": {
    "completeness_score": 86,
    "verified": true,
    "photos_count": 23,
    "missing_fields": [],
    "incomplete_fields": [
      "description"
    ],
    "recommendations": [
      "Add secondary categories for more visibility",
      "Expand your business description (aim for 250+ characters)"
    ]
  }
}
▌ Returns

The profile health metrics that matter for local rankings

Completeness score

0–100 score measuring profile optimization

Composite score reflecting how fully filled out the Google Business Profile is. Higher scores correlate with more clicks, more direction requests, and stronger local pack rankings.

Missing fields

Critical fields that are completely empty

List of fields your profile doesn't have: phone, address, business hours, categories or business description. Each empty field is a ranking signal you're leaving on the table.

Incomplete fields

Fields that are partially filled or suboptimal

Fields present but weak: a description of 50 characters or fewer. It earns half its points. A single category and fewer than 10 photos lower the score too, and come back as recommendations.

Photo count

How many photos the profile carries

Count of photos on the profile, a ranking signal. Under 10 adds a recommendation to add more. For Q&A, use POST /v1/business/qa.

Optimization recommendations

Actionable improvements ranked by ranking impact

Specific fixes for each gap: add hours, add secondary categories, expand the description, add photos. Written for agents and humans.

▌ Built for

What AI-native operators ship with this

Pre-pitch prospect profile audits

Before a sales call, pull a prospect's profile health score. Walk in knowing their completeness score, top 5 missing fields, and a ranked list of optimization wins. You'll know more about their profile than they do. Closing rate goes up.

→ For consultants

Monthly multi-location profile tracking

Agencies cron a monthly profile health audit across all client locations. Agent flags any location dropping below a 90 score, surfaces new missing fields, and drafts client recommendations. Built once, runs on schedule, scales to 100 locations.

→ For agencies

Profile optimization roadmap

Pull your profile health audit, rank the missing and incomplete fields by impact. Work through them systematically: fill hours, write the description, add secondary categories, add photos. Re-run the audit monthly to track the score.

→ Profile Health API

Competitive profile gap analysis

Pull profile health audits for yourself + top 3 local competitors monthly. See who's strengthening their profile (adding categories, photos and a fuller description) and who's falling behind. Use that to roadmap your own profile strategy.

→ Competitor Gap API
▌ vs. the alternatives

Why not just use BrightLocal, Whitespark, or Google's dashboard?

Dashboard-era profile audit tools (BrightLocal, Whitespark, Synup, Sprout Social, Reputation.com) charge $14–$49+ per month and are built for humans to log in and review reports. For agent workflows, multi-location audits, or scheduled profile intelligence, they're too slow and too expensive. Here's how the options stack up.

ApproachCost per auditSetupSpeedAgent-ready
Manual audit (Google dashboard only)1–2 hours labor per auditNone (log in)Manual, 30–60 minNo
BrightLocal GBP Audit$39+ /mo (~$1.30 per audit at 30/mo)Dashboard setup~5–10 min per reportCSV export only
Whitespark Profile Audit$24–$49 /mo (~$0.80–1.60 per audit)Dashboard + setup~5–10 min per reportManual export
Sprout Social Listings$249+ /mo, per-seatSetup + training~10–15 min per reportLimited API
Synup$199–$799 /moIntegration + training~5–10 min per reportLimited
Reputation.com$199+ /moIntegration + setup~5–10 min per reportLimited API
Local SEO Data Profile Health API$0.025 per auditAPI key + 1-line MCP config~3–5 secondsNative MCP, agent-first
▌ Connect in 60 seconds

Use it from your agent

Two integration surfaces: MCP for clients that speak MCP, REST API for everything else.

Direct MCP integration

Drop-in support in Claude Desktop, OpenClaw, Hermes Agent, and any MCP-aware client.

Add to your client's MCP config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "localseodata": {
      "url": "https://mcp.localseodata.com",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

REST API

For Perplexity Computer, ChatGPT Custom GPTs, custom agents, and any platform that calls REST endpoints directly.

Base URL:

api.localseodata.com

See the docs for endpoint reference and auth.

▌ Quickstart

Your first call in three lines

One call, three syntaxes. Pass business_name and location, or for exact matches use place_id. The endpoint returns a completeness score (0–100), list of missing and incomplete fields, photo count, verification status, and actionable recommendations. Place IDs are Google's canonical business identifiers — find any business's Place ID in Google Maps or use the /v1/maps endpoint.

terminal · curl
POST /v1/profile/health
curl -X POST https://api.localseodata.com/v1/profile/health \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Joe'"'"'s Pizza",
    "location": "Brooklyn, NY"
  }'
▌ Pricing for this endpoint

$0.025 per profile audit

Pay-as-you-go starts at $5. Monthly plans from $19. Funds never expire. No seat fees, ever.

Free tier
100
credits on signup (20 profile audits)
Starter · $19/mo
1,000
calls/mo at this rate
Per-call cost
$0.025
per profile health audit
▌ FAQ

Common questions

What is the Business Profile Health API?+
A REST endpoint that audits Google Business Profile completeness and returns a 0–100 health score, list of missing fields (business hours, categories, description), list of incomplete fields (description too short), photo count, verification status, and actionable optimization recommendations. One call costs 5 credits (~$0.025). This is the data layer underneath profile optimization workflows, pre-pitch audits, and multi-location compliance checks.
How is the profile health score calculated?+
Points come from what the profile itself shows: name, address and phone (20), hours (15), primary and secondary categories (15), description (10, half for 50 characters or fewer), and photos (10, full at 10 or more). Those 70 points are scaled to 0–100, so a complete profile scores 100. Review replies, Q&A and posts aren't in the profile data and aren't scored; use the reviews and Q&A endpoints for those. Every point lost shows up as a missing field, an incomplete field or a recommendation, so you can see exactly what to fix.
Why does profile completeness matter for local rankings?+
Google uses profile completeness as a ranking signal. Businesses with complete and fully optimized Google Business Profiles receive 7 times more clicks than those with incomplete listings, see 42% more direction requests, and get 35% more website clicks on average. Conversely, each missing field (no menu, no hours, no description) is a signal to Google that the business is inactive or unmanaged. Profile completeness carries an estimated 15–20% weight in Google's Relevance ranking factor for local pack results.
How does this compare to BrightLocal, Whitespark, and other dashboard tools?+
BrightLocal, Whitespark, Synup, Sprout Social Listings, and Reputation.com are dashboard-era profile audit tools designed for humans to log in and view reports. They cost $14–$49+ per month. The Profile Health API is designed for agents — your Claude prompt calls this endpoint, gets JSON, and acts on the result without a dashboard. Cost comparison: if you run 100 audits per month, BrightLocal costs you $39–90/month; the Profile Health API costs $2.50 total. If you're building agent workflows or need scheduled audits, this is the right tool. If you want a dashboard for your team to browse, those tools are better.
What fields does the profile health audit check?+
It checks business name, address, phone, regular hours, primary and secondary categories, business description, photo count and whether the profile is verified. Each gap is flagged as missing or incomplete, with a recommendation. It doesn't measure Q&A or posts: for Q&A use POST /v1/business/qa, and for reviews and reply rates use the reviews endpoints.
Can I use this for businesses I don't own?+
Yes — and this is the core use case for consultants, agencies, and competitive intelligence. Pull a profile health audit for a prospect before a sales call. You walk in knowing their completeness score, their top 5 missing fields, and what fixes would move the needle most. The API accepts any business name, address, and location, so you can audit competitors, prospects, or your own clients. This is standard practice in the industry — profile audits are how local SEO operators do discovery.
How fresh is the profile data?+
Profile data refreshes within approximately 24–48 hours of changes being made to a Google Business Profile (photos added, hours updated, description edited). Google Business Profile API documentation states that changes to verified business listings typically appear in search results within 24 hours. Because profile optimization is iterative (add a photo Monday, add hours Tuesday), run audits weekly during active optimization phases, monthly for maintenance tracking.
Where does this data come from?+
Profile health scores are derived from the business's public Google Business Profile data. We apply our own scoring logic to calculate the completeness score, identify missing/incomplete fields, and generate optimization recommendations. That scoring layer is why we're more opinionated than raw profile endpoints — we're not just returning Google data, we're analyzing it.
Can my AI agent use this directly?+
Yes. Two integration paths. MCP: add Local SEO Data to your claude_desktop_config.json and your Claude agent calls this endpoint from any prompt. REST: any agent that can make HTTPS calls — ChatGPT Custom GPTs, Perplexity Computer, custom Python agents — hits api.localseodata.com directly with the Bearer token. You don't write integration code. You write the prompt.
How does this work for multi-location businesses?+
Each call audits one business location (one business name + address combination). For multi-location clients, batch as many calls as you need — the API has no per-location cap beyond your credit balance. Agencies typically cron a monthly audit across every client location using a single Claude agent. The agent batches all locations in one run, surfaces locations with scores below a threshold, and flags new missing fields. Most efficient for agencies: one monthly agent run across all locations, agent surfaces only what needs attention.
What's the difference between missing fields and incomplete fields?+
Missing fields are empty: no phone, no hours, no category or no description. Incomplete fields are present but weak, such as a description of 50 characters or fewer. Photos under 10 and a single category show up as recommendations. Missing fields cost the most points, so fix those first.
Does this detect photo quality?+
No. It returns the photo count and recommends adding photos when there are fewer than 10. Pair it with the business profile endpoint to fetch the photos themselves if you want to judge them.
How often should I audit my profile health?+
It depends on the workflow. Quarterly for competitive baseline audits and prospect discovery. Monthly for client reporting and compliance checks. Weekly during active optimization (adding photos, filling hours, writing the description). Daily only if you're launching a major profile refresh and tracking changes hour-to-hour. Because pricing is per-call (not per-seat), there's no penalty for frequency beyond actual usage. Most agencies do a monthly sweep across all client locations, flag changes via agent, and surface only what needs human attention.
What changed in 2026 that made profile health audits necessary?+
Two things: MCP (Model Context Protocol) became standard, making it practical for agents to call specialized APIs without bespoke integration code. Second, profile optimization shifted from a dashboard task for humans to a signal for agents — agencies and consultants now need to pull profile audits as part of prospect discovery, client monitoring, and multi-location compliance workflows. Meanwhile, the dashboard era (BrightLocal, Whitespark) kept pricing tied to seats and monthly subscriptions, making bulk audits expensive. The API era lets you scale audits to 100 locations for $2.50 per month instead of $39+. Profile Health API is a native 2026 category.

Run your first profile health audit in 60 seconds.

100 free credits on signup. Your first profile audit happens through Claude, not curl.

▌ MADE FOR THE NEW LOCAL SEO STACK