API Reference

Programmatic data access with integrated payments

Base URL

https://api.redpine.ai

Authentication

X-API-Key: YOUR_KEY

Credit System

1,000 credits = $1.00

Getting Started

Get up and running in minutes

Get an API Key: Sign up at developer.redpine.ai to create an account and generate your API key
Purchase Credits: Buy prepaid credits ($1 = 1,000 credits) through the dashboard
Make Your First Query: Use the Query Data endpoint to search for data
Complete Checkout: Pay for data access using credits, Stripe, or Solana
Access Data: Use the access token to retrieve your purchased data

Endpoints

GET

/api/v1/dashboard/credits/balance

Get Credit Balance

Get your current credit balance and last update time.

No parameters required

Request

import requests

response = requests.get(
    "https://api.redpine.ai/api/v1/dashboard/credits/balance",
    headers={"X-API-Key": "YOUR_API_KEY"}
)
balance = response.json()
print(f"Balance: {balance['current_balance']} credits")

Response

{
  "current_balance": 5000.0,
  "last_updated": "2025-01-24T10:00:00Z"
}

POST

/api/v1/acp/queries

Query Data

Query RAG data with cost estimation and caching. Supports filtering by category, publisher, and date range.

Parameters

query

required

Type: string

Search query for context retrieval

k

optional

Type: integer

Number of chunks to retrieve (default: 5)

alpha

optional

Type: float

RRF ranking weight 0.0-1.0 (default: 0.7)

category

optional

Type: string

Category filter (legal, medical, educational)

publisher

optional

Type: string

Publisher name to filter results by

date_range

optional

Type: array[string]

Date range filter as [start_date, end_date]. Formats: YYYY-MM-DD, YYYY/MM/DD, YYYYMMDD

Request

import requests

response = requests.post(
    "https://api.redpine.ai/api/v1/acp/queries",
    json={
        "query": "migration policies in Sweden",
        "k": 5,
        "alpha": 0.7,
        "publisher": "EU Commission",
        "date_range": ["2020-01-01", "2024-12-31"]
    },
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(response.json())

Response

{
  "query_id": "qry_abc123def456",
  "query": "migration policies in Sweden",
  "sources_found": 5,
  "total_tokens": 3500,
  "estimated_cost_cents": 400,
  "preview": "Found 5 relevant sources:\n- Publisher A: Content preview...\n...",
  "metadata": {
    "publishers": ["Publisher A", "Publisher B"],
    "max_relevance_score": 0.95,
    "publisher_filter": "EU Commission",
    "date_range": ["2020-01-01", "2024-12-31"],
    "expires_at": "2025-01-25T10:00:00Z"
  },
  "next_step": {
    "action": "create_checkout",
    "endpoint": "/api/v1/acp/checkouts",
    "method": "POST"
  }
}

POST

/api/v1/acp/checkouts

Create Checkout

Create an ACP checkout session for data access.

Parameters

query_id

required

Type: string

Query ID from previous query request

payment_provider

optional

Type: string

Preferred payment provider: 'stripe' or 'x402' (default: 'stripe')

Request

response = requests.post(
    "https://api.redpine.ai/api/v1/acp/checkouts",
    json={"query_id": query_id},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
checkout = response.json()
checkout_id = checkout["id"]

Response

{
  "id": "chk_abc123xyz",
  "status": "ready_for_payment",
  "query_id": "qry_abc123def456",
  "amount": 400,
  "currency": "usd",
  "payment_provider": {
    "provider": "stripe",
    "supported_payment_methods": ["card"]
  },
  "created_at": "2025-01-01T12:00:00Z"
}

POST

/api/v1/acp/checkouts/{checkout_id}/complete

Complete Checkout

Complete payment using one of two payment methods: credits or Stripe.

Parameters

checkout_id

required

Type: string

Checkout session ID (in URL path)

payment_data

optional

Type: object

Omit entirely or pass null for credit payment

Request

response = requests.post(
    f"https://api.redpine.ai/api/v1/acp/checkouts/{checkout_id}/complete",
    json={"payment_data": None},  # None or omit for credits
    headers={"X-API-Key": "YOUR_API_KEY"}
)
result = response.json()
access_token = result["links"][0]["url"].split("token=")[1]

Response

{
  "id": "chk_abc123xyz",
  "status": "completed",
  "query_id": "qry_abc123def456",
  "amount": 400,
  "currency": "usd",
  "links": [
    {
      "type": "data_access",
      "url": "https://api.redpine.ai/api/v1/acp/data/access?token=dat_xyz789abc",
      "expires_at": "2025-01-08T12:00:00Z"
    }
  ],
  "created_at": "2025-01-01T12:00:00Z",
  "updated_at": "2025-01-01T12:05:00Z"
}

GET

/api/v1/acp/data/access

Access Data

Retrieve full data using an access token. The access token itself serves as authentication.

Parameters

token

required

Type: string

Access token from completed checkout (query parameter)

Request

# Note: No X-API-Key needed - access token serves as authentication
response = requests.get(
    f"https://api.redpine.ai/api/v1/acp/data/access?token={access_token}"
)
data = response.json()

Response

{
  "query_id": "qry_abc123def456",
  "query": "migration policies in Sweden",
  "data": [
    {
      "chunk_id": "chunk_001",
      "text": "Content of the research data...",
      "metadata": {
        "publisher": "Publisher A",
        "relevance_score": 0.95
      }
    }
  ],
  "total_tokens": 3500,
  "sources_count": 5,
  "access_expires_at": "2025-01-08T12:00:00Z"
}

Rate Limits

Query Endpoint60 req/min

Checkout Endpoint30 req/min

Data Access100 req/min

Common Errors

400

insufficient_credits

401

invalid_api_key

403

access_denied

429

rate_limit_exceeded

Support

Email: [email protected]

Dashboard: developer.redpine.ai