API Documentation

Access the world's most comprehensive fashion intelligence database. Track what celebrities wear, analyze trends, and match products in real-time.

Quick Start

1

Get your API key

Sign up for an account and generate your API key from the dashboard.

2

Make your first request

Use your API key to fetch celebrity outfit data or product matches.

3

Build your application

Integrate AuraLens data into your fashion app, e-commerce platform, or analytics tool.

Authentication

All API requests require authentication using your API key. Include it in the Authorization header of every request.

# Example request with authentication
curl https://api.auralens.com/v1/creators/jennie-kim \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Keep your API key secure. Never expose it in client-side code or public repositories. Use environment variables and server-side requests only.

Rate Limits

Rate limits vary by plan tier. All responses include rate limit headers. 

# Response headers
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1643723400
Plan Requests/Hour Burst Limit
Free 100 10/min
Pro 1,000 50/min
Enterprise Unlimited Custom

Pricing

Pay only for what you use. All plans include access to our full API suite.

Volume discounts available. Contact sales for custom enterprise pricing and dedicated infrastructure.

Content Creators

Access comprehensive data on influencers, celebrities, and content creators across platforms.

GET /v1/creators $0.01/request

List all content creators with filtering and pagination support.

Query Parameters

Parameter Type Description
category string optional Filter by category (kpop, streamer, actor, etc.)
min_rank integer optional Minimum global rank (1-1000)
limit integer optional Number of results (default: 20, max: 100)
offset integer optional Pagination offset

Response Example

{
  "data": [
    {
      "id": "jennie-kim",
      "name": "Jennie Kim",
      "category": "K-POP / BLACKPINK",
      "stats": {
        "global_rank": 2,
        "outfits_indexed": 847,
        "monthly_searches": "2.4M",
        "avg_sellout_time": "48h"
      },
      "platforms": ["instagram", "youtube"],
      "avatar_url": "https://..."
    }
  ],
  "pagination": {
    "total": 1247,
    "limit": 20,
    "offset": 0
  }
}
GET /v1/creators/{id} $0.02/request

Get detailed information about a specific creator including recent outfits and trend data.

Path Parameters

Parameter Type Description
id string required Creator ID (e.g., "jennie-kim")

Shows & Movies

Access fashion data from K-dramas, movies, and TV shows.

GET /v1/shows $0.01/request

List all indexed shows and movies with metadata.

Response Example

{
  "data": [
    {
      "id": "cloy",
      "title": "Crash Landing on You",
      "year": 2019,
      "network": "tvN",
      "stats": {
        "outfits_indexed": 342,
        "characters": 8,
        "monthly_searches": "1.2M"
      },
      "genres": ["romance", "drama"]
    }
  ]
}
GET /v1/shows/{id}/outfits $0.03/request

Get all outfits from a specific show with episode and character information.

Characters

Access character-specific fashion data from shows and movies.

GET /v1/characters/{id} $0.02/request

Get detailed character profile including signature looks and style evolution.

Response Example

{
  "id": "yoon-seri",
  "name": "Yoon Se-ri",
  "show_id": "cloy",
  "actor": "Son Ye-jin",
  "style_profile": {
    "signature_brands": ["Chanel", "Hermès"],
    "avg_outfit_value": 4200,
    "dominant_colors": ["#1a1a1a", "#f5f5f5"]
  },
  "outfits_count": 87
}

Outfits

Access detailed outfit data with product breakdowns and purchase links.

GET /v1/outfits/{id} $0.03/request

Get complete outfit details including all products, pricing, and availability.

Response Example

{
  "id": "INF-001-IG-260128",
  "creator_id": "jennie-kim",
  "title": "Incheon Airport Departure",
  "date": "2026-01-28",
  "platform": "instagram",
  "products": [
    {
      "id": "PROD-00001",
      "category": "outerwear",
      "name": "Oversized Camel Wool Coat",
      "brand": "MaxMara",
      "price_usd": 450,
      "aura_score": 9.8,
      "inventory_status": "low_stock",
      "stores": [
        {
          "name": "Nordstrom",
          "price_usd": 450,
          "trust_score": 98,
          "shipping_days": 2,
          "url": "https://..."
        }
      ]
    }
  ],
  "total_value": 2580,
  "views": 12400
}

Products

Search and match products with visual AI and metadata filtering.

POST /v1/products/match $0.10/request

Upload an image and get matching products from our database using visual AI.

Request Body

{
  "image_url": "https://example.com/image.jpg",
  "confidence_threshold": 0.8,
  "max_results": 10
}
GET /v1/products/search $0.02/request

Search products by brand, category, price range, and other filters.

Webhooks

Receive real-time notifications when new outfits are indexed or products sell out.

Pro plan required. Webhooks are available on Pro and Enterprise plans only. 
# Example webhook payload
{
  "event": "outfit.created",
  "timestamp": "2026-02-04T06:22:00Z",
  "data": {
    "outfit_id": "INF-001-IG-260204",
    "creator_id": "jennie-kim"
  }
}

Error Handling

All errors follow a consistent format with HTTP status codes and detailed messages.

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 3600 seconds.",
    "status": 429,
    "retry_after": 3600
  }
}

Common Error Codes

Code Status Description
invalid_api_key 401 API key is missing or invalid
rate_limit_exceeded 429 Too many requests
resource_not_found 404 Requested resource does not exist
invalid_parameters 400 Request parameters are invalid