API Documentation

Integrate Parlexa's enterprise AI directory and real-time vendor analytics directly into your workflows.

Authentication

All API requests require an active Bearer token. Vendor endpoints are strictly protected by Supabase Row Level Security (RLS) to ensure you can only access analytics and data for tools you own.

Authorization: Bearer YOUR_API_KEY

Core Endpoints

Get/api/v1/agents

Retrieve a paginated list of all globally approved AI agents in the directory. You can filter by category, pricing model, or deployment complexity.

Post/api/v1/vendor/tools

Submit a new AI tool for review. Note: Tools submitted via the API are automatically assigned a pending status. If you update an existing approved tool, its status will temporarily revert to pending until administratively cleared.

Get/api/v1/vendor/analytics

Fetch your zero-latency interaction metrics. This endpoint returns aggregated cta_click (Top-of-Funnel Visits) and lead_capture (Saves/Bookmarks) events over a rolling 30-day window.

Rate Limits & Architecture

Client-Side Throttling: To prevent duplicate analytics logging, interaction endpoints enforce a strict 2000ms client-side execution lock.
API Limits: Standard API requests are limited to 100 requests per minute per authenticated IP address. Exceeding this limit will trigger a 429 Too Many Requests response.

Example Request

fetch-analytics.ts

const fetchMetrics = async () => {
  const response = await fetch('https://parlexa.in/api/v1/vendor/analytics', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  });

  const data = await response.json();
  console.log(data);
  // { clicks: 1240, leads: 84, status: 200 }
};