🔌 API Documentation

Integrate VapeIndex data into your application

VapeIndex REST API

Our API provides programmatic access to posts, comments, boards, users, and price data. Perfect for building apps, bots, or analytics tools.

🟢 API Status: Operational Version: 1.0

Quick Start

Example Request 
curl https://api.vapeindex.io/v1/posts?board=disposables&limit=10

API Endpoints

GET
/v1/posts
Get posts from all boards or filtered by board
View Details

Parameters

  • board (optional) - Filter by board slug
  • sort (optional) - Sort by: hot, new, top, rising
  • limit (optional) - Number of results (1-100, default: 25)
  • offset (optional) - Pagination offset

Example Response

{
  "posts": [
    {
      "id": "1",
      "title": "Best disposable vapes of 2025?",
      "board": "disposables",
      "author": "vapeenthusiast",
      "score": 287,
      "comments": 94,
      "created": "2025-01-18T10:30:00Z"
    }
  ],
  "pagination": {
    "total": 1543,
    "limit": 25,
    "offset": 0
  }
}
GET
/v1/posts/:id
Get a specific post with comments
GET
/v1/boards
List all boards
GET
/v1/boards/:slug
Get board details and recent posts
GET
/v1/users/:username
Get user profile and activity
GET
/v1/prices
Get price tracking data for products
POST
/v1/posts
Create a new post (requires authentication)
POST
/v1/posts/:id/vote
Vote on a post (requires authentication)

Authentication

Some endpoints require authentication. Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

To get an API key, contact us with details about your use case.

Rate Limits

Free Tier
60 requests/minute
Public endpoints only
Authenticated
300 requests/minute
Full API access
Enterprise
Custom limits
Contact us for pricing

Best Practices

  • Cache responses when possible to reduce API calls
  • Use pagination for large datasets
  • Include a User-Agent header identifying your application
  • Handle rate limit errors (HTTP 429) with exponential backoff
  • Monitor the X-RateLimit-* response headers

Need Help?

Check out our FAQ or contact us for API support.