Search Entities

get

https://api.qloo.com/search

Search for an entity by name or property.

Query Params

query

string

The text to search against.

types

array of strings

The category to search against.
The following values are legacy types available for search only and are not supported in /v2/insights:

urn:entity:actor - urn:entity:album - urn:entity:author - urn:entity:director - urn:entity:locality

types

filter.location

string

A location to base searches on. Accepts a lat/lon coordinate pair or a WKT geometry string. Also accepts a Qloo entity UUID.

Lat/lon coordinate pair: latitude,longitude (e.g. 40.742306,-74.003494)
WKT geometry string: a Well-Known Text geometry such as POINT(-73.99823 40.722668)
Qloo entity UUID: a Qloo entity ID

filter.radius

float

0 to 100

Defaults to 10

The max distance in miles from the location to base results on. This only applies to categories with geolocation data. Default is 10 miles.

filter.exists

array of strings

Filter results by existential property check like external.resy or external.michelin

filter.exists

filter.tags

array of strings

Filter results by a tag

filter.tags

filter.rating

double

0 to 5

Filter by the lowest desired business rating.

filter.popularity

double

0 to 1

The minimum value of popularity an entity must have to be output.

filter.address

string

length ≥ 1

Filter by address using a partial string match. Supports comma-separated terms.

operator.filter.tags

string

enum

Defaults to union

The operator.filter.tags parameter controls whether the API returns results matching all ("intersection") or any ("union") of the input tags.

Allowed:

page

int32

1 to 100

Defaults to 1

The page number

take

integer

Number of results to return

sort_by

string

enum

Defaults to match

Sort results by criteria

Allowed:

Responses

200OK

404No results

429Rate limit exceeded