API v1.0

REST API Documentation

Programmatically access your blog posts with our REST API

Quick Start

Get started with the UpperRank REST API in minutes

Generate an API Key

Visit the API Keys page in your dashboard to generate your first API key.

Make Your First Request

Use the API key in the Authorization header to fetch your posts.

Integrate with Your Application

Use the API to display blog posts on your website or application.

Authentication

All API requests require authentication using an API key

Bearer Token Authentication

Include your API key in the Authorization header of every request:

Authorization: Bearer sk_live_your_api_key_here

Important: Keep your API keys secure. Never commit them to version control or expose them in client-side code.

API Endpoints

List Posts

Retrieve a paginated list of blog posts with optional filtering and sorting.

Endpoint

GET https://upperrank.co/api/v1/posts

Example Request

curl -X GET "https://upperrank.co/api/v1/posts?page=1&limit=10&status=PUBLISHED" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json"

Rate Limits

API usage limits and best practices

To ensure fair usage and system stability, the API enforces rate limits based on your subscription plan:

Free Plan: 100 requests per hour
Starter Plan: 1,000 requests per hour
Professional Plan: 5,000 requests per hour
Enterprise Plan: Custom limits