@buildwithlayer/qloo-mcp
Version:
An MCP server for Qloo generated by @buildwithlayer
1,261 lines (1,260 loc) • 124 kB
JSON
[
{
"description": "Returns taste-based insights based on the input parameters you provide.",
"method": "get",
"name": "getinsights",
"url": "https://staging.api.qloo.com/v2/insights",
"auth": [
{
"in": "header",
"key": "ApiKey",
"name": "X-Api-Key",
"type": "apiKey"
}
],
"params": [
{
"description": "Filter by the category of entity to return (urn:entity:place).",
"in": "query",
"name": "filter.type",
"required": true,
"explode": true,
"schema": {
"enum": [
"urn:entity:artist",
"urn:entity:book",
"urn:entity:brand",
"urn:entity:destination",
"urn:entity:movie",
"urn:entity:person",
"urn:entity:place",
"urn:entity:podcast",
"urn:entity:tv_show",
"urn:entity:videogame",
"urn:heatmap"
],
"examples": [
"urn:entity:book"
],
"type": "string"
},
"style": "form"
},
{
"description": "Adjusts how much strength trends alter the result set.",
"in": "query",
"name": "bias.trends",
"required": false,
"examples": {
"default": {
"value": "medium"
}
},
"explode": false,
"schema": {
"enum": [
"off",
"low",
"medium",
"high"
],
"type": "string"
},
"style": "form"
},
{
"description": "Limits results to a set number of high-affinity entities per city. Set this to \"properties.geocode.city\" to enable city-based diversification. Cities are ranked based on the highest-affinity entity within them, and entities within each city are ordered by their individual affinities.\n",
"in": "query",
"name": "diversify.by",
"required": false,
"explode": true,
"schema": {
"examples": [
"properties.geocode.city"
],
"type": "string"
},
"style": "form"
},
{
"description": "Sets the maximum number of results to return per city when using \"diversify.by\": \"properties.geocode.city\". For example, if set to 5, the response will include up to 5 entities with the highest affinities in each city.\n",
"in": "query",
"name": "diversify.take",
"required": false,
"explode": true,
"schema": {
"examples": [
5
],
"minimum": 1,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter by a comma-separated list of content ratings based on the MPAA film rating system, which determines suitability for various audiences.",
"in": "query",
"name": "filter.content_rating",
"required": false,
"explode": true,
"schema": {
"enum": [
"G",
"PG",
"PG-13",
"R",
"NC-17"
],
"examples": [
"PG"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter by the most recent date of birth desired for the queried person.",
"in": "query",
"name": "filter.date_of_birth.max",
"required": false,
"explode": true,
"schema": {
"examples": [
"2004-01-01"
],
"format": "date",
"type": "string"
},
"style": "form"
},
{
"description": "Filter by the earliest date of birth desired for the queried person.",
"in": "query",
"name": "filter.date_of_birth.min",
"required": false,
"explode": true,
"schema": {
"examples": [
"1996-01-01"
],
"format": "date",
"type": "string"
},
"style": "form"
},
{
"description": "Filter by the most recent date of death desired for the queried person.",
"in": "query",
"name": "filter.date_of_death.max",
"required": false,
"explode": true,
"schema": {
"examples": [
"2004-01-01"
],
"format": "date",
"type": "string"
},
"style": "form"
},
{
"description": "Filter by the earliest date of death desired for the queried person.",
"in": "query",
"name": "filter.date_of_death.min",
"required": false,
"explode": true,
"schema": {
"examples": [
"1985-01-01"
],
"format": "date",
"type": "string"
},
"style": "form"
},
{
"description": "Exclude entities associated with a comma-separated list of tags.",
"in": "query",
"name": "filter.exclude.tags",
"required": false,
"explode": true,
"schema": {
"examples": [
"urn:tag:genre:media:mystery,urn:tag:genre:media:drama"
],
"type": "string"
},
"style": "form"
},
{
"description": "Specifies how multiple `filter.exclude.tags` values are combined in the query. Use \"union\" (equivalent to a logical \"or\") to exclude results that contain at least one of the specified tags, or \"intersection\" (equivalent to a logical \"and\") to exclude only results that contain all specified tags. The default is \"union\".",
"in": "query",
"name": "operator.exclude.tags",
"required": false,
"explode": true,
"schema": {
"enum": [
"union",
"intersection"
],
"examples": [
"union"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter results by existential property check like `external.resy` or `external.michelin`",
"in": "query",
"name": "filter.exists",
"required": false,
"explode": false,
"schema": {
"type": "array",
"items": {
"pattern": "^external\\.\\w+$",
"type": "string"
}
},
"style": "form"
},
{
"description": "Filter by a comma-separated list of external keys. (`resy`\\|`michelin`\\|`tablet`).",
"in": "query",
"name": "filter.external.exists",
"required": false,
"explode": true,
"schema": {
"examples": [
"resy,michelin"
],
"type": "string"
},
"style": "form"
},
{
"description": "Specifies how multiple `filter.external.exists` values are combined in the query. Use \"union\" (equivalent to a logical \"or\") to return results that match at least one of the specified external keys (e.g., resy, michelin, or tablet), or \"intersection\" (equivalent to a logical \"and\") to return only results that match all specified external keys. The default is \"union\".",
"in": "query",
"name": "operator.filter.external.exists",
"required": false,
"explode": true,
"schema": {
"enum": [
"union",
"intersection"
],
"examples": [
"union"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter places to include only those with a Resy rating count less than or equal to the specified maximum. Applies only to entities with `filter.type` of `urn:entity:place`.\n",
"in": "query",
"name": "filter.external.resy.count.max",
"required": false,
"explode": true,
"schema": {
"examples": [
200
],
"minimum": 0,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter places to include only those with a Resy rating count greater than or equal to the specified minimum. Applies only to entities with `filter.type` of `urn:entity:place`.\n",
"in": "query",
"name": "filter.external.resy.count.min",
"required": false,
"explode": true,
"schema": {
"examples": [
20
],
"minimum": 0,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter by the maximum supported party size required for a Point of Interest.",
"in": "query",
"name": "filter.external.resy.party_size.max",
"required": false,
"explode": true,
"schema": {
"examples": [
10
],
"minimum": 1,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter by the minimum supported party size required for a Point of Interest.",
"in": "query",
"name": "filter.external.resy.party_size.min",
"required": false,
"explode": true,
"schema": {
"examples": [
2
],
"minimum": 1,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter places to include only those with a Resy rating less than or equal to the specified maximum (1–5 scale). Applies only to entities with `filter.type` of `urn:entity:place`.",
"in": "query",
"name": "filter.external.resy.rating.max",
"required": false,
"explode": true,
"schema": {
"examples": [
4.5
],
"maximum": 5,
"minimum": 0,
"type": "number"
},
"style": "form"
},
{
"description": "Filter places to include only those with a Resy rating greater than or equal to the specified minimum (1–5 scale). Applies only to entities with `filter.type` of `urn:entity:place`.",
"in": "query",
"name": "filter.external.resy.rating.min",
"required": false,
"explode": true,
"schema": {
"examples": [
3.5
],
"maximum": 5,
"minimum": 0,
"type": "number"
},
"style": "form"
},
{
"description": "Filter places to include only those with a Tripadvisor review count greater than or equal to the specified minimum. This filter only applies to entities with `filter.type` of `urn:entity:place`.\n",
"in": "query",
"name": "filter.external.tripadvisor.rating.count.min",
"required": false,
"explode": true,
"schema": {
"examples": [
50
],
"minimum": 0,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter places to include only those with a Tripadvisor review count less than or equal to the specified maximum. This filter only applies to entities with `filter.type` of `urn:entity:place`.\n",
"in": "query",
"name": "filter.external.tripadvisor.rating.count.max",
"required": false,
"explode": true,
"schema": {
"examples": [
500
],
"minimum": 0,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter places to include only those with a Tripadvisor rating less than or equal to the specified maximum. This filter only applies to entities with `filter.type` of `urn:entity:place`.\n",
"in": "query",
"name": "filter.external.tripadvisor.rating.max",
"required": false,
"explode": true,
"schema": {
"examples": [
4
],
"maximum": 5,
"minimum": 0,
"type": "number"
},
"style": "form"
},
{
"description": "Filter places to include only those with a Tripadvisor rating greater than or equal to the specified minimum. This filter only applies to entities with `filter.type` of `urn:entity:place`.\n",
"in": "query",
"name": "filter.external.tripadvisor.rating.min",
"required": false,
"explode": true,
"schema": {
"examples": [
3
],
"maximum": 5,
"minimum": 0,
"type": "number"
},
"style": "form"
},
{
"description": "Filter by the latest desired year for the final season of a TV show.",
"in": "query",
"name": "filter.finale_year.max",
"required": false,
"explode": true,
"schema": {
"examples": [
2021
],
"type": "integer"
},
"style": "form"
},
{
"description": "Filter by the earliest desired year for the final season of a TV show.",
"in": "query",
"name": "filter.finale_year.min",
"required": false,
"explode": true,
"schema": {
"examples": [
2014
],
"type": "integer"
},
"style": "form"
},
{
"description": "Filter results to align with a specific gender identity. Used to personalize output based on known or inferred gender preferences.\n",
"in": "query",
"name": "filter.gender",
"required": false,
"explode": true,
"schema": {
"examples": [
"female"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter by `properties.geocode.admin1_region`. Exact match (usually state).",
"in": "query",
"name": "filter.geocode.admin1_region",
"required": false,
"explode": true,
"schema": {
"examples": [
"NY"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter by `properties.geocode.admin2_region`. Exact match (often county or borough).",
"in": "query",
"name": "filter.geocode.admin2_region",
"required": false,
"explode": true,
"schema": {
"examples": [
"New York County"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter by `properties.geocode.country_code`. Exact match (two-letter country code).",
"in": "query",
"name": "filter.geocode.country_code",
"required": false,
"explode": true,
"schema": {
"examples": [
"US"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter by `properties.geocode.name`. This requires an exact match, and should only be used for towns, neighbourhoods, or very small cities. DO NOT USE THIS PARAMETER for general area filtering, instead use `filter.location.query`.",
"in": "query",
"name": "filter.geocode.name",
"required": false,
"explode": true,
"schema": {
"examples": [
"New York"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter by the maximum desired hotel class (1-5, inclusive).",
"in": "query",
"name": "filter.hotel_class.max",
"required": false,
"explode": true,
"schema": {
"examples": [
5
],
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter by the minimum desired hotel class (1-5, inclusive).",
"in": "query",
"name": "filter.hotel_class.min",
"required": false,
"explode": true,
"schema": {
"examples": [
3
],
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter by the day of the week the Point of Interest must be open (Monday, Tuesday, etc.).",
"in": "query",
"name": "filter.hours",
"required": false,
"explode": true,
"schema": {
"enum": [
"monday",
"tuesday",
"wednesday",
"thursday",
"friday",
"saturday",
"sunday"
],
"examples": [
"monday"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter by a certain maximum year that shows were released or updated.",
"in": "query",
"name": "filter.latest_known_year.max",
"required": false,
"content": {
"application/json": {
"schema": {
"examples": [
2023
],
"type": "integer"
}
}
}
},
{
"description": "Filter by a certain minimum year that shows were released or updated.",
"in": "query",
"name": "filter.latest_known_year.min",
"required": false,
"content": {
"application/json": {
"schema": {
"examples": [
2014
],
"type": "integer"
}
}
}
},
{
"description": "Used to filter by a WKT POINT, POLYGON, MULTIPOLYGON or a single Qloo ID for a named urn:entity:locality. WKT is formatted as X then Y, therefore longitude is first (POINT(-73.99823 40.722668)). If a Qloo ID or WKT POLYGON is passed, filter.location.radius will create a fuzzy boundary when set to a value > 0.",
"in": "query",
"name": "filter.location",
"required": false,
"explode": false,
"schema": {
"examples": [
"POINT(-73.99823 40.722668)"
],
"pattern": "^(POINT|MULTIPOINT|POLYGON)\\s*\\(.+\\)$",
"type": "string"
},
"style": "form"
},
{
"description": "Exclude results that fall within a specific location, defined by either a WKT `POINT`, `POLYGON`, `MULTIPOLYGON`, or a Qloo ID for a named `urn:entity:locality`. WKT is formatted with longitude first (e.g., `POINT(-73.99823 40.722668)`). When using a locality ID or a WKT `POLYGON`, setting `filter.location.radius` to a value > 0 creates a fuzzy exclusion boundary.\n",
"in": "query",
"name": "filter.exclude.location",
"required": false,
"explode": true,
"schema": {
"examples": [
"POINT(-73.99823 40.722668)"
],
"type": "string"
},
"style": "form"
},
{
"description": "This is the BEST way to filter a search to a specific area, without knowing the exact addresses of the search results. A query used to search for a named `urn:entity:locality` Qloo ID for filtering requests, equivalent to passing the same Locality Qloo ID into `filter.location`.\nLocality queries are fuzzy-matched and case-insensitive. Examples include `New York City`, `Garden City`, `New York`, `Los Angeles`, `Lower East Side`, and AKAs like `The Big Apple`. The response JSON includes `query.locality.signal` with the matched Qloo entity. By default, the API includes a tuning that also captures nearby entities just outside the official boundaries of the locality. To turn this off and limit results strictly to within the locality, set `filter.location.radius=0`. If no localities are found, the API returns a 400 error.\n",
"in": "query",
"name": "filter.location.query",
"required": false,
"examples": {
"singleLocality": {
"summary": "A single locality string",
"value": "New York City"
}
},
"explode": true,
"schema": {
"type": "string"
},
"style": "form"
},
{
"description": "A query used to exclude results based on a named `urn:entity:locality` Qloo ID, resolved from fuzzy-matched locality names. This is equivalent to passing the resolved Locality Qloo ID into `filter.exclude.location`.\nLocality queries are case-insensitive and support common AKAs (e.g., `The Big Apple` for New York). The response includes `query.locality.exclude.signal` with the matched Qloo entity. If no localities are matched, the API returns a 400 error.\n",
"in": "query",
"name": "filter.exclude.location.query",
"required": false,
"examples": {
"singleLocality": {
"summary": "A single locality to exclude",
"value": "Williamsburg"
}
},
"explode": true,
"schema": {
"type": "string"
},
"style": "form"
},
{
"description": "Filter by a geohash. Geohashes are generated using the Python package pygeohash with a precision of 12 characters. This parameter returns all POIs that start with the specified geohash. For example, supplying `dr5rs` would allow returning the geohash `dr5rsjk4sr2w`.",
"in": "query",
"name": "filter.location.geohash",
"required": false,
"explode": true,
"schema": {
"examples": [
"dr5rsjk4sr2w"
],
"type": "string"
},
"style": "form"
},
{
"description": "Exclude all entities whose geohash starts with the specified prefix. Geohashes are generated using the Python package `pygeohash` with a precision of 12 characters. For example, supplying `dr5rs` would exclude any result whose geohash begins with `dr5rs`, such as `dr5rsjk4sr2w`.\n",
"in": "query",
"name": "filter.exclude.location.geohash",
"required": false,
"explode": true,
"schema": {
"examples": [
"dr5rs"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter by the radius (in meters) when also supplying `filter.location` or `filter.location.query`.\nWhen this parameter is **not provided**, the API applies a default tuning that slightly expands the locality boundary to include nearby entities outside its official shape.\nTo **disable** this behavior and strictly limit results to entities inside the defined locality boundary, set `filter.location.radius=0`.\n",
"in": "query",
"name": "filter.location.radius",
"required": false,
"examples": {
"defaultRadius": {
"summary": "Custom radius in meters",
"value": 10000
},
"disableTuning": {
"summary": "Turn off default tuning behavior",
"value": 0
}
},
"explode": true,
"schema": {
"default": 15000,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter by a comma-separated list of parental entity types (`urn:entity:place`). Each type must match exactly.",
"in": "query",
"name": "filter.parents.types",
"required": false,
"explode": false,
"schema": {
"examples": [
"urn:entity:place,",
"urn:entity:book"
],
"type": "array",
"items": {
"type": "string"
}
},
"style": "form"
},
{
"description": "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).",
"in": "query",
"name": "filter.popularity.max",
"required": false,
"explode": true,
"schema": {
"examples": [
0.98
],
"maximum": 1,
"minimum": 0,
"type": "number"
},
"style": "form"
},
{
"description": "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).",
"in": "query",
"name": "filter.popularity.min",
"required": false,
"explode": true,
"schema": {
"examples": [
0.5
],
"maximum": 1,
"minimum": 0,
"type": "number"
},
"style": "form"
},
{
"description": "Filter by the maximum price level a Point of Interest can have (1|2|3|4, similar to dollar signs).",
"in": "query",
"name": "filter.price_level.max",
"required": false,
"explode": true,
"schema": {
"examples": [
3
],
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter by the minimum price level a Point of Interest can have (1|2|3|4, similar to dollar signs).",
"in": "query",
"name": "filter.price_level.min",
"required": false,
"explode": true,
"schema": {
"examples": [
1
],
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter places by a minimum price level, representing the lowest price in the desired range. Accepts an integer value between 0 and 1,000,000.",
"in": "query",
"name": "filter.price_range.from",
"required": false,
"explode": true,
"schema": {
"examples": [
200
],
"maximum": 1000000,
"minimum": 0,
"type": "integer"
},
"style": "form"
},
{
"description": "Filter places by a maximum price level, representing the highest price in the desired range. Accepts an integer value between 0 and 1,000,000. Only applies to places.",
"in": "query",
"name": "filter.price_range.to",
"required": false,
"explode": true,
"schema": {
"examples": [
200
],
"maximum": 1000000,
"minimum": 0,
"type": "integer"
},
"style": "form"
},
{
"description": "maximum price",
"in": "query",
"name": "filter.price.max",
"required": false,
"content": {
"application/json": {
"schema": {
"examples": [
200
],
"format": "float",
"type": "number"
}
}
}
},
{
"description": "minimum price",
"in": "query",
"name": "filter.price.min",
"required": false,
"content": {
"application/json": {
"schema": {
"examples": [
1
],
"format": "float",
"type": "number"
}
}
}
},
{
"description": "Filter by the highest desired business rating.",
"in": "query",
"name": "filter.properties.business_rating.max",
"required": false,
"explode": true,
"schema": {
"enum": [
1,
2,
3,
4,
5
],
"examples": [
3
],
"format": "float",
"type": "number"
},
"style": "form"
},
{
"description": "Filter by the lowest desired business rating.",
"in": "query",
"name": "filter.properties.business_rating.min",
"required": false,
"explode": true,
"schema": {
"enum": [
1,
2,
3,
4,
5
],
"examples": [
3
],
"format": "float",
"type": "number"
},
"style": "form"
},
{
"description": "Filter by the latest desired year of initial publication for the work.",
"in": "query",
"name": "filter.publication_year.max",
"required": false,
"explode": true,
"schema": {
"examples": [
2021
],
"type": "number"
},
"style": "form"
},
{
"description": "Filter by the earliest desired year of initial publication for the work.",
"in": "query",
"name": "filter.publication_year.min",
"required": false,
"explode": true,
"schema": {
"examples": [
1985
],
"type": "number"
},
"style": "form"
},
{
"description": "Filter by the maximum Qloo rating a Point of Interest must have (float, between 0 and 5).",
"in": "query",
"name": "filter.rating.max",
"required": false,
"explode": true,
"schema": {
"examples": [
4.5
],
"maximum": 5,
"minimum": 0,
"type": "number"
},
"style": "form"
},
{
"description": "Filter by the minimum Qloo rating a Point of Interest must have (float, between 0 and 5).",
"in": "query",
"name": "filter.rating.min",
"required": false,
"explode": true,
"schema": {
"examples": [
3.5
],
"maximum": 5,
"minimum": 0,
"type": "number"
},
"style": "form"
},
{
"description": "Filter by a comma-separated list of brand entity IDs. Use this to narrow down place recommendations to specific brands. For example, to include only Walmart stores, pass the Walmart brand ID. Each ID must match exactly.",
"in": "query",
"name": "filter.references_brand",
"required": false,
"explode": false,
"schema": {
"examples": [
"636E1B95-6232-43E1-BDFE-37CD209C2CE3,7D2B1DFF-9D5D-44DE-970E-46B80C76CFA6"
],
"type": "array",
"items": {
"type": "string"
}
},
"style": "form"
},
{
"description": "Filter by a list of countries where a movie or TV show was originally released.",
"in": "query",
"name": "filter.release_country",
"required": false,
"explode": false,
"schema": {
"examples": [
"United States",
"France"
],
"type": "array",
"items": {
"type": "string"
}
},
"style": "form"
},
{
"description": "Specifies how multiple `filter.release_country`` values are combined in the query. Use \"union\" (equivalent to a logical \"or\") to return results that match at least one of the specified countries, or \"intersection\" (equivalent to a logical \"and\") to return only results that match all specified countries. The default is \"union\".",
"in": "query",
"name": "operator.filter.release_country",
"required": false,
"explode": true,
"schema": {
"enum": [
"intersection",
"union"
],
"examples": [
"union"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter by the latest desired release date.",
"in": "query",
"name": "filter.release_date.max",
"required": false,
"explode": true,
"schema": {
"examples": [
"2024-01-01"
],
"format": "date",
"type": "string"
},
"style": "form"
},
{
"description": "Filter by the earliest desired release date.",
"in": "query",
"name": "filter.release_date.min",
"required": false,
"explode": true,
"schema": {
"examples": [
"2021-01-01"
],
"format": "date",
"type": "string"
},
"style": "form"
},
{
"description": "Filter by the latest desired release year.",
"in": "query",
"name": "filter.release_year.max",
"required": false,
"explode": true,
"schema": {
"examples": [
2024
],
"type": "integer"
},
"style": "form"
},
{
"description": "Filter by the earliest desired release year.",
"in": "query",
"name": "filter.release_year.min",
"required": false,
"explode": true,
"schema": {
"examples": [
1996
],
"type": "integer"
},
"style": "form"
},
{
"description": "Filter by a comma-separated list of entity IDs. Often used to assess the affinity of an entity towards input.",
"in": "query",
"name": "filter.results.entities",
"required": false,
"explode": true,
"schema": {
"examples": [
"636E1B95-6232-43E1-BDFE-37CD209C2CE3,7D2B1DFF-9D5D-44DE-970E-46B80C76CFA6"
],
"type": "string"
},
"style": "form"
},
{
"description": "Search for an entity by name to use as filters. Provide a single entity name as a string.",
"in": "query",
"name": "filter.results.entities.query",
"required": false,
"examples": {
"singleEntity": {
"summary": "A single entity query",
"value": "Balthazar"
}
},
"explode": true,
"schema": {
"type": "string"
},
"style": "form"
},
{
"description": "A comma-separated list of entity IDs to remove from the results.",
"in": "query",
"name": "filter.exclude.entities",
"required": false,
"explode": true,
"schema": {
"examples": [
"39458DC0-F91D-4591-80A8-E254E66F84A2,B315A4B4-6756-4CF3-8297-75FD94CC8CF2"
],
"type": "string"
},
"style": "form"
},
{
"description": "Filter by a comma-separated list of tag IDs. Often used to assess the affinity of a tag towards input.",
"in": "query",
"name": "filter.results.tags",
"required": false,
"explode": false,
"schema": {
"type": "array",
"items": {
"examples": [
"?",
"?"
],
"type": "string"
}
},
"style": "form"
},
{
"description": "Filter results by a tag",
"in": "query",
"name": "filter.tags",
"required": false,
"examples": {
"default": {
"value": [
"urn:tag:genre:action",
"urn:tag:genre:place:tourist_attraction"
]
}
},
"explode": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"style": "form"
},
{
"description": "The operator.filter.tags parameter controls whether the API returns results matching all (\"intersection\") or any (\"union\") of the input tags.",
"in": "query",
"name": "operator.filter.tags",
"required": false,
"examples": {
"default": {
"value": "intersection"
}
},
"explode": true,
"schema": {
"default": "union",
"enum": [
"intersection",
"union"
],
"type": "string"
},
"style": "form"
},
{
"description": "The number of results to skip, starting from 0. Allows arbitrary offsets but is less commonly used than `page`.",
"in": "query",
"name": "offset",
"required": false,
"explode": true,
"schema": {
"examples": [
5
],
"type": "integer"
},
"style": "form"
},
{
"description": "Indicates the type of heatmap output desired: The default is geohashes. The other options are a city or a neighborhood.",
"in": "query",
"name": "output.heatmap.boundary",
"required": false,
"explode": true,
"schema": {
"examples": [
"urn:entity:locality"
],
"type": "string"
},
"style": "form"
},
{
"description": "The page number",
"in": "query",
"name": "page",
"required": false,
"examples": {
"default": {
"value": 1
}
},
"explode": true,
"schema": {
"default": 1,
"format": "int32",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"style": "form"
},
{
"description": "A comma-separated list of age ranges that influence the affinity score.(35_and_younger\\|36_to_55\\|55_and_older).",
"in": "query",
"name": "signal.demographics.age",
"required": false,
"explode": true,
"schema": {
"enum": [
"35_and_younger",
"36_to_55",
"55_and_older"
],
"examples": [
"36_to_55"
],
"type": "string"
},
"style": "form"
},
{
"description": "Specifies the extent to which results should be influenced by age-based demographic signals. Higher values increase the influence of age data; lower values reduce its impact.",
"in": "query",
"name": "signal.demographics.age.weight",
"required": false,
"explode": true,
"schema": {
"examples": [
"medium"
],
"oneOf": [
{
"minimum": 0,
"type": "number"
},
{
"enum": [
"very_low",
"low",