---
title: "Hashtag and keyword suggestions (any platform)"
method: GET
path: "/uploadposts/suggestions"
tags: ["Platform Integration"]
---

# Hashtag and keyword suggestions (any platform)

`GET /uploadposts/suggestions`

What to tag a post with (`type=hashtags`) and what people search around a keyword (`type=keywords`). One endpoint per QUESTION with a `platform`, never one URL per network. Only `tiktok` answers today; any other value returns 400 with error_code `platform_not_supported`. `type=hashtags` needs the `profile_analytics` capability, which any recent connection has; `type=keywords` needs `trend_search`, which is granted only when the account is (re)connected.

## Query parameters

- `platform` 'tiktok', required
- `user` string, required
- `type` 'hashtags' | 'keywords'
- `q` string, required
- `country_code` string
- `language` string

## Response `200`

Suggestions.

- object
  - `success` boolean
  - `platform` string
  - `type` string
  - `query` string
  - `hashtags` object[] — Only for type=hashtags.
    - `name` string — The tag WITHOUT the leading #.
    - `view_count` integer — Lifetime views of content carrying the tag. Reaches 12 digits — parse as a 64-bit integer.
  - `keywords` object[] — Only for type=keywords. Passed through as the platform returns it; treat each object as an open shape.
    - `keyword` string
    - `search_volume` integer

## Other responses

- `400` — That network cannot answer this question yet. Upload-Post is one endpoint per QUESTION with a `platform`, so the message names the platforms that can. Branch on the error_code, not on a hard-coded platform list: when the network is added, the same call starts returning data. Some endpoints carry the text in `error` instead of `message`.
- `401` — Unauthorized — Invalid or expired token.
- `404` — Not Found — Resource does not exist.
- `409` — The TikTok token expired and could not be refreshed; the account must be reconnected.
- `502` — TikTok rejected the request. Its message is returned verbatim.

## Changes

- **2026-08-31** `f3ef68b64fbc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/upload-post/apis/upload-post-api/changes/uploadposts/suggestions/get.md)

---

[API](https://skmtc.dev/upload-post/apis/upload-post-api.md) · [All operations](https://skmtc.dev/upload-post/apis/upload-post-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/upload-post/upload-post-api/revisions/f3ef68b64fbc/schema)