Platform Integration

Hashtag and keyword suggestions (any platform)

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.

get/uploadposts/suggestions

Query parameters

platform'tiktok' required

The network to ask. Only tiktok answers today.

userstring required

Profile username as configured in Upload-Post. profile is accepted as an alias.

type'hashtags' | 'keywords'

Which answer you want.

qstring required

The seed keyword.

country_codestring

ISO 3166-1 alpha-2 country to rank hashtag suggestions for, e.g. ES.

languagestring

Language code for the hashtag suggestions, e.g. es.

Response

Suggestions.

successboolean
platformstring
typestring
querystring

Example response

{
  "success": true,
  "platform": "tiktok",
  "type": "hashtags",
  "query": "instant camera",
  "hashtags": [
    {
      "name": "instantcamera",
      "view_count": 128970043215
    }
  ],
  "keywords": [
    {
      "keyword": "instant camera film",
      "search_volume": 61200
    }
  ]
}

Changes