Find Hashtag

Find matching SPATE hashtags by hashtag name or partial hashtag name, and the platforms where each one is tracked.

Endpoint

GET /v1/latest/find-hashtag/{name}

Authorization

Requires an API bearer token.

Authorization: Bearer <token>

Path parameters

Name	Type	Required	Description
name	string	Yes	Hashtag name or partial hashtag name to search for. The leading # is optional: nivea also matches #nivea. If you include it, send it URL-encoded as %23 (see Troubleshooting).

Response

Returns up to 100 hashtag matches whose names contain the provided search text.

Field	Type	Description
name	string	The search text sent in the request.
hashtags	array	Matching hashtags, each { name, platforms }. name is the hashtag itself (e.g. #nivea) and identifies it across platforms.
hashtags[].platforms	array	Platforms where the hashtag is tracked. Any of instagram, tiktok.
call_cost	integer	Credits charged for the call.
data_cost	integer	Credits charged for the returned data. Always 0 for this endpoint.

Example

Request

curl \
  -H "Authorization: Bearer $SPATE_API_TOKEN" \
  "https://api.spate.nyc/v1/latest/find-hashtag/nivea"

Response

200 OK

{
  "key":"/v1/2026w40/find-hashtag/nivea",
  "credits_used":100,
  "data":{
    "name":"nivea",
    "hashtags": [
      {
        "name":"#niveapartner",
        "platforms":["instagram","tiktok"]
      },
      {
        "name":"#niveaangelskinbodywash",
        "platforms":["instagram","tiktok"]
      },
      ...
    ],
    "call_cost":100,
    "data_cost":0
  }
}

Troubleshooting

404 Not Found when the hashtag starts with #

In a URL, # starts a fragment: the client (curl, browsers, HTTP libraries) strips it and everything after it before sending the request.

Request

curl \
  -H "Authorization: Bearer $SPATE_API_TOKEN" \
  "https://api.spate.nyc/v1/latest/find-hashtag/#nivea"

Response

404 Not Found

HTTP/2 404
content-type: text/html
content-length: 0

The request that actually reaches the API is GET /v1/latest/find-hashtag/, with an empty name, so it matches no endpoint.

Fix

Send the # URL-encoded as %23, or leave it out:

# only hashtags starting with #nivea
curl \
  -H "Authorization: Bearer $SPATE_API_TOKEN" \
  "https://api.spate.nyc/v1/latest/find-hashtag/%23nivea"

# any hashtag containing nivea (#nivea, #cremanivea, ...)
curl \
  -H "Authorization: Bearer $SPATE_API_TOKEN" \
  "https://api.spate.nyc/v1/latest/find-hashtag/nivea"