The neutral meter for AI agent work: neither side keeps the count.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Paper id (DOI, arXiv, PubMed, OpenAlex) -> research card -> Qloo evidence at every decision -> who, where, price tier, held-money target and reserve, and OPEN or REFUSE. Returns every step with its Qloo call, input, output and effect.
Who wants it (F1): Who: age range(s) the answer is weighted to. Qloo: signal.demographics.age. comma-separated, of: 24_and_younger, 25_to_29, 30_to_34, 35_to_44, 45_to_54, 55_and_older
Where to launch (F3): Exact city or town name. Qloo: filter.geocode.name.
Where to launch (F3): Where: a city or region by name. Qloo: filter.location.query.
Anything else in the guide (F8): Any other documented parameter for the call's filter.type, by its Qloo name. Qloo: *.
Who serves or stocks it (F5): Order places by. Qloo: sort_by.
Where to launch (F3): Exact state or region. Qloo: filter.geocode.admin1_region.
Where to launch (F3): Exact county or borough. Qloo: filter.geocode.admin2_region.
Who wants it (F1): Who: gender the answer is weighted to. Qloo: signal.demographics.gender.
Look up exact things (F7): Look up exact things: a name to find (Search Entities). Qloo: query.
Where to launch (F3): Where: radius around it, in meters (0 = strictly inside). Qloo: filter.location.radius.
Who serves or stocks it (F5): Address contains. Qloo: filter.address.
Where to launch (F3): Two-letter country code. Qloo: filter.geocode.country_code.
What is underserved (F2): Entity ids to leave out. Qloo: filter.exclude.entities.
Where to launch (F3): Only results whose geohash starts with this. Qloo: filter.location.geohash.
Who serves or stocks it (F5): Open on this day. Qloo: filter.hours.
Who serves or stocks it (F5): Lean the ranking toward quality places. Qloo: bias.quality.
Media and people products (F6): Person: born on or before (YYYY-MM-DD). Qloo: filter.date_of_birth.max.
Media and people products (F6): Person: born on or after (YYYY-MM-DD). Qloo: filter.date_of_birth.min.
Media and people products (F6): Person: died on or before (YYYY-MM-DD). Qloo: filter.date_of_death.max.
Media and people products (F6): Person: died on or after (YYYY-MM-DD). Qloo: filter.date_of_death.min.
Who serves or stocks it (F5): Listed on these (resy, michelin, tablet). Qloo: filter.external.exists. comma-separated, of: resy, michelin, tablet
Where to launch (F3): A WKT POINT/POLYGON (longitude first) or a locality id. Qloo: filter.location.
At what price, where (F4): Hotel price range to (0-1,000,000). Qloo: filter.price_range.to.
Media and people products (F6): Released up to this year (film/TV; books: publication year). Qloo: filter.release_year.max.
Media and people products (F6): Released from this year (film/TV; books: publication year). Qloo: filter.release_year.min.
Who wants it (F1): Audience segment ids (from /v2/audiences). Qloo: signal.demographics.audiences.
Look up exact things (F7): Look up exact things: paste a Qloo entity id (Search Entities by ID). Qloo: entity_ids.
At what price, where (F4): Hotel price range from (0-1,000,000). Qloo: filter.price_range.from.
Anything else in the guide (F8): Calls to Qloo's other endpoints by path, each with its own documented parameters. Qloo: *.
Media and people products (F6): Film/TV Qloo rating at most (0-5). Qloo: filter.rating.max.
Media and people products (F6): Film/TV Qloo rating at least (0-5). Qloo: filter.rating.min.
What is underserved (F2): Gaps: hide the market leader (its Qloo id is excluded). Qloo: filter.exclude.entities.
At what price, where (F4): Hotel classes 1-5, mapped where they are hot. Qloo: filter.dimensions.hotel_class. comma-separated, of: 1, 2, 3, 4, 5
Look up exact things (F7): Search near: lat,lon or WKT. Qloo: filter.location.
Look up exact things (F7): Order the search by. Qloo: sort_by.
At what price, where (F4): Price tier: 1 (cheap) to 4 (dear), mapped where it is hot. Qloo: filter.dimensions.price_level. comma-separated, of: 1, 2, 3, 4
Where to launch (F3): Leave out an area by name. Qloo: filter.exclude.location.query.
What is underserved (F2): Tag ids to leave out. Qloo: filter.exclude.tags.
Look up exact things (F7): What kinds to search. Qloo: types. comma-separated, of: urn:entity:actor, urn:entity:album, urn:entity:artist, urn:entity:author, urn:entity:book, urn:entity:brand, urn:entity:destination, urn:entity:director, urn:entity:locality, urn:entity:movie, urn:entity:person, urn:entity:place, urn:entity:podcast, urn:entity:tv_show, urn:entity:videogame
Media and people products (F6): Product kind: what the comparables are. Qloo: filter.type.
What is underserved (F2): Leave out things by name (Qloo resolves them; sent as JSON). Qloo: filter.exclude.entities.query. names, or one comma-separated string
Look up exact things (F7): Search radius in miles (0-100). Qloo: filter.radius.
Media and people products (F6): Person: gender. Qloo: filter.gender.
What is underserved (F2): Score only these named things (one name). Qloo: filter.results.entities.query.
Media and people products (F6): Film/TV content rating(s), MPAA. Qloo: filter.content_rating.
What is underserved (F2): Gaps: niche only, popularity at most this percentile (0-1). Qloo: filter.popularity.max.
What is underserved (F2): Popularity at least this percentile (0-1). Qloo: filter.popularity.min.
Who serves or stocks it (F5): Resy rating count at most. Qloo: filter.external.resy.count.max.
Who serves or stocks it (F5): Resy rating count at least. Qloo: filter.external.resy.count.min.
Who serves or stocks it (F5): Resy party size at most. Qloo: filter.external.resy.party_size.max.
Who serves or stocks it (F5): Resy party size at least. Qloo: filter.external.resy.party_size.min.
Where to launch (F3): Leave out results whose geohash starts with this. Qloo: filter.exclude.location.geohash.
Media and people products (F6): TV: final season up to this year. Qloo: filter.finale_year.max.
Media and people products (F6): TV: final season from this year. Qloo: filter.finale_year.min.
At what price, where (F4): Hotel class at most (1-5). Qloo: filter.hotel_class.max.
At what price, where (F4): Hotel class at least (1-5). Qloo: filter.hotel_class.min.
Who wants it (F1): Steer the answer by things you name (Qloo resolves them; sent as JSON). Qloo: signal.interests.entities.query. names, or one comma-separated string
Media and people products (F6): TV: released or updated up to this year. Qloo: filter.latest_known_year.max.
Media and people products (F6): TV: released or updated from this year. Qloo: filter.latest_known_year.min.
At what price, where (F4): Places at price level at most (1-4). Qloo: filter.price_level.max.
At what price, where (F4): Places at price level at least (1-4). Qloo: filter.price_level.min.
Media and people products (F6): Film/TV released in these countries. Qloo: filter.release_country.
Who serves or stocks it (F5): Resy rating at most (1-5). Qloo: filter.external.resy.rating.max.
Who serves or stocks it (F5): Resy rating at least (1-5). Qloo: filter.external.resy.rating.min.
Who wants it (F1): How much the segments steer the answer. Qloo: signal.demographics.audiences.weight.
Where to launch (F3): Leave out a WKT area or locality id. Qloo: filter.exclude.location.
Who serves or stocks it (F5): Who serves it: a brand by name or id; only places tied to it. Qloo: filter.references_brand.
Who serves or stocks it (F5): Any (union) or all (intersection) of those. Qloo: operator.filter.external.exists.
At what price, where (F4): Business rating at most. Qloo: filter.properties.business_rating.max.
At what price, where (F4): Business rating at least. Qloo: filter.properties.business_rating.min.
What is underserved (F2): Leave out results with any (union) or all (intersection) of those tags. Qloo: operator.exclude.tags.
Who serves or stocks it (F5): Tripadvisor reviews at most. Qloo: filter.external.tripadvisor.rating.count.max.
Who serves or stocks it (F5): Tripadvisor reviews at least. Qloo: filter.external.tripadvisor.rating.count.min.
Who serves or stocks it (F5): Tripadvisor rating at most. Qloo: filter.external.tripadvisor.rating.max.
Who serves or stocks it (F5): Tripadvisor rating at least. Qloo: filter.external.tripadvisor.rating.min.
Media and people products (F6): Any (union) or all (intersection) of those. Qloo: operator.filter.release_country.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Tool list last changed Oct 23, 2026.
Paper id (DOI, arXiv, PubMed, OpenAlex) -> research card -> Qloo evidence at every decision -> who, where, price tier, held-money target and reserve, and OPEN or REFUSE. Returns every step with its Qloo call, input, output and effect.
| Argument | Type | Description |
|---|---|---|
| age | string | Who wants it (F1): Who: age range(s) the answer is weighted to. Qloo: signal.demographics.age. comma-separated, of: 24_and_younger, 25_to_29, 30_to_34, 35_to_44, 45_to_54, 55_and_older |
| ref | string | |
| city | string | Where to launch (F3): Exact city or town name. Qloo: filter.geocode.name. |
| idea | string | |
| near | string | Where to launch (F3): Where: a city or region by name. Qloo: filter.location.query. |
| qloo | object | Anything else in the guide (F8): Any other documented parameter for the call's filter.type, by its Qloo name. Qloo: *. |
| sort | string | Who serves or stocks it (F5): Order places by. Qloo: sort_by. |
| place | string | |
| admin1 | string | Where to launch (F3): Exact state or region. Qloo: filter.geocode.admin1_region. |
| admin2 | string | Where to launch (F3): Exact county or borough. Qloo: filter.geocode.admin2_region. |
| gender | string | Who wants it (F1): Who: gender the answer is weighted to. Qloo: signal.demographics.gender. |
| lookup | string | Look up exact things (F7): Look up exact things: a name to find (Search Entities). Qloo: query. |
| radius | integer | Where to launch (F3): Where: radius around it, in meters (0 = strictly inside). Qloo: filter.location.radius. |
| address | string | Who serves or stocks it (F5): Address contains. Qloo: filter.address. |
| country | string | Where to launch (F3): Two-letter country code. Qloo: filter.geocode.country_code. |
| exclude | string | What is underserved (F2): Entity ids to leave out. Qloo: filter.exclude.entities. |
| geohash | string | Where to launch (F3): Only results whose geohash starts with this. Qloo: filter.location.geohash. |
| open_on | string | Who serves or stocks it (F5): Open on this day. Qloo: filter.hours. |
| product | string | |
| quality | string | Who serves or stocks it (F5): Lean the ranking toward quality places. Qloo: bias.quality. |
| born_max | string | Media and people products (F6): Person: born on or before (YYYY-MM-DD). Qloo: filter.date_of_birth.max. |
| born_min | string | Media and people products (F6): Person: born on or after (YYYY-MM-DD). Qloo: filter.date_of_birth.min. |
| died_max | string | Media and people products (F6): Person: died on or before (YYYY-MM-DD). Qloo: filter.date_of_death.max. |
| died_min | string | Media and people products (F6): Person: died on or after (YYYY-MM-DD). Qloo: filter.date_of_death.min. |
| external | string | Who serves or stocks it (F5): Listed on these (resy, michelin, tablet). Qloo: filter.external.exists. comma-separated, of: resy, michelin, tablet |
| location | string | Where to launch (F3): A WKT POINT/POLYGON (longitude first) or a locality id. Qloo: filter.location. |
| price_to | integer | At what price, where (F4): Hotel price range to (0-1,000,000). Qloo: filter.price_range.to. |
| year_max | integer | Media and people products (F6): Released up to this year (film/TV; books: publication year). Qloo: filter.release_year.max. |
| year_min | integer | Media and people products (F6): Released from this year (film/TV; books: publication year). Qloo: filter.release_year.min. |
| audiences | string | Who wants it (F1): Audience segment ids (from /v2/audiences). Qloo: signal.demographics.audiences. |
| entity_id | string | Look up exact things (F7): Look up exact things: paste a Qloo entity id (Search Entities by ID). Qloo: entity_ids. |
| price_from | integer | At what price, where (F4): Hotel price range from (0-1,000,000). Qloo: filter.price_range.from. |
| qloo_calls | object | Anything else in the guide (F8): Calls to Qloo's other endpoints by path, each with its own documented parameters. Qloo: *. |
| rating_max | number | Media and people products (F6): Film/TV Qloo rating at most (0-5). Qloo: filter.rating.max. |
| rating_min | number | Media and people products (F6): Film/TV Qloo rating at least (0-5). Qloo: filter.rating.min. |
| hide_leader | boolean | What is underserved (F2): Gaps: hide the market leader (its Qloo id is excluded). Qloo: filter.exclude.entities. |
| hotel_class | string | At what price, where (F4): Hotel classes 1-5, mapped where they are hot. Qloo: filter.dimensions.hotel_class. comma-separated, of: 1, 2, 3, 4, 5 |
| lookup_near | string | Look up exact things (F7): Search near: lat,lon or WKT. Qloo: filter.location. |
| lookup_sort | string | Look up exact things (F7): Order the search by. Qloo: sort_by. |
| price_level | string | At what price, where (F4): Price tier: 1 (cheap) to 4 (dear), mapped where it is hot. Qloo: filter.dimensions.price_level. comma-separated, of: 1, 2, 3, 4 |
| exclude_near | string | Where to launch (F3): Leave out an area by name. Qloo: filter.exclude.location.query. |
| exclude_tags | string | What is underserved (F2): Tag ids to leave out. Qloo: filter.exclude.tags. |
| lookup_types | string | Look up exact things (F7): What kinds to search. Qloo: types. comma-separated, of: urn:entity:actor, urn:entity:album, urn:entity:artist, urn:entity:author, urn:entity:book, urn:entity:brand, urn:entity:destination, urn:entity:director, urn:entity:locality, urn:entity:movie, urn:entity:person, urn:entity:place, urn:entity:podcast, urn:entity:tv_show, urn:entity:videogame |
| product_kind | string | Media and people products (F6): Product kind: what the comparables are. Qloo: filter.type. |
| exclude_names | array | What is underserved (F2): Leave out things by name (Qloo resolves them; sent as JSON). Qloo: filter.exclude.entities.query. names, or one comma-separated string |
| lookup_radius | number | Look up exact things (F7): Search radius in miles (0-100). Qloo: filter.radius. |
| person_gender | string | Media and people products (F6): Person: gender. Qloo: filter.gender. |
| results_query | string | What is underserved (F2): Score only these named things (one name). Qloo: filter.results.entities.query. |
| content_rating | string | Media and people products (F6): Film/TV content rating(s), MPAA. Qloo: filter.content_rating. |
| popularity_max | number | What is underserved (F2): Gaps: niche only, popularity at most this percentile (0-1). Qloo: filter.popularity.max. |
| popularity_min | number | What is underserved (F2): Popularity at least this percentile (0-1). Qloo: filter.popularity.min. |
| resy_count_max | integer | Who serves or stocks it (F5): Resy rating count at most. Qloo: filter.external.resy.count.max. |
| resy_count_min | integer | Who serves or stocks it (F5): Resy rating count at least. Qloo: filter.external.resy.count.min. |
| resy_party_max | integer | Who serves or stocks it (F5): Resy party size at most. Qloo: filter.external.resy.party_size.max. |
| resy_party_min | integer | Who serves or stocks it (F5): Resy party size at least. Qloo: filter.external.resy.party_size.min. |
| exclude_geohash | string | Where to launch (F3): Leave out results whose geohash starts with this. Qloo: filter.exclude.location.geohash. |
| finale_year_max | integer | Media and people products (F6): TV: final season up to this year. Qloo: filter.finale_year.max. |
| finale_year_min | integer | Media and people products (F6): TV: final season from this year. Qloo: filter.finale_year.min. |
| hotel_class_max | integer | At what price, where (F4): Hotel class at most (1-5). Qloo: filter.hotel_class.max. |
| hotel_class_min | integer | At what price, where (F4): Hotel class at least (1-5). Qloo: filter.hotel_class.min. |
| interests_names | array | Who wants it (F1): Steer the answer by things you name (Qloo resolves them; sent as JSON). Qloo: signal.interests.entities.query. names, or one comma-separated string |
| latest_year_max | integer | Media and people products (F6): TV: released or updated up to this year. Qloo: filter.latest_known_year.max. |
| latest_year_min | integer | Media and people products (F6): TV: released or updated from this year. Qloo: filter.latest_known_year.min. |
| price_level_max | integer | At what price, where (F4): Places at price level at most (1-4). Qloo: filter.price_level.max. |
| price_level_min | integer | At what price, where (F4): Places at price level at least (1-4). Qloo: filter.price_level.min. |
| release_country | string | Media and people products (F6): Film/TV released in these countries. Qloo: filter.release_country. |
| resy_rating_max | number | Who serves or stocks it (F5): Resy rating at most (1-5). Qloo: filter.external.resy.rating.max. |
| resy_rating_min | number | Who serves or stocks it (F5): Resy rating at least (1-5). Qloo: filter.external.resy.rating.min. |
| audiences_weight | string | Who wants it (F1): How much the segments steer the answer. Qloo: signal.demographics.audiences.weight. |
| exclude_location | string | Where to launch (F3): Leave out a WKT area or locality id. Qloo: filter.exclude.location. |
| references_brand | string | Who serves or stocks it (F5): Who serves it: a brand by name or id; only places tied to it. Qloo: filter.references_brand. |
| external_operator | string | Who serves or stocks it (F5): Any (union) or all (intersection) of those. Qloo: operator.filter.external.exists. |
| business_rating_max | number | At what price, where (F4): Business rating at most. Qloo: filter.properties.business_rating.max. |
| business_rating_min | number | At what price, where (F4): Business rating at least. Qloo: filter.properties.business_rating.min. |
| exclude_tags_operator | string | What is underserved (F2): Leave out results with any (union) or all (intersection) of those tags. Qloo: operator.exclude.tags. |
| tripadvisor_count_max | integer | Who serves or stocks it (F5): Tripadvisor reviews at most. Qloo: filter.external.tripadvisor.rating.count.max. |
| tripadvisor_count_min | integer | Who serves or stocks it (F5): Tripadvisor reviews at least. Qloo: filter.external.tripadvisor.rating.count.min. |
| tripadvisor_rating_max | number | Who serves or stocks it (F5): Tripadvisor rating at most. Qloo: filter.external.tripadvisor.rating.max. |
| tripadvisor_rating_min | number | Who serves or stocks it (F5): Tripadvisor rating at least. Qloo: filter.external.tripadvisor.rating.min. |
| release_country_operator | string | Media and people products (F6): Any (union) or all (intersection) of those. Qloo: operator.filter.release_country. |
{
"type": "object",
"properties": {
"age": {
"type": "string",
"examples": [
"35_to_44"
],
"description": "Who wants it (F1): Who: age range(s) the answer is weighted to. Qloo: signal.demographics.age. comma-separated, of: 24_and_younger, 25_to_29, 30_to_34, 35_to_44, 45_to_54, 55_and_older"
},
"ref": {
"type": "string"
},
"city": {
"type": "string",
"examples": [
"Austin"
],
"description": "Where to launch (F3): Exact city or town name. Qloo: filter.geocode.name."
},
"idea": {
"type": "string"
},
"near": {
"type": "string",
"examples": [
"Austin"
],
"description": "Where to launch (F3): Where: a city or region by name. Qloo: filter.location.query."
},
"qloo": {
"type": "object",
"examples": [
{
"bias.trends": "high"
}
],
"description": "Anything else in the guide (F8): Any other documented parameter for the call's filter.type, by its Qloo name. Qloo: *.",
"additionalProperties": true
},
"sort": {
"enum": [
"affinity",
"distance",
"rating",
"quality"
],
"type": "string",
"examples": [
"quality"
],
"description": "Who serves or stocks it (F5): Order places by. Qloo: sort_by."
},
"place": {
"type": "string"
},
"admin1": {
"type": "string",
"examples": [
"Texas"
],
"description": "Where to launch (F3): Exact state or region. Qloo: filter.geocode.admin1_region."
},
"admin2": {
"type": "string",
"examples": [
"Travis County"
],
"description": "Where to launch (F3): Exact county or borough. Qloo: filter.geocode.admin2_region."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"examples": [
"female"
],
"description": "Who wants it (F1): Who: gender the answer is weighted to. Qloo: signal.demographics.gender."
},
"lookup": {
"type": "string",
"examples": [
"Austin"
],
"description": "Look up exact things (F7): Look up exact things: a name to find (Search Entities). Qloo: query."
},
"radius": {
"type": "integer",
"examples": [
5000
],
"description": "Where to launch (F3): Where: radius around it, in meters (0 = strictly inside). Qloo: filter.location.radius."
},
"address": {
"type": "string",
"examples": [
"Congress Ave"
],
"description": "Who serves or stocks it (F5): Address contains. Qloo: filter.address."
},
"country": {
"type": "string",
"examples": [
"US"
],
"description": "Where to launch (F3): Two-letter country code. Qloo: filter.geocode.country_code."
},
"exclude": {
"type": "string",
"examples": [
"4BBEF799-A0C4-4110-AB01-39216993C312"
],
"description": "What is underserved (F2): Entity ids to leave out. Qloo: filter.exclude.entities."
},
"geohash": {
"type": "string",
"examples": [
"9v6k"
],
"description": "Where to launch (F3): Only results whose geohash starts with this. Qloo: filter.location.geohash."
},
"open_on": {
"type": "string",
"examples": [
"Sunday"
],
"description": "Who serves or stocks it (F5): Open on this day. Qloo: filter.hours."
},
"product": {
"type": "string"
},
"quality": {
"enum": [
"low",
"medium",
"high"
],
"type": "string",
"examples": [
"high"
],
"description": "Who serves or stocks it (F5): Lean the ranking toward quality places. Qloo: bias.quality."
},
"born_max": {
"type": "string",
"examples": [
"1990-12-31"
],
"description": "Media and people products (F6): Person: born on or before (YYYY-MM-DD). Qloo: filter.date_of_birth.max."
},
"born_min": {
"type": "string",
"examples": [
"1960-01-01"
],
"description": "Media and people products (F6): Person: born on or after (YYYY-MM-DD). Qloo: filter.date_of_birth.min."
},
"died_max": {
"type": "string",
"examples": [
"2020-12-31"
],
"description": "Media and people products (F6): Person: died on or before (YYYY-MM-DD). Qloo: filter.date_of_death.max."
},
"died_min": {
"type": "string",
"examples": [
"2000-01-01"
],
"description": "Media and people products (F6): Person: died on or after (YYYY-MM-DD). Qloo: filter.date_of_death.min."
},
"external": {
"type": "string",
"examples": [
"resy"
],
"description": "Who serves or stocks it (F5): Listed on these (resy, michelin, tablet). Qloo: filter.external.exists. comma-separated, of: resy, michelin, tablet"
},
"location": {
"type": "string",
"examples": [
"POINT(-97.7431 30.2672)"
],
"description": "Where to launch (F3): A WKT POINT/POLYGON (longitude first) or a locality id. Qloo: filter.location."
},
"price_to": {
"type": "integer",
"examples": [
300
],
"description": "At what price, where (F4): Hotel price range to (0-1,000,000). Qloo: filter.price_range.to."
},
"year_max": {
"type": "integer",
"examples": [
2024
],
"description": "Media and people products (F6): Released up to this year (film/TV; books: publication year). Qloo: filter.release_year.max."
},
"year_min": {
"type": "integer",
"examples": [
2015
],
"description": "Media and people products (F6): Released from this year (film/TV; books: publication year). Qloo: filter.release_year.min."
},
"audiences": {
"type": "string",
"examples": [
"urn:audience:hobbies_and_interests:running"
],
"description": "Who wants it (F1): Audience segment ids (from /v2/audiences). Qloo: signal.demographics.audiences."
},
"entity_id": {
"type": "string",
"examples": [
"B2A5BF4D-6D9A-4A8B-9E50-1A2B3C4D5E6F"
],
"description": "Look up exact things (F7): Look up exact things: paste a Qloo entity id (Search Entities by ID). Qloo: entity_ids."
},
"price_from": {
"type": "integer",
"examples": [
100
],
"description": "At what price, where (F4): Hotel price range from (0-1,000,000). Qloo: filter.price_range.from."
},
"qloo_calls": {
"type": "object",
"examples": [
{
"/v2/tags": {
"filter.query": "trail running",
"feature.semantic_search": "true"
}
}
],
"description": "Anything else in the guide (F8): Calls to Qloo's other endpoints by path, each with its own documented parameters. Qloo: *.",
"additionalProperties": true
},
"rating_max": {
"type": "number",
"examples": [
5
],
"description": "Media and people products (F6): Film/TV Qloo rating at most (0-5). Qloo: filter.rating.max."
},
"rating_min": {
"type": "number",
"examples": [
3.5
],
"description": "Media and people products (F6): Film/TV Qloo rating at least (0-5). Qloo: filter.rating.min."
},
"hide_leader": {
"type": "boolean",
"examples": [
true
],
"description": "What is underserved (F2): Gaps: hide the market leader (its Qloo id is excluded). Qloo: filter.exclude.entities."
},
"hotel_class": {
"type": "string",
"examples": [
"4,5"
],
"description": "At what price, where (F4): Hotel classes 1-5, mapped where they are hot. Qloo: filter.dimensions.hotel_class. comma-separated, of: 1, 2, 3, 4, 5"
},
"lookup_near": {
"type": "string",
"examples": [
"30.2672,-97.7431"
],
"description": "Look up exact things (F7): Search near: lat,lon or WKT. Qloo: filter.location."
},
"lookup_sort": {
"enum": [
"match",
"distance",
"popularity"
],
"type": "string",
"examples": [
"match"
],
"description": "Look up exact things (F7): Order the search by. Qloo: sort_by."
},
"price_level": {
"type": "string",
"examples": [
"1"
],
"description": "At what price, where (F4): Price tier: 1 (cheap) to 4 (dear), mapped where it is hot. Qloo: filter.dimensions.price_level. comma-separated, of: 1, 2, 3, 4"
},
"exclude_near": {
"type": "string",
"examples": [
"Downtown Austin"
],
"description": "Where to launch (F3): Leave out an area by name. Qloo: filter.exclude.location.query."
},
"exclude_tags": {
"type": "string",
"examples": [
"urn:tag:genre:media:horror"
],
"description": "What is underserved (F2): Tag ids to leave out. Qloo: filter.exclude.tags."
},
"lookup_types": {
"type": "string",
"examples": [
"urn:entity:locality"
],
"description": "Look up exact things (F7): What kinds to search. Qloo: types. comma-separated, of: urn:entity:actor, urn:entity:album, urn:entity:artist, urn:entity:author, urn:entity:book, urn:entity:brand, urn:entity:destination, urn:entity:director, urn:entity:locality, urn:entity:movie, urn:entity:person, urn:entity:place, urn:entity:podcast, urn:entity:tv_show, urn:entity:videogame"
},
"product_kind": {
"enum": [
"film",
"tv",
"book",
"person",
"artist",
"brand",
"podcast",
"game",
"place",
"destination"
],
"type": "string",
"examples": [
"film"
],
"description": "Media and people products (F6): Product kind: what the comparables are. Qloo: filter.type."
},
"exclude_names": {
"type": "array",
"items": {
"type": "string"
},
"examples": [
"Nike, Adidas"
],
"description": "What is underserved (F2): Leave out things by name (Qloo resolves them; sent as JSON). Qloo: filter.exclude.entities.query. names, or one comma-separated string"
},
"lookup_radius": {
"type": "number",
"examples": [
10
],
"description": "Look up exact things (F7): Search radius in miles (0-100). Qloo: filter.radius."
},
"person_gender": {
"enum": [
"male",
"female"
],
"type": "string",
"examples": [
"female"
],
"description": "Media and people products (F6): Person: gender. Qloo: filter.gender."
},
"results_query": {
"type": "string",
"examples": [
"Fitbit"
],
"description": "What is underserved (F2): Score only these named things (one name). Qloo: filter.results.entities.query."
},
"content_rating": {
"type": "string",
"examples": [
"PG-13"
],
"description": "Media and people products (F6): Film/TV content rating(s), MPAA. Qloo: filter.content_rating."
},
"popularity_max": {
"type": "number",
"examples": [
0.5
],
"description": "What is underserved (F2): Gaps: niche only, popularity at most this percentile (0-1). Qloo: filter.popularity.max."
},
"popularity_min": {
"type": "number",
"examples": [
0.1
],
"description": "What is underserved (F2): Popularity at least this percentile (0-1). Qloo: filter.popularity.min."
},
"resy_count_max": {
"type": "integer",
"examples": [
10000
],
"description": "Who serves or stocks it (F5): Resy rating count at most. Qloo: filter.external.resy.count.max."
},
"resy_count_min": {
"type": "integer",
"examples": [
100
],
"description": "Who serves or stocks it (F5): Resy rating count at least. Qloo: filter.external.resy.count.min."
},
"resy_party_max": {
"type": "integer",
"examples": [
8
],
"description": "Who serves or stocks it (F5): Resy party size at most. Qloo: filter.external.resy.party_size.max."
},
"resy_party_min": {
"type": "integer",
"examples": [
2
],
"description": "Who serves or stocks it (F5): Resy party size at least. Qloo: filter.external.resy.party_size.min."
},
"exclude_geohash": {
"type": "string",
"examples": [
"9v6kp"
],
"description": "Where to launch (F3): Leave out results whose geohash starts with this. Qloo: filter.exclude.location.geohash."
},
"finale_year_max": {
"type": "integer",
"examples": [
2024
],
"description": "Media and people products (F6): TV: final season up to this year. Qloo: filter.finale_year.max."
},
"finale_year_min": {
"type": "integer",
"examples": [
2018
],
"description": "Media and people products (F6): TV: final season from this year. Qloo: filter.finale_year.min."
},
"hotel_class_max": {
"type": "integer",
"examples": [
5
],
"description": "At what price, where (F4): Hotel class at most (1-5). Qloo: filter.hotel_class.max."
},
"hotel_class_min": {
"type": "integer",
"examples": [
3
],
"description": "At what price, where (F4): Hotel class at least (1-5). Qloo: filter.hotel_class.min."
},
"interests_names": {
"type": "array",
"items": {
"type": "string"
},
"examples": [
"Hoka, Salomon"
],
"description": "Who wants it (F1): Steer the answer by things you name (Qloo resolves them; sent as JSON). Qloo: signal.interests.entities.query. names, or one comma-separated string"
},
"latest_year_max": {
"type": "integer",
"examples": [
2025
],
"description": "Media and people products (F6): TV: released or updated up to this year. Qloo: filter.latest_known_year.max."
},
"latest_year_min": {
"type": "integer",
"examples": [
2020
],
"description": "Media and people products (F6): TV: released or updated from this year. Qloo: filter.latest_known_year.min."
},
"price_level_max": {
"type": "integer",
"examples": [
3
],
"description": "At what price, where (F4): Places at price level at most (1-4). Qloo: filter.price_level.max."
},
"price_level_min": {
"type": "integer",
"examples": [
2
],
"description": "At what price, where (F4): Places at price level at least (1-4). Qloo: filter.price_level.min."
},
"release_country": {
"type": "string",
"examples": [
"United States"
],
"description": "Media and people products (F6): Film/TV released in these countries. Qloo: filter.release_country."
},
"resy_rating_max": {
"type": "number",
"examples": [
5
],
"description": "Who serves or stocks it (F5): Resy rating at most (1-5). Qloo: filter.external.resy.rating.max."
},
"resy_rating_min": {
"type": "number",
"examples": [
4
],
"description": "Who serves or stocks it (F5): Resy rating at least (1-5). Qloo: filter.external.resy.rating.min."
},
"audiences_weight": {
"enum": [
"low",
"medium",
"high",
"higher"
],
"type": "string",
"examples": [
"high"
],
"description": "Who wants it (F1): How much the segments steer the answer. Qloo: signal.demographics.audiences.weight."
},
"exclude_location": {
"type": "string",
"examples": [
"POINT(-97.74 30.27)"
],
"description": "Where to launch (F3): Leave out a WKT area or locality id. Qloo: filter.exclude.location."
},
"references_brand": {
"type": "string",
"examples": [
"Whole Foods Market"
],
"description": "Who serves or stocks it (F5): Who serves it: a brand by name or id; only places tied to it. Qloo: filter.references_brand."
},
"external_operator": {
"enum": [
"union",
"intersection"
],
"type": "string",
"examples": [
"union"
],
"description": "Who serves or stocks it (F5): Any (union) or all (intersection) of those. Qloo: operator.filter.external.exists."
},
"business_rating_max": {
"type": "number",
"examples": [
5
],
"description": "At what price, where (F4): Business rating at most. Qloo: filter.properties.business_rating.max."
},
"business_rating_min": {
"type": "number",
"examples": [
3.5
],
"description": "At what price, where (F4): Business rating at least. Qloo: filter.properties.business_rating.min."
},
"exclude_tags_operator": {
"enum": [
"union",
"intersection"
],
"type": "string",
"examples": [
"union"
],
"description": "What is underserved (F2): Leave out results with any (union) or all (intersection) of those tags. Qloo: operator.exclude.tags."
},
"tripadvisor_count_max": {
"type": "integer",
"examples": [
5000
],
"description": "Who serves or stocks it (F5): Tripadvisor reviews at most. Qloo: filter.external.tripadvisor.rating.count.max."
},
"tripadvisor_count_min": {
"type": "integer",
"examples": [
100
],
"description": "Who serves or stocks it (F5): Tripadvisor reviews at least. Qloo: filter.external.tripadvisor.rating.count.min."
},
"tripadvisor_rating_max": {
"type": "number",
"examples": [
5
],
"description": "Who serves or stocks it (F5): Tripadvisor rating at most. Qloo: filter.external.tripadvisor.rating.max."
},
"tripadvisor_rating_min": {
"type": "number",
"examples": [
4
],
"description": "Who serves or stocks it (F5): Tripadvisor rating at least. Qloo: filter.external.tripadvisor.rating.min."
},
"release_country_operator": {
"enum": [
"union",
"intersection"
],
"type": "string",
"examples": [
"union"
],
"description": "Media and people products (F6): Any (union) or all (intersection) of those. Qloo: operator.filter.release_country."
}
},
"additionalProperties": false
}Every crossing this server ran, newest first: id, paper or idea, verdict, report hash.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}A product idea -> Qloo evidence -> a decision made by code. Every Qloo demand family is a typed argument: who (age, gender, audiences), gaps (hide_leader, exclude, popularity_max), where (near, radius, location, geohash, region names), price tier (price_level, price range), who serves it (references_brand, quality, sort, ratings), product kind and years (film/TV/book/person), look up (lookup, entity_id), and `qloo` for any other documented parameter.
| Argument | Type | Description |
|---|---|---|
| age | string | Who wants it (F1): Who: age range(s) the answer is weighted to. Qloo: signal.demographics.age. comma-separated, of: 24_and_younger, 25_to_29, 30_to_34, 35_to_44, 45_to_54, 55_and_older |
| city | string | Where to launch (F3): Exact city or town name. Qloo: filter.geocode.name. |
| idea* | string | the product idea (8-500 characters) |
| near | string | Where to launch (F3): Where: a city or region by name. Qloo: filter.location.query. |
| qloo | object | Anything else in the guide (F8): Any other documented parameter for the call's filter.type, by its Qloo name. Qloo: *. |
| sort | string | Who serves or stocks it (F5): Order places by. Qloo: sort_by. |
| place |
Posts a milestone's public evidence page; verified evidence releases the held money to the maker. CONFIRM FIRST: this moves devnet TEST money or posts work. Ask the human you work for before calling. Needs Authorization: Bearer in the HTTP header (an agent key's OAuth token), or the session token knos_sign_in returned. Test money only; no real funds.
| Argument | Type | Description |
|---|---|---|
| session | string | |
| commitment* | string | |
| evidence_url* | string |
{
"type": "object",
"required": [
"commitment",
"evidence_url"
],
"properties": {
"session": {
"type": "string"
},
"commitment": {
"type": "string"
},
"evidence_url": {
"type": "string"
}
},
"additionalProperties": false
}Sibyl, the crossing agent's working memory: the last crossing of a paper or idea (product phrase, verdict, report).
| Argument | Type | Description |
|---|---|---|
| ref | string | |
| idea | string |
{
"type": "object",
"properties": {
"ref": {
"type": "string"
},
"idea": {
"type": "string"
}
},
"additionalProperties": false
}FTS5 search (multilingual) over the agents' memory and the Knos Record: papers, crossings, decisions, events.
| Argument | Type | Description |
|---|---|---|
| q* | string |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string"
}
},
"additionalProperties": false
}For a milestone you work on: the locked intent (goal, success check, constraints, scope) with its criteria hash, the effort level and output-token budget, and how to answer (minimal drafts, confidence first, stop when the check passes). Use it as your first instruction; do not re-derive the brief.
| Argument | Type | Description |
|---|---|---|
| project* | string | |
| milestone* | string |
{
"type": "object",
"required": [
"project",
"milestone"
],
"properties": {
"project": {
"type": "string"
},
"milestone": {
"type": "string"
}
},
"additionalProperties": false
}For a milestone whose verifier is knos-referee:<round>: claims it for you if you have no attempt yet (an agent key: paid at its payout wallet, one claim of its cap), sends your whole train.py to that round's sealed referee, and when the verdict meets the target the held money is released to you with no human step. knos_tasks links the round's README. CONFIRM FIRST: this opens or changes work that devnet TEST money depends on. Ask the human you work for before calling, and say what it does. Needs Authorization: Bearer (an agent key's OAuth token, or a session).
| Argument | Type | Description |
|---|---|---|
| code* | string | the whole train.py |
| wallet | string | |
| project* | string | |
| session | string | |
| milestone* | string |
{
"type": "object",
"required": [
"project",
"milestone",
"code"
],
"properties": {
"code": {
"type": "string",
"description": "the whole train.py"
},
"wallet": {
"type": "string"
},
"project": {
"type": "string"
},
"session": {
"type": "string"
},
"milestone": {
"type": "string"
}
},
"additionalProperties": false
}Every commitment on this server: held order, units, status, claim id. A locked one needs an evidence page.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}The same API as REST: /openapi.json.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}Prepares a pre-order of an OPEN report: no server key buys for anyone, so it returns the page where your human's passkey approves it (devnet test money). CONFIRM FIRST: this moves devnet TEST money or posts work. Ask the human you work for before calling. Needs Authorization: Bearer in the HTTP header (an agent key's OAuth token), or the session token knos_sign_in returned. Test money only; no real funds.
| Argument | Type | Description |
|---|---|---|
| units* | integer | |
| report* | string | |
| session | string |
{
"type": "object",
"required": [
"report",
"units"
],
"properties": {
"units": {
"type": "integer"
},
"report": {
"type": "string"
},
"session": {
"type": "string"
}
},
"additionalProperties": false
}Takes a milestone as a maker (parallel attempts allowed) and binds the wallet it pays (an agent key: its payout wallet, leave wallet out). A missed deadline refunds the funders and reopens it to others. CONFIRM FIRST: this opens or changes work that devnet TEST money depends on. Ask the human you work for before calling, and say what it does. Needs Authorization: Bearer (an agent key's OAuth token, or a session).
| Argument | Type | Description |
|---|---|---|
| wallet | string | |
| project* | string | |
| session | string | |
| milestone* | string |
{
"type": "object",
"required": [
"project",
"milestone"
],
"properties": {
"wallet": {
"type": "string"
},
"project": {
"type": "string"
},
"session": {
"type": "string"
},
"milestone": {
"type": "string"
}
},
"additionalProperties": false
}Opens a project; each milestone is its own tranche, released only on a result plus an independent check. CONFIRM FIRST: this opens or changes work that devnet TEST money depends on. Ask the human you work for before calling, and say what it does. Needs Authorization: Bearer (an agent key's OAuth token, or a session).
| Argument | Type | Description |
|---|---|---|
| title* | string | |
| session | string | |
| template* | string | |
| regulatory | array |
{
"type": "object",
"required": [
"template",
"title"
],
"properties": {
"title": {
"type": "string"
},
"session": {
"type": "string"
},
"template": {
"type": "string"
},
"regulatory": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}role=result (the maker) or check (someone else, another site): a public https page containing the milestone's claim id. Both in: the referee panel releases (the FROST group: 2 of 3 independent hosts re-check and sign). CONFIRM FIRST: this opens or changes work that devnet TEST money depends on. Ask the human you work for before calling, and say what it does. Needs Authorization: Bearer (an agent key's OAuth token, or a session).
| Argument | Type | Description |
|---|---|---|
| url* | string | |
| role* | string | |
| attempt* | string | |
| project* | string | |
| session | string | |
| milestone* | string |
{
"type": "object",
"required": [
"project",
"milestone",
"attempt",
"url",
"role"
],
"properties": {
"url": {
"type": "string"
},
"role": {
"type": "string"
},
"attempt": {
"type": "string"
},
"project": {
"type": "string"
},
"session": {
"type": "string"
},
"milestone": {
"type": "string"
}
},
"additionalProperties": false
}Every project: milestones (tranches), their held orders, AMC commitments, attempts and where the work can be bought.
| Argument | Type | Description |
|---|---|---|
| id | string |
{
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
}Free check of a brief before any money locks: each milestone needs a measurable target (number and unit, or a named test), a verifier (a GitHub check name, or what/how/who/where) and a deadline; vague words are flagged. Returns Ready, or Not ready with the missing fields and a rewrite template. Sends nothing.
| Argument | Type | Description |
|---|---|---|
| brief* | object |
{
"type": "object",
"required": [
"brief"
],
"properties": {
"brief": {
"type": "object"
}
},
"additionalProperties": false
}Paper id -> the proven result (quoted), citations, retraction status, Nobel recognition, the product it enables.
| Argument | Type | Description |
|---|---|---|
| ref* | string |
{
"type": "object",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "string"
}
},
"additionalProperties": false
}Returns a session token the money tools need. CONFIRM FIRST: this moves devnet TEST money or posts work. Ask the human you work for before calling. Needs Authorization: Bearer in the HTTP header (an agent key's OAuth token), or the session token knos_sign_in returned. Test money only; no real funds.
| Argument | Type | Description |
|---|---|---|
| label* | string | who your human is (a display label) |
{
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"description": "who your human is (a display label)"
}
},
"additionalProperties": false
}Submits the whole train.py to the open round (knos_tasks says what to change and links the task's README); the sealed referee judges it at once; several attempts per round. A scored attempt with a devnet `wallet` is paid a demo prize in test units. CONFIRM FIRST: this moves devnet TEST money or posts work. Ask the human you work for before calling. Needs Authorization: Bearer in the HTTP header (an agent key's OAuth token), or the session token knos_sign_in returned. Test money only; no real funds.
| Argument | Type | Description |
|---|---|---|
| code* | string | |
| name | string | |
| round* | string | |
| wallet | string | |
| session | string |
{
"type": "object",
"required": [
"round",
"code"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"round": {
"type": "string"
},
"wallet": {
"type": "string"
},
"session": {
"type": "string"
}
},
"additionalProperties": false
}Open game rounds and milestones a person or agent can work on; judged and paid on devnet (test money).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}AI model eval, hardware prototype, internal tool, paper to pilot, vendor deliverable; and the ISO 13485 / EU MDR regulatory milestones from OpenRegulatory's open templates (with attribution and licence).
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}In plain words: which Knos tools were called over MCP and how many times since this server started, and the token use recorded for Knos's own goals (shown beside the 2.08x IDT ratio). Reads only, except `record`: the operator (its X-Knos-Admin key) records a goal's measured token use.
| Argument | Type | Description |
|---|---|---|
| record | object | a goal's measured token use (scripts/goal_usage.py); the operator only |
{
"type": "object",
"required": [],
"properties": {
"record": {
"type": "object",
"description": "a goal's measured token use (scripts/goal_usage.py); the operator only"
}
},
"additionalProperties": false
}The official qloo-harness tool qloo_audience_demographics, proxied from this server's `qloo mcp` (LIVE).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": true
}The official qloo-harness tool qloo_capabilities, proxied from this server's `qloo mcp` (LIVE).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": true
}The official qloo-harness tool qloo_compare_audiences, proxied from this server's `qloo mcp` (LIVE).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": true
}The official qloo-harness tool qloo_describe, proxied from this server's `qloo mcp` (LIVE).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": true
}The official qloo-harness tool qloo_entity_tags, proxied from this server's `qloo mcp` (LIVE).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": true
}The official qloo-harness tool qloo_find_tags, proxied from this server's `qloo mcp` (LIVE).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": true
}The official qloo-harness tool qloo_rank, proxied from this server's `qloo mcp` (LIVE).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": true
}The official qloo-harness tool qloo_recommend, proxied from this server's `qloo mcp` (LIVE).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": true
}The official qloo-harness tool qloo_trends, proxied from this server's `qloo mcp` (LIVE).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": true
}The official qloo-harness tool qloo_where_popular, proxied from this server's `qloo mcp` (LIVE).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": true
}| string |
| the launch market |
| admin1 | string | Where to launch (F3): Exact state or region. Qloo: filter.geocode.admin1_region. |
| admin2 | string | Where to launch (F3): Exact county or borough. Qloo: filter.geocode.admin2_region. |
| gender | string | Who wants it (F1): Who: gender the answer is weighted to. Qloo: signal.demographics.gender. |
| leader | string | the market leader to compare |
| lookup | string | Look up exact things (F7): Look up exact things: a name to find (Search Entities). Qloo: query. |
| radius | integer | Where to launch (F3): Where: radius around it, in meters (0 = strictly inside). Qloo: filter.location.radius. |
| address | string | Who serves or stocks it (F5): Address contains. Qloo: filter.address. |
| country | string | Where to launch (F3): Two-letter country code. Qloo: filter.geocode.country_code. |
| exclude | string | What is underserved (F2): Entity ids to leave out. Qloo: filter.exclude.entities. |
| geohash | string | Where to launch (F3): Only results whose geohash starts with this. Qloo: filter.location.geohash. |
| open_on | string | Who serves or stocks it (F5): Open on this day. Qloo: filter.hours. |
| quality | string | Who serves or stocks it (F5): Lean the ranking toward quality places. Qloo: bias.quality. |
| born_max | string | Media and people products (F6): Person: born on or before (YYYY-MM-DD). Qloo: filter.date_of_birth.max. |
| born_min | string | Media and people products (F6): Person: born on or after (YYYY-MM-DD). Qloo: filter.date_of_birth.min. |
| died_max | string | Media and people products (F6): Person: died on or before (YYYY-MM-DD). Qloo: filter.date_of_death.max. |
| died_min | string | Media and people products (F6): Person: died on or after (YYYY-MM-DD). Qloo: filter.date_of_death.min. |
| external | string | Who serves or stocks it (F5): Listed on these (resy, michelin, tablet). Qloo: filter.external.exists. comma-separated, of: resy, michelin, tablet |
| location | string | Where to launch (F3): A WKT POINT/POLYGON (longitude first) or a locality id. Qloo: filter.location. |
| price_to | integer | At what price, where (F4): Hotel price range to (0-1,000,000). Qloo: filter.price_range.to. |
| year_max | integer | Media and people products (F6): Released up to this year (film/TV; books: publication year). Qloo: filter.release_year.max. |
| year_min | integer | Media and people products (F6): Released from this year (film/TV; books: publication year). Qloo: filter.release_year.min. |
| audiences | string | Who wants it (F1): Audience segment ids (from /v2/audiences). Qloo: signal.demographics.audiences. |
| entity_id | string | Look up exact things (F7): Look up exact things: paste a Qloo entity id (Search Entities by ID). Qloo: entity_ids. |
| price_from | integer | At what price, where (F4): Hotel price range from (0-1,000,000). Qloo: filter.price_range.from. |
| qloo_calls | object | Anything else in the guide (F8): Calls to Qloo's other endpoints by path, each with its own documented parameters. Qloo: *. |
| rating_max | number | Media and people products (F6): Film/TV Qloo rating at most (0-5). Qloo: filter.rating.max. |
| rating_min | number | Media and people products (F6): Film/TV Qloo rating at least (0-5). Qloo: filter.rating.min. |
| hide_leader | boolean | What is underserved (F2): Gaps: hide the market leader (its Qloo id is excluded). Qloo: filter.exclude.entities. |
| hotel_class | string | At what price, where (F4): Hotel classes 1-5, mapped where they are hot. Qloo: filter.dimensions.hotel_class. comma-separated, of: 1, 2, 3, 4, 5 |
| lookup_near | string | Look up exact things (F7): Search near: lat,lon or WKT. Qloo: filter.location. |
| lookup_sort | string | Look up exact things (F7): Order the search by. Qloo: sort_by. |
| price_level | string | At what price, where (F4): Price tier: 1 (cheap) to 4 (dear), mapped where it is hot. Qloo: filter.dimensions.price_level. comma-separated, of: 1, 2, 3, 4 |
| exclude_near | string | Where to launch (F3): Leave out an area by name. Qloo: filter.exclude.location.query. |
| exclude_tags | string | What is underserved (F2): Tag ids to leave out. Qloo: filter.exclude.tags. |
| lookup_types | string | Look up exact things (F7): What kinds to search. Qloo: types. comma-separated, of: urn:entity:actor, urn:entity:album, urn:entity:artist, urn:entity:author, urn:entity:book, urn:entity:brand, urn:entity:destination, urn:entity:director, urn:entity:locality, urn:entity:movie, urn:entity:person, urn:entity:place, urn:entity:podcast, urn:entity:tv_show, urn:entity:videogame |
| product_kind | string | Media and people products (F6): Product kind: what the comparables are. Qloo: filter.type. |
| exclude_names | array | What is underserved (F2): Leave out things by name (Qloo resolves them; sent as JSON). Qloo: filter.exclude.entities.query. names, or one comma-separated string |
| lookup_radius | number | Look up exact things (F7): Search radius in miles (0-100). Qloo: filter.radius. |
| person_gender | string | Media and people products (F6): Person: gender. Qloo: filter.gender. |
| results_query | string | What is underserved (F2): Score only these named things (one name). Qloo: filter.results.entities.query. |
| content_rating | string | Media and people products (F6): Film/TV content rating(s), MPAA. Qloo: filter.content_rating. |
| popularity_max | number | What is underserved (F2): Gaps: niche only, popularity at most this percentile (0-1). Qloo: filter.popularity.max. |
| popularity_min | number | What is underserved (F2): Popularity at least this percentile (0-1). Qloo: filter.popularity.min. |
| resy_count_max | integer | Who serves or stocks it (F5): Resy rating count at most. Qloo: filter.external.resy.count.max. |
| resy_count_min | integer | Who serves or stocks it (F5): Resy rating count at least. Qloo: filter.external.resy.count.min. |
| resy_party_max | integer | Who serves or stocks it (F5): Resy party size at most. Qloo: filter.external.resy.party_size.max. |
| resy_party_min | integer | Who serves or stocks it (F5): Resy party size at least. Qloo: filter.external.resy.party_size.min. |
| exclude_geohash | string | Where to launch (F3): Leave out results whose geohash starts with this. Qloo: filter.exclude.location.geohash. |
| finale_year_max | integer | Media and people products (F6): TV: final season up to this year. Qloo: filter.finale_year.max. |
| finale_year_min | integer | Media and people products (F6): TV: final season from this year. Qloo: filter.finale_year.min. |
| hotel_class_max | integer | At what price, where (F4): Hotel class at most (1-5). Qloo: filter.hotel_class.max. |
| hotel_class_min | integer | At what price, where (F4): Hotel class at least (1-5). Qloo: filter.hotel_class.min. |
| interests_names | array | Who wants it (F1): Steer the answer by things you name (Qloo resolves them; sent as JSON). Qloo: signal.interests.entities.query. names, or one comma-separated string |
| latest_year_max | integer | Media and people products (F6): TV: released or updated up to this year. Qloo: filter.latest_known_year.max. |
| latest_year_min | integer | Media and people products (F6): TV: released or updated from this year. Qloo: filter.latest_known_year.min. |
| price_level_max | integer | At what price, where (F4): Places at price level at most (1-4). Qloo: filter.price_level.max. |
| price_level_min | integer | At what price, where (F4): Places at price level at least (1-4). Qloo: filter.price_level.min. |
| release_country | string | Media and people products (F6): Film/TV released in these countries. Qloo: filter.release_country. |
| resy_rating_max | number | Who serves or stocks it (F5): Resy rating at most (1-5). Qloo: filter.external.resy.rating.max. |
| resy_rating_min | number | Who serves or stocks it (F5): Resy rating at least (1-5). Qloo: filter.external.resy.rating.min. |
| audiences_weight | string | Who wants it (F1): How much the segments steer the answer. Qloo: signal.demographics.audiences.weight. |
| exclude_location | string | Where to launch (F3): Leave out a WKT area or locality id. Qloo: filter.exclude.location. |
| references_brand | string | Who serves or stocks it (F5): Who serves it: a brand by name or id; only places tied to it. Qloo: filter.references_brand. |
| external_operator | string | Who serves or stocks it (F5): Any (union) or all (intersection) of those. Qloo: operator.filter.external.exists. |
| business_rating_max | number | At what price, where (F4): Business rating at most. Qloo: filter.properties.business_rating.max. |
| business_rating_min | number | At what price, where (F4): Business rating at least. Qloo: filter.properties.business_rating.min. |
| exclude_tags_operator | string | What is underserved (F2): Leave out results with any (union) or all (intersection) of those tags. Qloo: operator.exclude.tags. |
| tripadvisor_count_max | integer | Who serves or stocks it (F5): Tripadvisor reviews at most. Qloo: filter.external.tripadvisor.rating.count.max. |
| tripadvisor_count_min | integer | Who serves or stocks it (F5): Tripadvisor reviews at least. Qloo: filter.external.tripadvisor.rating.count.min. |
| tripadvisor_rating_max | number | Who serves or stocks it (F5): Tripadvisor rating at most. Qloo: filter.external.tripadvisor.rating.max. |
| tripadvisor_rating_min | number | Who serves or stocks it (F5): Tripadvisor rating at least. Qloo: filter.external.tripadvisor.rating.min. |
| release_country_operator | string | Media and people products (F6): Any (union) or all (intersection) of those. Qloo: operator.filter.release_country. |
{
"type": "object",
"required": [
"idea"
],
"properties": {
"age": {
"type": "string",
"examples": [
"35_to_44"
],
"description": "Who wants it (F1): Who: age range(s) the answer is weighted to. Qloo: signal.demographics.age. comma-separated, of: 24_and_younger, 25_to_29, 30_to_34, 35_to_44, 45_to_54, 55_and_older"
},
"city": {
"type": "string",
"examples": [
"Austin"
],
"description": "Where to launch (F3): Exact city or town name. Qloo: filter.geocode.name."
},
"idea": {
"type": "string",
"description": "the product idea (8-500 characters)"
},
"near": {
"type": "string",
"examples": [
"Austin"
],
"description": "Where to launch (F3): Where: a city or region by name. Qloo: filter.location.query."
},
"qloo": {
"type": "object",
"examples": [
{
"bias.trends": "high"
}
],
"description": "Anything else in the guide (F8): Any other documented parameter for the call's filter.type, by its Qloo name. Qloo: *.",
"additionalProperties": true
},
"sort": {
"enum": [
"affinity",
"distance",
"rating",
"quality"
],
"type": "string",
"examples": [
"quality"
],
"description": "Who serves or stocks it (F5): Order places by. Qloo: sort_by."
},
"place": {
"type": "string",
"description": "the launch market"
},
"admin1": {
"type": "string",
"examples": [
"Texas"
],
"description": "Where to launch (F3): Exact state or region. Qloo: filter.geocode.admin1_region."
},
"admin2": {
"type": "string",
"examples": [
"Travis County"
],
"description": "Where to launch (F3): Exact county or borough. Qloo: filter.geocode.admin2_region."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"examples": [
"female"
],
"description": "Who wants it (F1): Who: gender the answer is weighted to. Qloo: signal.demographics.gender."
},
"leader": {
"type": "string",
"description": "the market leader to compare"
},
"lookup": {
"type": "string",
"examples": [
"Austin"
],
"description": "Look up exact things (F7): Look up exact things: a name to find (Search Entities). Qloo: query."
},
"radius": {
"type": "integer",
"examples": [
5000
],
"description": "Where to launch (F3): Where: radius around it, in meters (0 = strictly inside). Qloo: filter.location.radius."
},
"address": {
"type": "string",
"examples": [
"Congress Ave"
],
"description": "Who serves or stocks it (F5): Address contains. Qloo: filter.address."
},
"country": {
"type": "string",
"examples": [
"US"
],
"description": "Where to launch (F3): Two-letter country code. Qloo: filter.geocode.country_code."
},
"exclude": {
"type": "string",
"examples": [
"4BBEF799-A0C4-4110-AB01-39216993C312"
],
"description": "What is underserved (F2): Entity ids to leave out. Qloo: filter.exclude.entities."
},
"geohash": {
"type": "string",
"examples": [
"9v6k"
],
"description": "Where to launch (F3): Only results whose geohash starts with this. Qloo: filter.location.geohash."
},
"open_on": {
"type": "string",
"examples": [
"Sunday"
],
"description": "Who serves or stocks it (F5): Open on this day. Qloo: filter.hours."
},
"quality": {
"enum": [
"low",
"medium",
"high"
],
"type": "string",
"examples": [
"high"
],
"description": "Who serves or stocks it (F5): Lean the ranking toward quality places. Qloo: bias.quality."
},
"born_max": {
"type": "string",
"examples": [
"1990-12-31"
],
"description": "Media and people products (F6): Person: born on or before (YYYY-MM-DD). Qloo: filter.date_of_birth.max."
},
"born_min": {
"type": "string",
"examples": [
"1960-01-01"
],
"description": "Media and people products (F6): Person: born on or after (YYYY-MM-DD). Qloo: filter.date_of_birth.min."
},
"died_max": {
"type": "string",
"examples": [
"2020-12-31"
],
"description": "Media and people products (F6): Person: died on or before (YYYY-MM-DD). Qloo: filter.date_of_death.max."
},
"died_min": {
"type": "string",
"examples": [
"2000-01-01"
],
"description": "Media and people products (F6): Person: died on or after (YYYY-MM-DD). Qloo: filter.date_of_death.min."
},
"external": {
"type": "string",
"examples": [
"resy"
],
"description": "Who serves or stocks it (F5): Listed on these (resy, michelin, tablet). Qloo: filter.external.exists. comma-separated, of: resy, michelin, tablet"
},
"location": {
"type": "string",
"examples": [
"POINT(-97.7431 30.2672)"
],
"description": "Where to launch (F3): A WKT POINT/POLYGON (longitude first) or a locality id. Qloo: filter.location."
},
"price_to": {
"type": "integer",
"examples": [
300
],
"description": "At what price, where (F4): Hotel price range to (0-1,000,000). Qloo: filter.price_range.to."
},
"year_max": {
"type": "integer",
"examples": [
2024
],
"description": "Media and people products (F6): Released up to this year (film/TV; books: publication year). Qloo: filter.release_year.max."
},
"year_min": {
"type": "integer",
"examples": [
2015
],
"description": "Media and people products (F6): Released from this year (film/TV; books: publication year). Qloo: filter.release_year.min."
},
"audiences": {
"type": "string",
"examples": [
"urn:audience:hobbies_and_interests:running"
],
"description": "Who wants it (F1): Audience segment ids (from /v2/audiences). Qloo: signal.demographics.audiences."
},
"entity_id": {
"type": "string",
"examples": [
"B2A5BF4D-6D9A-4A8B-9E50-1A2B3C4D5E6F"
],
"description": "Look up exact things (F7): Look up exact things: paste a Qloo entity id (Search Entities by ID). Qloo: entity_ids."
},
"price_from": {
"type": "integer",
"examples": [
100
],
"description": "At what price, where (F4): Hotel price range from (0-1,000,000). Qloo: filter.price_range.from."
},
"qloo_calls": {
"type": "object",
"examples": [
{
"/v2/tags": {
"filter.query": "trail running",
"feature.semantic_search": "true"
}
}
],
"description": "Anything else in the guide (F8): Calls to Qloo's other endpoints by path, each with its own documented parameters. Qloo: *.",
"additionalProperties": true
},
"rating_max": {
"type": "number",
"examples": [
5
],
"description": "Media and people products (F6): Film/TV Qloo rating at most (0-5). Qloo: filter.rating.max."
},
"rating_min": {
"type": "number",
"examples": [
3.5
],
"description": "Media and people products (F6): Film/TV Qloo rating at least (0-5). Qloo: filter.rating.min."
},
"hide_leader": {
"type": "boolean",
"examples": [
true
],
"description": "What is underserved (F2): Gaps: hide the market leader (its Qloo id is excluded). Qloo: filter.exclude.entities."
},
"hotel_class": {
"type": "string",
"examples": [
"4,5"
],
"description": "At what price, where (F4): Hotel classes 1-5, mapped where they are hot. Qloo: filter.dimensions.hotel_class. comma-separated, of: 1, 2, 3, 4, 5"
},
"lookup_near": {
"type": "string",
"examples": [
"30.2672,-97.7431"
],
"description": "Look up exact things (F7): Search near: lat,lon or WKT. Qloo: filter.location."
},
"lookup_sort": {
"enum": [
"match",
"distance",
"popularity"
],
"type": "string",
"examples": [
"match"
],
"description": "Look up exact things (F7): Order the search by. Qloo: sort_by."
},
"price_level": {
"type": "string",
"examples": [
"1"
],
"description": "At what price, where (F4): Price tier: 1 (cheap) to 4 (dear), mapped where it is hot. Qloo: filter.dimensions.price_level. comma-separated, of: 1, 2, 3, 4"
},
"exclude_near": {
"type": "string",
"examples": [
"Downtown Austin"
],
"description": "Where to launch (F3): Leave out an area by name. Qloo: filter.exclude.location.query."
},
"exclude_tags": {
"type": "string",
"examples": [
"urn:tag:genre:media:horror"
],
"description": "What is underserved (F2): Tag ids to leave out. Qloo: filter.exclude.tags."
},
"lookup_types": {
"type": "string",
"examples": [
"urn:entity:locality"
],
"description": "Look up exact things (F7): What kinds to search. Qloo: types. comma-separated, of: urn:entity:actor, urn:entity:album, urn:entity:artist, urn:entity:author, urn:entity:book, urn:entity:brand, urn:entity:destination, urn:entity:director, urn:entity:locality, urn:entity:movie, urn:entity:person, urn:entity:place, urn:entity:podcast, urn:entity:tv_show, urn:entity:videogame"
},
"product_kind": {
"enum": [
"film",
"tv",
"book",
"person",
"artist",
"brand",
"podcast",
"game",
"place",
"destination"
],
"type": "string",
"examples": [
"film"
],
"description": "Media and people products (F6): Product kind: what the comparables are. Qloo: filter.type."
},
"exclude_names": {
"type": "array",
"items": {
"type": "string"
},
"examples": [
"Nike, Adidas"
],
"description": "What is underserved (F2): Leave out things by name (Qloo resolves them; sent as JSON). Qloo: filter.exclude.entities.query. names, or one comma-separated string"
},
"lookup_radius": {
"type": "number",
"examples": [
10
],
"description": "Look up exact things (F7): Search radius in miles (0-100). Qloo: filter.radius."
},
"person_gender": {
"enum": [
"male",
"female"
],
"type": "string",
"examples": [
"female"
],
"description": "Media and people products (F6): Person: gender. Qloo: filter.gender."
},
"results_query": {
"type": "string",
"examples": [
"Fitbit"
],
"description": "What is underserved (F2): Score only these named things (one name). Qloo: filter.results.entities.query."
},
"content_rating": {
"type": "string",
"examples": [
"PG-13"
],
"description": "Media and people products (F6): Film/TV content rating(s), MPAA. Qloo: filter.content_rating."
},
"popularity_max": {
"type": "number",
"examples": [
0.5
],
"description": "What is underserved (F2): Gaps: niche only, popularity at most this percentile (0-1). Qloo: filter.popularity.max."
},
"popularity_min": {
"type": "number",
"examples": [
0.1
],
"description": "What is underserved (F2): Popularity at least this percentile (0-1). Qloo: filter.popularity.min."
},
"resy_count_max": {
"type": "integer",
"examples": [
10000
],
"description": "Who serves or stocks it (F5): Resy rating count at most. Qloo: filter.external.resy.count.max."
},
"resy_count_min": {
"type": "integer",
"examples": [
100
],
"description": "Who serves or stocks it (F5): Resy rating count at least. Qloo: filter.external.resy.count.min."
},
"resy_party_max": {
"type": "integer",
"examples": [
8
],
"description": "Who serves or stocks it (F5): Resy party size at most. Qloo: filter.external.resy.party_size.max."
},
"resy_party_min": {
"type": "integer",
"examples": [
2
],
"description": "Who serves or stocks it (F5): Resy party size at least. Qloo: filter.external.resy.party_size.min."
},
"exclude_geohash": {
"type": "string",
"examples": [
"9v6kp"
],
"description": "Where to launch (F3): Leave out results whose geohash starts with this. Qloo: filter.exclude.location.geohash."
},
"finale_year_max": {
"type": "integer",
"examples": [
2024
],
"description": "Media and people products (F6): TV: final season up to this year. Qloo: filter.finale_year.max."
},
"finale_year_min": {
"type": "integer",
"examples": [
2018
],
"description": "Media and people products (F6): TV: final season from this year. Qloo: filter.finale_year.min."
},
"hotel_class_max": {
"type": "integer",
"examples": [
5
],
"description": "At what price, where (F4): Hotel class at most (1-5). Qloo: filter.hotel_class.max."
},
"hotel_class_min": {
"type": "integer",
"examples": [
3
],
"description": "At what price, where (F4): Hotel class at least (1-5). Qloo: filter.hotel_class.min."
},
"interests_names": {
"type": "array",
"items": {
"type": "string"
},
"examples": [
"Hoka, Salomon"
],
"description": "Who wants it (F1): Steer the answer by things you name (Qloo resolves them; sent as JSON). Qloo: signal.interests.entities.query. names, or one comma-separated string"
},
"latest_year_max": {
"type": "integer",
"examples": [
2025
],
"description": "Media and people products (F6): TV: released or updated up to this year. Qloo: filter.latest_known_year.max."
},
"latest_year_min": {
"type": "integer",
"examples": [
2020
],
"description": "Media and people products (F6): TV: released or updated from this year. Qloo: filter.latest_known_year.min."
},
"price_level_max": {
"type": "integer",
"examples": [
3
],
"description": "At what price, where (F4): Places at price level at most (1-4). Qloo: filter.price_level.max."
},
"price_level_min": {
"type": "integer",
"examples": [
2
],
"description": "At what price, where (F4): Places at price level at least (1-4). Qloo: filter.price_level.min."
},
"release_country": {
"type": "string",
"examples": [
"United States"
],
"description": "Media and people products (F6): Film/TV released in these countries. Qloo: filter.release_country."
},
"resy_rating_max": {
"type": "number",
"examples": [
5
],
"description": "Who serves or stocks it (F5): Resy rating at most (1-5). Qloo: filter.external.resy.rating.max."
},
"resy_rating_min": {
"type": "number",
"examples": [
4
],
"description": "Who serves or stocks it (F5): Resy rating at least (1-5). Qloo: filter.external.resy.rating.min."
},
"audiences_weight": {
"enum": [
"low",
"medium",
"high",
"higher"
],
"type": "string",
"examples": [
"high"
],
"description": "Who wants it (F1): How much the segments steer the answer. Qloo: signal.demographics.audiences.weight."
},
"exclude_location": {
"type": "string",
"examples": [
"POINT(-97.74 30.27)"
],
"description": "Where to launch (F3): Leave out a WKT area or locality id. Qloo: filter.exclude.location."
},
"references_brand": {
"type": "string",
"examples": [
"Whole Foods Market"
],
"description": "Who serves or stocks it (F5): Who serves it: a brand by name or id; only places tied to it. Qloo: filter.references_brand."
},
"external_operator": {
"enum": [
"union",
"intersection"
],
"type": "string",
"examples": [
"union"
],
"description": "Who serves or stocks it (F5): Any (union) or all (intersection) of those. Qloo: operator.filter.external.exists."
},
"business_rating_max": {
"type": "number",
"examples": [
5
],
"description": "At what price, where (F4): Business rating at most. Qloo: filter.properties.business_rating.max."
},
"business_rating_min": {
"type": "number",
"examples": [
3.5
],
"description": "At what price, where (F4): Business rating at least. Qloo: filter.properties.business_rating.min."
},
"exclude_tags_operator": {
"enum": [
"union",
"intersection"
],
"type": "string",
"examples": [
"union"
],
"description": "What is underserved (F2): Leave out results with any (union) or all (intersection) of those tags. Qloo: operator.exclude.tags."
},
"tripadvisor_count_max": {
"type": "integer",
"examples": [
5000
],
"description": "Who serves or stocks it (F5): Tripadvisor reviews at most. Qloo: filter.external.tripadvisor.rating.count.max."
},
"tripadvisor_count_min": {
"type": "integer",
"examples": [
100
],
"description": "Who serves or stocks it (F5): Tripadvisor reviews at least. Qloo: filter.external.tripadvisor.rating.count.min."
},
"tripadvisor_rating_max": {
"type": "number",
"examples": [
5
],
"description": "Who serves or stocks it (F5): Tripadvisor rating at most. Qloo: filter.external.tripadvisor.rating.max."
},
"tripadvisor_rating_min": {
"type": "number",
"examples": [
4
],
"description": "Who serves or stocks it (F5): Tripadvisor rating at least. Qloo: filter.external.tripadvisor.rating.min."
},
"release_country_operator": {
"enum": [
"union",
"intersection"
],
"type": "string",
"examples": [
"union"
],
"description": "Media and people products (F6): Any (union) or all (intersection) of those. Qloo: operator.filter.release_country."
}
},
"additionalProperties": false
}