Airquote API Documentation

Quote attribution API with semantic search capabilities

Quick Start

1.
Get your API key
Visit API Keys to create a new key

Make your first request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.airquote.com/v1/random

3.
Explore endpoints
See available endpoints below for search, attribution, and more

Authentication

All API requests (except quote-of-day) require authentication using an API key.

Include in request headers:

Authorization: Bearer aq_your_api_key_here

Rate Limits

Tier	Per Minute	Per Day	Burst
Free	10 requests	100 requests	5 requests
Pro	60 requests	10,000 requests	20 requests
Enterprise	600 requests	100,000 requests	100 requests

Rate limit information is included in response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

API Endpoints

Quote of the Day

Public

Endpoint

GET /api/v1/quote-of-day

Response

{
  "success": true,
  "data": {
    "id": 3,
    "text": "Innovation distinguishes...",
    "author": "Steve Jobs",
    "author_details": {...},
    "source": {...},
    "year": 1985,
    "topics": ["innovation", "leadership"],
    "verification_level": 2,
    "language": "en"
  },
  "meta": {
    "date": "2025-09-28"
  }
}

Random Quote

Authenticated

Endpoint

GET /api/v1/random

Query Parameters

verified_only - Return only verified quotes (boolean)
topics - Filter by topics (comma-separated)
author - Filter by author name
language - Filter by language code

Search Quotes

Authenticated

Endpoint

POST /api/v1/search

Request Body

{
  "query": "innovation",
  "type": "semantic", // or "keyword"
  "limit": 10,
  "verified_only": true,
  "topics": ["technology", "business"]
}

Search Types

semantic - AI-powered similarity search
keyword - Traditional text matching

Enhance Quote

Premium

Endpoint

POST /api/v1/enhance

Request Body

{
  "text": "To be or not to be",
  "enhance_options": {
    "add_context": true,
    "verify_attribution": true,
    "find_original": true,
    "add_metadata": true
  }
}

Features

• Verifies quote attribution
• Adds historical context
• Finds original source
• Enriches with metadata

Response Codes

200 OKRequest successful

400 Bad RequestInvalid request parameters

401 UnauthorizedMissing or invalid API key

429 Too Many RequestsRate limit exceeded

500 Internal Server ErrorServer error occurred

SDKs & Libraries

Official SDKs coming soon for:

JavaScript

Python

Ruby

PHP

Need Help?

We're here to help you integrate Airquote into your application.

Test API Playground Contact Support