Checking auth...

API Reference

The Livepedia API provides programmatic access to real-world merchant data, including business information, service catalogs, real-time availability, and aggregated reviews from multiple sources.

Base URL

https://www-staging.livepedia.ai/api

Real-time Data

Live availability and up-to-date merchant information

Source-Traceable

All data timestamped with source attribution

Unified API

Single endpoint for multiple data sources

Authentication

All API requests require authentication. Include your API key (shown above) in the request header:

http
API-Key: lvpd_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

MCP Server Configuration

Configure your MCP client (Cursor / VS Code) to access Livepedia API:

json
{
  "mcpServers": {
    "livepedia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www-staging.livepedia.ai/api/mcp",
        "--header",
        "API-Key: {LIVEPEDIA_API_KEY}"
      ],
      "env": {
        "LIVEPEDIA_API_KEY": "lvpd_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Search Endpoint

POST/search

A single powerful endpoint that returns comprehensive merchant data. Ask natural language questions about availability, prices, ratings, locations, amenities, and more.

One Endpoint, All Data

Returns complete merchant profiles including services, availability, ratings, AI-generated insights, and social signals — all from a single API call.

Request Body

Parameter	Type	Required	Description
`query`	string	Required	Natural language question about merchants, services, availability, pricing, or amenities

Example Query

text

"spa with massage in San Francisco with free parking"

Example Request

bash
curl -X POST "https://www-staging.livepedia.ai/api/sql-agent/search"   -H "API-Key: lvpd_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"   -H "Content-Type: application/json"   -d '{"query":"spa with massage in San Francisco with free parking"}'

Example Response

json
{
  "success": true,
  "data": [
    {
      "merchant_id": "mer_abc123",
      "name": "Bella Vista Spa & Wellness",
      "address": "123 Market St, San Francisco, CA 94103",
      "phone": "+1-415-555-0123",
      "website": "https://bellavistaspa.com",
      "rating": {
        "average": 4.6,
        "count": 613,
        "sources": {
          "google": {
            "rating": 4.7,
            "count": 324
          },
          "yelp": {
            "rating": 4.5,
            "count": 289
          }
        }
      },
      "ai_overview": [
        {
          "insight": "Located on the 3rd floor - elevator access available",
          "source": "Google Reviews"
        },
        {
          "insight": "Free parking available in building garage. Bring ticket for validation",
          "source": "Yelp Reviews"
        },
        {
          "insight": "Accepts cash and all major credit cards",
          "source": "Merchant Info"
        }
      ],
      "services": [
        {
          "id": "srv_xyz789",
          "name": "Deep Tissue Massage",
          "price": 120,
          "duration": 60,
          "currency": "USD"
        }
      ],
      "availability": [
        {
          "date": "2025-12-25",
          "slots": [
            {
              "time": "09:00",
              "available": true
            },
            {
              "time": "10:00",
              "available": true
            },
            {
              "time": "11:00",
              "available": true
            }
          ]
        }
      ],
      "reviews": [
        {
          "source": "google",
          "author": "Sarah M.",
          "rating": 5,
          "text": "Amazing experience! Professional staff.",
          "date": "2024-11-10"
        }
      ],
      "last_updated": "2025-12-24T10:30:00Z"
    },
    {
      "merchant_id": "mer_def456",
      "name": "Serenity Wellness Center",
      "address": "456 Mission St, San Francisco, CA 94105",
      "phone": "+1-415-555-0456",
      "website": "https://serenitywellness.com",
      "rating": {
        "average": 4.8,
        "count": 892,
        "sources": {
          "google": {
            "rating": 4.9,
            "count": 512
          },
          "yelp": {
            "rating": 4.7,
            "count": 380
          }
        }
      },
      "ai_overview": [
        {
          "insight": "Street parking available, metered until 6pm",
          "source": "Google Reviews"
        },
        {
          "insight": "Walk-ins welcome, but reservations recommended",
          "source": "Yelp Reviews"
        }
      ],
      "services": [
        {
          "id": "srv_abc456",
          "name": "Swedish Massage",
          "price": 100,
          "duration": 60,
          "currency": "USD"
        },
        {
          "id": "srv_abc789",
          "name": "Hot Stone Massage",
          "price": 140,
          "duration": 90,
          "currency": "USD"
        }
      ],
      "availability": [
        {
          "date": "2025-12-25",
          "slots": [
            {
              "time": "13:00",
              "available": true
            },
            {
              "time": "14:00",
              "available": true
            },
            {
              "time": "15:00",
              "available": true
            }
          ]
        }
      ],
      "reviews": [
        {
          "source": "google",
          "author": "Michael T.",
          "rating": 5,
          "text": "Best massage in SF! Very relaxing atmosphere.",
          "date": "2024-12-01"
        }
      ],
      "last_updated": "2025-12-24T10:45:00Z"
    }
  ],
  "total": 2
}