Search Tags

get

https://api.qloo.com/v2/tags

Search for tags that are supported by the filter.tags, exclude.tags, and signal.interests.tags parameters.

Query Params

feature.typo_tolerance

boolean

Defaults to false

When set to true, allows tolerance for typos in the filter.query parameter. For example, a query for “Mediterranaen” would return tags with the word “Mediterranean” in their titles. Default is false.

feature.semantic_search

boolean

Defaults to false

When set to true, enables semantic search for tag queries. Instead of exact or typo-tolerant matching, the API uses semantic similarity to find tags related to the meaning of the query. This feature is currently in beta. Use alongside filter.query to perform a semantic tag search.

filter.results.tags

array of strings

Filter by a comma-separated list of tag IDs. Often used to assess the affinity of a tag towards input.

filter.results.tags

filter.parents.types

string

enum

Filter by a comma-separated list of parental entity types.

filter.popularity.min

number

0 to 1

Filter by the minimum popularity percentile required for a Point of Interest (float, between 0 and 1; closer to 1 indicates higher popularity, e.g., 0.98 for the 98th percentile).

filter.popularity.max

number

0 to 1

Filter by the maximum popularity percentile a Point of Interest must have (float, between 0 and 1; closer to 1 indicates higher popularity, e.g., 0.98 for the 98th percentile).

filter.query

string

A partial string search on the audience or tag name.

filter.tag.types

array of strings

Filter by a comma-separated list of tag types. Each tag type requires an exact match. You can retrieve a list of tag types supported by each entity type via the Tag Types API.

filter.tag.types

page

int32

1 to 100

Defaults to 1

The page number

take

integer

1 to 50

Defaults to 20

The number of results to return. Default is 20. The maximum allowed is 50.
To retrieve additional results, use the page parameter to access the next page of results. This is the recommended approach for pagination.
For specific cases, the offset parameter can be used with take to skip a set number of results.

Responses

400

Bad Request

500

Internal Server Error

200Successful Operation