# Lemon8 Topic Information API

> Returns detailed information and background visual assets for a specific Lemon8 topic using its unique forum identifier.

Source: https://www.sandbase.ai/model/lemon8/app/topic-info
API reference: https://www.sandbase.ai/model/lemon8/app/topic-info/docs

## Facts

- Provider: Lemon8
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/lemon8/app/topic-info`
- Price: $0.0015 per call
- Free allowance: 100 calls per organization per UTC day, shared across eligible APIs
- Capabilities: api, lemon8
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/lemon8/app/topic-info` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `forum_id` | string | yes |  |

## FAQ

### How do I use the Lemon8 Topic Information API?

Send a POST request to https://api.sandbase.ai/v1/api/lemon8/app/topic-info with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Lemon8 Topic Information API cost?

$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

### What parameters does the Lemon8 Topic Information API accept?

Required: forum_id (string). The Parameters table and the Playground on this page list every field.

### What does the Lemon8 Topic Information API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

### Do I need a Lemon8 developer account or API key?

No. Lemon8 Topic Information runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Lemon8 API access separately.

## README

### Lemon8 Topic Information API

Look up metadata and background assets for a Lemon8 topic by providing its unique `forum_id`.

#### Use cases

- Display header imagery and details on custom topic pages.
- Inspect Lemon8 topic metadata for content discovery.
- Enrich hashtag analysis with forum background information.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/lemon8/app/topic-info" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"forum_id": "7174447913778593798"}'
```

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `forum_id` | string | Yes | Topic ID, can be obtained from the following interfaces: Get information of specified post: `lemon8/app/post-detail`; Get Editor's Picks of discover page: `lem… |

#### Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

```json
{
  "data": {
    "background": {
      "url_list": [
        {
          "url": "https://p16-lemon8-va-sign.tiktokcdn-us.com/tos-maliva-i-tej9nj120t-us/4b46d07e1…"
        }
      ]
    }
  }
}
```

#### Notes

- Obtain `forum_id` via post detail, discover tabs, or hashtag search endpoints.

#### Related APIs

- [Lemon8 Discover Page Banners](/model/lemon8/app/discover-banners): Returns the current promotional and featured banners displayed on the Lemon8 discover page.
- [Lemon8 Discover Page Content](/model/lemon8/app/discover-tab): Returns the main content featured on the Lemon8 discover tab.
- [Lemon8 Discover Editor Picks](/model/lemon8/app/discover-tab-information-tabs): Returns the Editor's Picks and discover tab information from the Lemon8 mobile app.