# Hive API
> Live data for the Hive blockchain social network, served straight from Hive's public JSON-RPC nodes — no key, no account, nothing cached. Hive is a decentralised blogging and social platform where posts and votes live on-chain and earn crypto rewards. The account endpoint resolves a username to its profile: display name, reputation score, follower and following counts, post count, bio, location, website and join date — @gtg ("Gandalf the Grey") has a 76 reputation and over ten thousand followers. The posts endpoint returns a user's blog posts with each post's up-vote count, the HBD payout it earned, the comment count, the tags and a link. The trending endpoint returns the platform's trending (or hot, new or top-paid) posts right now, optionally filtered by tag — the front page of Hive. This is the profile-posts-and-trends layer for any decentralised-social, blogging or web3 app. Live from the Hive blockchain, nothing stored. Distinct from other social and centralised-blog APIs — this is the on-chain Hive network. 4 endpoints.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/hive-api/..."
```

## Pricing
- **Free** (Free) — 13,200 calls/Mo, 3 req/s
- **Starter** ($6/Mo) — 158,000 calls/Mo, 8 req/s
- **Pro** ($16/Mo) — 705,000 calls/Mo, 15 req/s
- **Scale** ($39/Mo) — 3,520,000 calls/Mo, 30 req/s

## Endpoints

### Hive

#### `GET /v1/account` — A user's Hive profile

**Parameters:**
- `user` (query, required, string) — Hive username Example: `gtg`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hive-api/v1/account?user=gtg"
```

**Response:**
```json
{
    "data": {
        "bio": "IT Wizard, Hive Witness",
        "url": "https://hive.blog/@gtg",
        "cover": null,
        "posts": 7375,
        "avatar": "https://grey.house/img/gandalf.png",
        "created": "2016-06-30T17:22:18",
        "website": null,
        "location": "Hive",
        "username": "gtg",
        "followers": 10955,
        "following": 847,
        "reputation": 76.01,
        "display_name": "Gandalf the Grey"
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:52.557Z",
        "request_id": "7b50b88d-3108-490d-82ca-3fbf98ddd55c"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

#### `GET /v1/posts` — A user's blog posts

**Parameters:**
- `user` (query, required, string) — Hive username Example: `gtg`
- `limit` (query, optional, string) — Max posts (1-50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hive-api/v1/posts?user=gtg&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "posts": [
            {
                "url": "https://hive.blog/hive-160391/@gtg/thank-you-for-passing-by",
                "tags": [
                    "hive",
                    "witness-category",
                    "community",
                    "anniversary"
                ],
                "title": "Thank you for passing by",
                "votes": 805,
                "author": "gtg",
                "created": "2026-03-20T15:09:27",
                "excerpt": "Six years of Hive. A decade of the platform. \"Can you promise that I will come back?\" \"No. And if you do, you will not be the same.\" - The Hobbit: An Unexpected Journey I'm a Hive witness, and one of the core developers of the platform. I've spent nearly a decade making sure the chain keeps producin",
                "category": "hive-160391",
                "comments": 134,
                "permlink": "thank-you-for-passing-by",
                "payout_hbd": 62.276
            },
            {
                "url": "https://hive.blog/hive-160391/@gtg/hive-hardfork-28-jump-starter-kit",
                "tags": [
                    "hivepressure",
                    "dev",
                    "witness-category",
                    "hive",
                    "doc",
                    "faq"
                ],
                "title": "Hive HardFork 28 Jump Starter Kit",
                "votes": 881,
                "author": "gtg",
                
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/trending` — Platform posts, ranked

**Parameters:**
- `sort` (query, optional, string) — trending (default), hot, created, payout or promoted Example: `trending`
- `tag` (query, optional, string) — Filter by tag
- `limit` (query, optional, string) — Max posts (1-50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hive-api/v1/trending?sort=trending&limit=20"
```

**Response:**
```json
{
    "data": {
        "tag": "photography",
        "sort": "trending",
        "count": 20,
        "posts": [
            {
                "url": "https://hive.blog/hive-163772/@onyfest/museu-do-coa-exterior-riding-portugal",
                "tags": [
                    "photography",
                    "gems",
                    "ocd",
                    "creativecoin",
                    "neoxian",
                    "travel",
                    "palnet",
                    "portugal",
                    "lifestyle",
                    "blog"
                ],
                "title": "Museu do Côa - Exterior / Riding Portugal",
                "votes": 860,
                "author": "onyfest",
                "created": "2026-06-08T22:25:00",
                "excerpt": "Hello everyone and welcome to my blog :-) This was the reason that brought us to this part of the country, the famous Côa Museum, and the arrival was one of those moments when I realized that the way it was conceived and built made the building itself compete for attention with the surrounding lands",
                "category": "hive-163772",
                "comments": 8,
                "permlink": "museu-do-coa-exterior-riding-portugal",
                "payout_hbd": 19.745
            },
            {
                "url": "https://hive.blog/hive-163772/@ladytruckview/worth-stopping-for",
                "tags": [
                    "travel",
                    "travelfeed",
      
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hive-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Hive public JSON-RPC API (bridge.*, live)",
        "service": "hive-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/posts": "A user's blog posts (user=gtg, limit up to 50): votes, payout, comments.",
            "GET /v1/account": "A user's Hive profile (user=gtg): reputation, followers, posts, bio.",
            "GET /v1/trending": "Platform posts (sort=trending|hot|created|payout, optional tag=, limit up to 50)."
        },
        "description": "Live data for the Hive blockchain social network from its public JSON-RPC nodes: a username's profile (display name, reputation, followers, following, post count, bio, location, website, join date); a user's blog posts with up-votes, HBD payout, comment count and tags; and the platform's trending, hot, new or top-paid posts, optionally by tag. Live, no key, nothing stored. Distinct from other social and centralised-blog APIs — this is the on-chain Hive network.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:55.802Z",
        "request_id": "3c5b7317-0c24-461c-b02e-7b9142b0f802"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```

### Accounts

#### `GET /v1/followers` — The accounts following a user

**Parameters:**
- `user` (query, required, string) — Hive username Example: `gtg`
- `limit` (query, optional, string) — Max followers (1-100) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hive-api/v1/followers?user=gtg&limit=50"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "source": "Hive",
        "username": "gtg",
        "followers": [
            "a-0-0",
            "a-0-0-0",
            "a-0-0-0-a",
            "a-0-0-0-real-dex",
            "a-0-3",
            "a-2",
            "a-3",
            "a-7",
            "a-a-0",
            "a-a-1",
            "a-a-10",
            "a-a-a",
            "a-a-a-a",
            "a-a-lifemix",
            "a-angel",
            "a-jeffrey",
            "a-l-e-x",
            "a-okio",
            "a-resteembot",
            "a-steemit-upvote",
            "a-zajonc",
            "a007-steem",
            "a0a0",
            "a1000carv",
            "a12832",
            "a23b4d11f15m",
            "a2574686830",
            "a7lady",
            "a7mednabi7",
            "aa9",
            "aaa-resteem",
            "aaaahhhh",
            "aabulhasan",
            "aaceh",
            "aadyashakti",
            "aagabriel",
            "aage",
            "aakifzee",
            "aalagenesis",
            "aamaksal",
            "aamir1994",
            "aamsteem",
            "aan01",
            "aangulomaria",
            "aarkay",
            "aaronleang",
            "aaronli",
            "aaronmda",
            "aaronteng",
            "aarshi"
        ]
    },
    "meta": {
        "timestamp": "2026-06-13T14:07:19.119Z",
        "request_id": "ba29359f-ed6b-4b37-a02c-f2df88d1aee0"
    },
    "status": "ok",
    "message": "Followers ret
…(truncated, see openapi.json for full schema)
```

### Posts

#### `GET /v1/post` — One post in full by author + permlink, with body text

**Parameters:**
- `author` (query, required, string) — Post author Example: `sjarvie5`
- `permlink` (query, required, string) — Post permlink (from /v1/posts or /v1/trending) Example: `share-our-world-first-congregational-church-in-waterloo-iowa`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hive-api/v1/post?author=sjarvie5&permlink=share-our-world-first-congregational-church-in-waterloo-iowa"
```

**Response:**
```json
{
    "data": {
        "url": "https://hive.blog/hive-163772/@sjarvie5/share-our-world-first-congregational-church-in-waterloo-iowa",
        "tags": [
            "shareourworld",
            "travel",
            "architecture",
            "familyhistory",
            "writing",
            "iowa",
            "pinmapple"
        ],
        "title": "Share Our World: First Congregational Church in Waterloo, Iowa",
        "votes": 1296,
        "author": "sjarvie5",
        "source": "Hive",
        "created": "2026-06-12T20:58:39",
        "excerpt": "This beautiful church is where my mother's parents got married 87 years ago. It is the First Congregational Church in Waterloo, Iowa. My grandparents were married on April 22, 1939 at noon. This picture was taken on April 22, 2026 at 11:39am. I planned my trip so I could be there exactly 87 years to",
        "category": "hive-163772",
        "comments": 4,
        "permlink": "share-our-world-first-congregational-church-in-waterloo-iowa",
        "body_text": "This beautiful church is where my mother's parents got married 87 years ago. It is the First Congregational Church in Waterloo, Iowa. My grandparents were married on April 22, 1939 at noon. This picture was taken on April 22, 2026 at 11:39am. I planned my trip so I could be there exactly 87 years to the day. I got a Bed and Breakfast close by and so passed the church each day I was in Waterloo. I was in Iowa doing research for a book I am writing about their honeymo
…(truncated, see openapi.json for full schema)
```

### Communities

#### `GET /v1/communities` — Hive communities ranked, with subscriber counts

**Parameters:**
- `sort` (query, optional, string) — rank (default), new or subs Example: `rank`
- `q` (query, optional, string) — Search query
- `limit` (query, optional, string) — Max results (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hive-api/v1/communities?sort=rank&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "rank",
        "count": 25,
        "query": null,
        "source": "Hive",
        "communities": [
            {
                "url": "https://hive.blog/trending/hive-163772",
                "lang": "en",
                "name": "hive-163772",
                "about": "The Hive travel community",
                "title": "Worldmappin",
                "authors": 201,
                "is_nsfw": false,
                "subscribers": 18331
            },
            {
                "url": "https://hive.blog/trending/hive-105017",
                "lang": "zh",
                "name": "hive-105017",
                "about": "A community for sharing Chinese content on HIVE.",
                "title": "HIVE CN 中文社区",
                "authors": 70,
                "is_nsfw": false,
                "subscribers": 6180
            },
            {
                "url": "https://hive.blog/trending/hive-13323",
                "lang": "en",
                "name": "hive-13323",
                "about": "The Future of Web3 Gaming. Battle Trade and Earn",
                "title": "Splinterlands",
                "authors": 129,
                "is_nsfw": false,
                "subscribers": 13371
            },
            {
                "url": "https://hive.blog/trending/hive-194913",
                "lang": "en",
                "name": "hive-194913",
                "about": "A place for photography lovers to share their work and pho
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/hive-api
OpenAPI spec: https://www.oanor.com/api/hive-api/openapi.json