Medialane API — Getting Started

One REST API for all Starknet IP data. Get a key, make a request, and integrate in minutes.

Quick Start

1. 1

   Get your API key

   Sign in at /account and create a free API key from the portal dashboard. You can create up to 5 keys.

2. 2

   Make your first request

   bash

   curl https://medialane-backend-production.up.railway.app/v1/orders \
     -H "x-api-key: ml_live_YOUR_KEY"

3. 3

   Integrate in your app

   Use the @medialane/sdk for a typed client, or call the REST API directly from any language.

Authentication

All requests require an API key. Pass it in the x-api-key header:

curl https://medialane-backend-production.up.railway.app/v1/orders \
  -H "x-api-key: ml_live_YOUR_KEY"

# Bearer token also accepted:
# -H "Authorization: Bearer ml_live_YOUR_KEY"

API keys are prefixed ml_live_. Keep them secret — treat them like passwords.

Base URL

https://medialane-backend-production.up.railway.app

All endpoints are versioned under /v1/.

Response Format

All responses are JSON. Successful list responses wrap data in a data array with pagination in meta.

Success

{
  "data": [...],
  "meta": { "total": 128, "page": 1, "limit": 20 }
}

Error

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key"
}

Error Codes

Rate Limits

Portal management calls (/v1/portal/*) never count toward the monthly quota.

When you exceed a limit, you receive a 429 response. PREMIUM users see no monthly cap — only the per-minute rate limit applies.