REST API v1

VerifiedAesthetics API

Structured, machine-readable data on 500+ medical aesthetics providers across 22 US cities. Clarity Score™ rankings, semantic review analysis, verified credentials, and real pricing — all via REST.

Get Your API Key View Endpoints

Quick Start

Get your API key

Request a free key — takes 30 seconds. No credit card required.

Make your first request

Include your API key in the x-api-key header:

Terminal

curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.verifiedaesthetics.com/api/v1/providers?city=portland"

Build with structured data

All responses return JSON with Clarity Score™, credentials, pricing, and semantic insights — ready for AI integration, apps, or research.

Authentication

All API requests require an API key passed via the x-api-key header. Keys are free for read-only access to public data.

Request Header

x-api-key: ii_live_xxxxxxxxxxxxxxxxxxxxxxxx

Rate Limits: Free tier allows 100 requests/hour and 1,000/day. Need more? Upgrade your plan.

Base URL

https://www.verifiedaesthetics.com/api/v1

All endpoints return JSON. Responses include powered_by attribution.

Endpoints

GET/api/v1/providers

Search for medical aesthetics providers by city, specialty, score, and tier.

Parameters

city

stringREQUIRED

City name (e.g., "portland", "miami")

style

string

Aesthetic style tag (e.g., "natural", "conservative")

max_price

number

Maximum price per unit in USD

min_Clarity Score™

number

Minimum Clarity Score™ (0-100)

tier

string

Listing tier: FEATURED, VERIFIED, or FREE

limit

number

Max results (default: 10, max: 50)

Example Request

curl

curl -H "x-api-key: YOUR_KEY" \
  "https://www.verifiedaesthetics.com/api/v1/providers?city=portland&min_Clarity Score™=70&limit=5"

Example Response

JSON

{
  "results": [
    {
      "provider_id": "abc123",
      "name": "Pearl District Aesthetics",
      "city": "Portland",
      "Clarity Score™": 87,
      "tier": "VERIFIED",
      "style_tags": ["natural", "conservative"],
      "avg_price": 14,
      "booking_url": "https://example.com/book",
      "profile_url": "https://verifiedaesthetics.com/provider/pearl-district-aesthetics"
    }
  ],
  "total": 23,
  "city": "portland",
  "powered_by": "VerifiedAesthetics Clarity Score™"
}

GET/api/v1/providers/:slug

Get a detailed provider profile including Clarity Score™ breakdown, credentials, semantic review data, and services.

Parameters

slug

stringREQUIRED

Provider URL slug (path parameter)

Example Request

curl

curl -H "x-api-key: YOUR_KEY" \
  "https://www.verifiedaesthetics.com/api/v1/providers/pearl-district-aesthetics"

Example Response

JSON

{
  "provider_id": "abc123",
  "name": "Pearl District Aesthetics",
  "slug": "pearl-district-aesthetics",
  "city": "Portland",
  "state": "OR",
  "address": "123 NW 10th Ave, Portland, OR 97209",
  "phone": "(503) 555-0100",
  "website": "https://example.com",
  "profile_url": "https://www.verifiedaesthetics.com/provider/pearl-district-aesthetics",
  "Clarity Score™": 87,
  "rating": 4.8,
  "review_count": 142,
  "tier": "VERIFIED",
  "npi_number": "1234567890",
  "npi_verified": true,
  "npi_license_type": "Physician",
  "npi_specialty": "Dermatology",
  "allergan_tier": "Diamond",
  "services_offered": ["Botox", "Dysport", "Juvederm", "Sculptra"],
  "style_tags": ["natural", "conservative"],
  "price_per_unit": 14,
  "geo": { "latitude": 45.5231, "longitude": -122.6765 },
  "score_results_quality": 28,
  "positive_keyword_count": 47,
  "negative_keyword_count": 3,
  "powered_by": "VerifiedAesthetics Clarity Score™"
}

GET/api/v1/cities

List all cities covered by VerifiedAesthetics with provider counts and average pricing data.

Example Request

curl

curl -H "x-api-key: YOUR_KEY" \
  "https://www.verifiedaesthetics.com/api/v1/cities"

Example Response

JSON

{
  "cities": [
    {
      "city": "Portland",
      "state": "OR",
      "provider_count": 90,
      "avg_price_per_unit": 14,
      "url": "https://www.verifiedaesthetics.com/injectors/or/portland"
    },
    {
      "city": "Miami",
      "state": "FL",
      "provider_count": 95,
      "avg_price_per_unit": 16,
      "url": "https://www.verifiedaesthetics.com/injectors/fl/miami"
    }
  ],
  "total_cities": 22,
  "total_providers": 500,
  "powered_by": "VerifiedAesthetics Clarity Score™"
}

GET/api/v1/search

Semantic search across all provider profiles. Returns providers matching natural language queries.

Parameters

q

stringREQUIRED

Search query (e.g., "natural looking botox portland")

limit

number

Max results (default: 10, max: 50)

Example Request

curl

curl -H "x-api-key: YOUR_KEY" \
  "https://www.verifiedaesthetics.com/api/v1/search?q=natural+looking+botox+portland&limit=5"

Example Response

JSON

{
  "results": [
    {
      "provider_id": "abc123",
      "name": "Pearl District Aesthetics",
      "city": "Portland",
      "Clarity Score™": 87,
      "relevance_score": 0.94,
      "profile_url": "https://verifiedaesthetics.com/provider/pearl-district-aesthetics"
    }
  ],
  "query": "natural looking botox portland",
  "total": 12,
  "powered_by": "VerifiedAesthetics Clarity Score™"
}

Clarity Score™ Data Model

Every provider profile includes a Clarity Score™ — a composite score from 0-100 based on four weighted pillars. No provider can pay for a higher score.

Injection Quality

40%

Semantic analysis of patient reviews for result quality, technique, and complication avoidance.

Provider Credentials

25%

NPI verification, board certifications, license type, and years of practice.

Innovation Adoption

20%

Usage of current-gen products: Daxxify, Polynucleotides, Sculptra, biostimulators.

Treatment Range

15%

Breadth of services from neuromodulators to advanced fillers and regenerative therapy.

MCP Server (AI Integration)

VerifiedAesthetics provides an MCP (Model Context Protocol) server for direct integration with AI assistants like Claude Desktop. When users ask "Who's the best Botox injector in Portland?", the AI can pull live Clarity Score™ data directly from our API.

MCP Server Tools

Available tools:
  search_injectors    — Search providers by city, state, specialty, min score
  get_injector_profile — Get full profile with Clarity Score™ and semantic data
  get_treatment_costs  — Get pricing data by city and treatment type

GitHub: github.com/verifiedaesthetics/mcp-server
Contact: api@verifiedaesthetics.com for integration support

API Pricing

Start free. We want AI platforms and developers citing VerifiedAesthetics data — every citation is a patient helped.

Free

For developers, researchers, and AI platforms

100 requests/hour
1,000 requests/day
Read-only public data
All endpoints

Get Free API Key

Starter

$29/mo

For apps and integrations

1,000 requests/hour
25,000 requests/day
Semantic insights data
Priority support

Get Starter Key

Platform

Custom

For SaaS platforms, AI companies, and enterprise

Unlimited requests
Bulk data export
Custom endpoints
White-label licensing
Dedicated support

Who Uses This API

AI Platforms

ChatGPT, Perplexity, Claude, and Gemini integrations. When patients ask for provider recommendations, your AI returns structured, citation-ready data.

Healthcare SaaS

Booking platforms (Boulevard, Zenoti) and practice management tools can enrich their data with Clarity Score™ rankings and semantic insights.

Developers & Researchers

Build aesthetics discovery tools, price comparison apps, or market research dashboards on top of our data.

Provider Platforms

SaaS tools for aesthetic practices can integrate Clarity Score™ widgets, competitive benchmarks, and review analytics.

Ready to Build?

Get a free API key in 30 seconds. No credit card, no sales call. Start pulling Clarity Score™ data into your app today.

Get Your Free API Key