---
title: "A ranked, sourced answer to one question"
method: GET
path: "/hotels/{market}/{question}.json"
---

# A ranked, sourced answer to one question

`GET /hotels/{market}/{question}.json`

## Request

- Base URL: `https://journeyed.org`
- URL: `https://journeyed.org/hotels/{market}/{question}.json`
- Auth: none declared

The ranked places with their Fit Score, place score, distance and the sourced facts that answer the question; sponsored placements are a separate array. A slug that starts with "best-" (from answers.json bestOf[]) is a best-of page and returns BestOfTwin (type "best-of") instead; a slug that starts with "hotels-within-walking-distance-of-" (answers.json walking[]) is a walking page and returns WalkingTwin (type "walking").

## Path parameters

- `market` string, required
- `question` string, required

## Response `200`

A ranked, sourced answer to one question

- union
  - QuestionTwin: JSON twin of a question page (<path>.json). bestOf links the best-of list of the same place and walking its walking page, when the build has one. table is the comparison table the page shows under its answer. parkingPrices lists stated parking prices lowest first on a question that asks what parking costs.
    - `schemaVersion` 1, required
    - `url` string, uri, required
    - `jsonUrl` string, uri, required
    - `markdownUrl` string, uri, required
    - `asOf` string, date, required
    - `publisher` Publisher, required: The publisher. disclosure and parent are present only when the publisher has a parent company.
      - `name` string, required
      - `disclosure` string
      - `parent` string
    - `type` 'question', required
    - `question` string, required
    - `answer` string, required
    - `answerSentences` string[], required
    - `countLine` string, required
    - `market` string, required
    - `anchor` object, required
      - `name` string, required
      - `url` string, uri, required
      - `lat` number, required
      - `lon` number, required
    - `ranked` RankedPlace[], required
      - `rank` integer, required
      - `placeId` string, required
      - `name` string, required
      - `url` string, uri, required
      - `jsonUrl` string, uri, required
      - `fit` number, required
      - `score` number, required
      - `distanceMi` number, required
      - `routed` RoutedDistance, required: A distance along OpenStreetMap streets and paths between a hotel and a landmark, beside the straight-line distanceMi and never shorter than it. walkMin is the routing engine's estimate (say "about"), never a measured time. driveMi is a distance only: no drive time is published. A null part is not on record.
        - `walkMi` number, nullable, required
        - `walkMin` integer, nullable, required
        - `driveMi` number, nullable, required
      - `why` string, required
      - `address` string, nullable, required
      - `phone` string, nullable, required
      - `website` string, uri, nullable, required
      - `coordinates` Coordinates, required
        - `lat` number, required
        - `lon` number, required
      - `answeringFacts` Fact[], required
        - `key` string, required
        - `text` string, required
        - `value` string, nullable, required
        - `unit` string, nullable, required
        - `sourceUrl` string, uri, nullable, required
        - `dataset` string, nullable, required
        - `sourceLabel` string, required
        - `licenseBasis` string, required
        - `checkedOn` string, date, required
      - `backing` Backing: What is on record behind a hotel score, in counts: facts read from the hotel own website (and the newest date they were checked), contact details from the open place record, recognized awards, counted reader votes, and how many of the standard facts the score counts are verified.
        - `ownSiteFacts` integer, required
        - `ownSiteCheckedOn` string, date, nullable, required
        - `recordFacts` integer, required
        - `awards` integer, required
        - `votes` integer, required
        - `standardFacts` integer, required
        - `standardTotal` integer, required
    - `rankedTotal` integer, required
    - `notYetVerified` object[], required
      - `name` string, required
      - `url` string, uri, required
      - `jsonUrl` string, uri, required
      - `missing` string, required
    - `notYetVerifiedTotal` integer, required
    - `sponsored` SponsoredPlace[], required
      - `label` string, required
      - `placeId` string, required
      - `name` string, required
      - `url` string, uri, required
      - `fit` number, required
      - `organicRank` integer, nullable, required
    - `related` Link[], required
      - `text` string, required
      - `url` string, uri, required
      - `jsonUrl` string, uri, required
    - `methodology` object, required
      - `formulaVersion` string, required
      - `weights` Weights, required: Component weights the ranking used; they sum to 1.
        - `facts` number, required
        - `opinion` number, required
        - `proximity` number, required
        - `reachability` number, required
      - `lines` string[], required
      - `url` string, uri, required
    - `sources` Source[], required
      - `label` string, required
      - `url` string, uri, nullable, required
      - `dataset` string, nullable, required
      - `licenseBasis` string, required
      - `checkedOn` string, date, required
    - `routing` Routing, required: What sources every routed figure of a twin: the credit (OpenStreetMap contributors, routed with the named engine), the date of the map data, the date computed and the method of each figure.
      - `source` Source, required
        - `label` string, required
        - `url` string, uri, nullable, required
        - `dataset` string, nullable, required
        - `licenseBasis` string, required
        - `checkedOn` string, date, required
      - `engine` string, required
      - `mapDataOn` string, date, required
      - `computedOn` string, date, required
      - `walkMethod` string, required
      - `driveMethod` string, required
      - `note` string, required
    - `whyTrust` object: Why trust this ranking: three checkable statements with the market counts.
      - `bullets` string[], required
      - `url` string, uri, required
    - `bestOf` Link
      - `text` string, required
      - `url` string, uri, required
      - `jsonUrl` string, uri, required
    - `walking` Link
      - `text` string, required
      - `url` string, uri, required
      - `jsonUrl` string, uri, required
    - `table` CompareTable: The comparison table a list page shows under its answer: one row per listed hotel, in the list order; cells are in column order. distance is straight-line miles; walk, walkMin, walkMi and drive follow OpenStreetMap ways (walk times are estimates). of names the guide section whose hotels the rows are. routing is present when the twin has no routing of its own.
      - `heading` string, required
      - `caption` string, required
      - `anchorUrl` string, uri, nullable, required
      - `of` string
      - `columns` object[], required
        - `id` 'distance' | 'walk' | 'walkMin' | 'walkMi' | 'drive' | 'parking' | 'answer' | 'checkin' | 'pets' | 'recognition' | 'verified' | 'profile', required
        - `label` string, required
      - `rows` object[], required
        - `rank` integer, required
        - `placeId` string, required
        - `name` string, required
        - `url` string, uri, required
        - `jsonUrl` string, uri, required
        - `cells` object[], required
          - `text` string, required
          - `facts` Fact[]
            - `key` string, required
            - `text` string, required
            - `value` string, nullable, required
            - `unit` string, nullable, required
            - `sourceUrl` string, uri, nullable, required
            - `dataset` string, nullable, required
            - `sourceLabel` string, required
            - `licenseBasis` string, required
            - `checkedOn` string, date, required
      - `routing` Routing: What sources every routed figure of a twin: the credit (OpenStreetMap contributors, routed with the named engine), the date of the map data, the date computed and the method of each figure.
        - `source` Source, required
          - `label` string, required
          - `url` string, uri, nullable, required
          - `dataset` string, nullable, required
          - `licenseBasis` string, required
          - `checkedOn` string, date, required
        - `engine` string, required
        - `mapDataOn` string, date, required
        - `computedOn` string, date, required
        - `walkMethod` string, required
        - `driveMethod` string, required
        - `note` string, required
    - `parkingPrices` object: Questions that ask what parking costs: every compared hotel that states a parking price, lowest first; total counts them all, rows shows at most 25. The ranked list keeps its own Fit order.
      - `heading` string, required
      - `answerSentences` string[], required
      - `caption` string, required
      - `total` integer, required
      - `rows` object[], required
        - `position` integer, required
        - `placeId` string, required
        - `name` string, required
        - `url` string, uri, required
        - `jsonUrl` string, uri, required
        - `price` string, required
        - `kind` 'self' | 'valet', required
        - `nightlyUsd` number, required
        - `distanceMi` number, required
        - `hotelClass` string, required
        - `facts` Fact[], required
          - `key` string, required
          - `text` string, required
          - `value` string, nullable, required
          - `unit` string, nullable, required
          - `sourceUrl` string, uri, nullable, required
          - `dataset` string, nullable, required
          - `sourceLabel` string, required
          - `licenseBasis` string, required
          - `checkedOn` string, date, required
  - BestOfTwin: JSON twin of a best-of page (/<category>/<market>/best-...json): hotels that can be ranked, ordered by a published formula of recognized awards, hotel class, verified facts, reader votes and distance. Never a review score. sponsored (present only when the page shows one) holds labelled paid cards, never part of ranked.
    - `schemaVersion` 1, required
    - `url` string, uri, required
    - `jsonUrl` string, uri, required
    - `markdownUrl` string, uri, required
    - `asOf` string, date, required
    - `publisher` Publisher, required: The publisher. disclosure and parent are present only when the publisher has a parent company.
      - `name` string, required
      - `disclosure` string
      - `parent` string
    - `type` 'best-of', required
    - `title` string, required
    - `kind` 'anchor' | 'need', required
    - `market` string, required
    - `answer` string, required
    - `answerSentences` string[], required
    - `countLine` string, required
    - `anchor` object, nullable, required
      - `name` string, required
      - `url` string, uri, required
      - `lat` number, required
      - `lon` number, required
      - `radiusMi` number, required
      - `kind` string, required
    - `need` object, nullable, required
      - `id` string, required
      - `label` string, required
      - `definition` string, required
    - `considered` integer, required
    - `eligible` integer, required
    - `eligibility` string, required
    - `formula` object, required: What best means on this page: points per part (they sum to 100), in two sentences and one line per part.
      - `version` string, required
      - `weights` BestOfParts, required: The five parts of a best-of order, in points.
        - `awards` number, required
        - `class` number, required
        - `facts` number, required
        - `votes` number, required
        - `distance` number, required
      - `sentences` string[], required
      - `lines` string[], required
      - `url` string, uri, required
    - `votes` object, required: Reader opinion enters only as Yes or No votes on details. Never reviews.
      - `counted` integer, required
      - `note` string, required
    - `ranked` object[], required
      - `rank` integer, required
      - `placeId` string, required
      - `name` string, required
      - `url` string, uri, required
      - `jsonUrl` string, uri, required
      - `points` number, required
      - `parts` BestOfParts, required: The five parts of a best-of order, in points.
        - `awards` number, required
        - `class` number, required
        - `facts` number, required
        - `votes` number, required
        - `distance` number, required
      - `eligibleBy` 'profile' | 'award' | 'both', required
      - `score` number, required
      - `scoreBand` string, required
      - `distanceMi` number, nullable, required
      - `routed` RoutedDistance, required: A distance along OpenStreetMap streets and paths between a hotel and a landmark, beside the straight-line distanceMi and never shorter than it. walkMin is the routing engine's estimate (say "about"), never a measured time. driveMi is a distance only: no drive time is published. A null part is not on record.
        - `walkMi` number, nullable, required
        - `walkMin` integer, nullable, required
        - `driveMi` number, nullable, required
      - `address` string, nullable, required
      - `coordinates` Coordinates, required
        - `lat` number, required
        - `lon` number, required
      - `why` Fact[], required
        - `key` string, required
        - `text` string, required
        - `value` string, nullable, required
        - `unit` string, nullable, required
        - `sourceUrl` string, uri, nullable, required
        - `dataset` string, nullable, required
        - `sourceLabel` string, required
        - `licenseBasis` string, required
        - `checkedOn` string, date, required
      - `backing` Backing, required: What is on record behind a hotel score, in counts: facts read from the hotel own website (and the newest date they were checked), contact details from the open place record, recognized awards, counted reader votes, and how many of the standard facts the score counts are verified.
        - `ownSiteFacts` integer, required
        - `ownSiteCheckedOn` string, date, nullable, required
        - `recordFacts` integer, required
        - `awards` integer, required
        - `votes` integer, required
        - `standardFacts` integer, required
        - `standardTotal` integer, required
      - `backedBy` string, required
      - `questionPages` Link[], required
        - `text` string, required
        - `url` string, uri, required
        - `jsonUrl` string, uri, required
    - `rankedTotal` integer, required
    - `sections` object[], required
      - `id` string, required
      - `heading` string, required
      - `note` string, required
      - `rows` object[], required
        - `placeId` string, required
        - `name` string, required
        - `url` string, uri, required
        - `distanceMi` number, nullable, required
        - `routed` RoutedDistance, required: A distance along OpenStreetMap streets and paths between a hotel and a landmark, beside the straight-line distanceMi and never shorter than it. walkMin is the routing engine's estimate (say "about"), never a measured time. driveMi is a distance only: no drive time is published. A null part is not on record.
          - `walkMi` number, nullable, required
          - `walkMin` integer, nullable, required
          - `driveMi` number, nullable, required
        - `score` number, required
        - `rank` integer, nullable, required
        - `fact` Fact, required: One sourced fact. Exactly one of sourceUrl and dataset is set. text is the wording the page shows; value is the stored canonical value.
          - `key` string, required
          - `text` string, required
          - `value` string, nullable, required
          - `unit` string, nullable, required
          - `sourceUrl` string, uri, nullable, required
          - `dataset` string, nullable, required
          - `sourceLabel` string, required
          - `licenseBasis` string, required
          - `checkedOn` string, date, required
    - `routing` Routing, required: What sources every routed figure of a twin: the credit (OpenStreetMap contributors, routed with the named engine), the date of the map data, the date computed and the method of each figure.
      - `source` Source, required
        - `label` string, required
        - `url` string, uri, nullable, required
        - `dataset` string, nullable, required
        - `licenseBasis` string, required
        - `checkedOn` string, date, required
      - `engine` string, required
      - `mapDataOn` string, date, required
      - `computedOn` string, date, required
      - `walkMethod` string, required
      - `driveMethod` string, required
      - `note` string, required
    - `whyTrust` object, required
      - `bullets` string[], required
      - `url` string, uri, required
    - `qa` object[], required
      - `id` string, required
      - `question` string, required
      - `answer` string, required
    - `related` Link[], required
      - `text` string, required
      - `url` string, uri, required
      - `jsonUrl` string, uri, required
    - `alsoAskedAs` string[], required
    - `sources` Source[], required
      - `label` string, required
      - `url` string, uri, nullable, required
      - `dataset` string, nullable, required
      - `licenseBasis` string, required
      - `checkedOn` string, date, required
    - `walking` Link
      - `text` string, required
      - `url` string, uri, required
      - `jsonUrl` string, uri, required
    - `table` CompareTable: The comparison table a list page shows under its answer: one row per listed hotel, in the list order; cells are in column order. distance is straight-line miles; walk, walkMin, walkMi and drive follow OpenStreetMap ways (walk times are estimates). of names the guide section whose hotels the rows are. routing is present when the twin has no routing of its own.
      - `heading` string, required
      - `caption` string, required
      - `anchorUrl` string, uri, nullable, required
      - `of` string
      - `columns` object[], required
        - `id` 'distance' | 'walk' | 'walkMin' | 'walkMi' | 'drive' | 'parking' | 'answer' | 'checkin' | 'pets' | 'recognition' | 'verified' | 'profile', required
        - `label` string, required
      - `rows` object[], required
        - `rank` integer, required
        - `placeId` string, required
        - `name` string, required
        - `url` string, uri, required
        - `jsonUrl` string, uri, required
        - `cells` object[], required
          - `text` string, required
          - `facts` Fact[]
            - `key` string, required
            - `text` string, required
            - `value` string, nullable, required
            - `unit` string, nullable, required
            - `sourceUrl` string, uri, nullable, required
            - `dataset` string, nullable, required
            - `sourceLabel` string, required
            - `licenseBasis` string, required
            - `checkedOn` string, date, required
      - `routing` Routing: What sources every routed figure of a twin: the credit (OpenStreetMap contributors, routed with the named engine), the date of the map data, the date computed and the method of each figure.
        - `source` Source, required
          - `label` string, required
          - `url` string, uri, nullable, required
          - `dataset` string, nullable, required
          - `licenseBasis` string, required
          - `checkedOn` string, date, required
        - `engine` string, required
        - `mapDataOn` string, date, required
        - `computedOn` string, date, required
        - `walkMethod` string, required
        - `driveMethod` string, required
        - `note` string, required
    - `sponsored` ListSponsoredPlace[]
      - `label` string, required
      - `placeId` string, required
      - `name` string, required
      - `url` string, uri, required
      - `organicRank` integer, nullable, required
      - `score` number, required
      - `distanceMi` number, required
      - `rankedOn` object: Event pages: the hotel position on the full best-of list the page links to, as that list publishes it, when the page shows only its first rows.
        - `rank` integer, required
        - `total` integer, required
        - `title` string, required
        - `url` string, uri, required
  - WalkingTwin: JSON twin of a walking page (/<category>/<market>/hotels-within-walking-distance-of-<anchor>.json): every hotel with a walking route to the place on record, shortest estimated walk first. within counts the hotels inside 10, 20 and 30 minutes. Not a quality ranking. sponsored (present only when the page shows one) holds labelled paid cards, never part of ranked.
    - `schemaVersion` 1, required
    - `url` string, uri, required
    - `jsonUrl` string, uri, required
    - `markdownUrl` string, uri, required
    - `asOf` string, date, required
    - `publisher` Publisher, required: The publisher. disclosure and parent are present only when the publisher has a parent company.
      - `name` string, required
      - `disclosure` string
      - `parent` string
    - `type` 'walking', required
    - `title` string, required
    - `market` string, required
    - `answer` string, required
    - `answerSentences` string[], required
    - `countLine` string, required
    - `method` string, required
    - `anchor` object, required
      - `name` string, required
      - `url` string, uri, required
      - `lat` number, required
      - `lon` number, required
      - `kind` string, required
    - `total` integer, required
    - `within` object[], required
      - `minutes` integer, required
      - `hotels` integer, required
    - `ranked` object[], required
      - `rank` integer, required
      - `placeId` string, required
      - `name` string, required
      - `url` string, uri, required
      - `jsonUrl` string, uri, required
      - `distanceMi` number, required
      - `routed` RoutedDistance, required: A distance along OpenStreetMap streets and paths between a hotel and a landmark, beside the straight-line distanceMi and never shorter than it. walkMin is the routing engine's estimate (say "about"), never a measured time. driveMi is a distance only: no drive time is published. A null part is not on record.
        - `walkMi` number, nullable, required
        - `walkMin` integer, nullable, required
        - `driveMi` number, nullable, required
      - `address` string, nullable, required
      - `coordinates` Coordinates, required
        - `lat` number, required
        - `lon` number, required
      - `facts` Fact[], required
        - `key` string, required
        - `text` string, required
        - `value` string, nullable, required
        - `unit` string, nullable, required
        - `sourceUrl` string, uri, nullable, required
        - `dataset` string, nullable, required
        - `sourceLabel` string, required
        - `licenseBasis` string, required
        - `checkedOn` string, date, required
      - `score` number, required
      - `scoreBand` string, required
      - `backing` Backing, required: What is on record behind a hotel score, in counts: facts read from the hotel own website (and the newest date they were checked), contact details from the open place record, recognized awards, counted reader votes, and how many of the standard facts the score counts are verified.
        - `ownSiteFacts` integer, required
        - `ownSiteCheckedOn` string, date, nullable, required
        - `recordFacts` integer, required
        - `awards` integer, required
        - `votes` integer, required
        - `standardFacts` integer, required
        - `standardTotal` integer, required
      - `backedBy` string, required
    - `table` CompareTable, required: The comparison table a list page shows under its answer: one row per listed hotel, in the list order; cells are in column order. distance is straight-line miles; walk, walkMin, walkMi and drive follow OpenStreetMap ways (walk times are estimates). of names the guide section whose hotels the rows are. routing is present when the twin has no routing of its own.
      - `heading` string, required
      - `caption` string, required
      - `anchorUrl` string, uri, nullable, required
      - `of` string
      - `columns` object[], required
        - `id` 'distance' | 'walk' | 'walkMin' | 'walkMi' | 'drive' | 'parking' | 'answer' | 'checkin' | 'pets' | 'recognition' | 'verified' | 'profile', required
        - `label` string, required
      - `rows` object[], required
        - `rank` integer, required
        - `placeId` string, required
        - `name` string, required
        - `url` string, uri, required
        - `jsonUrl` string, uri, required
        - `cells` object[], required
          - `text` string, required
          - `facts` Fact[]
            - `key` string, required
            - `text` string, required
            - `value` string, nullable, required
            - `unit` string, nullable, required
            - `sourceUrl` string, uri, nullable, required
            - `dataset` string, nullable, required
            - `sourceLabel` string, required
            - `licenseBasis` string, required
            - `checkedOn` string, date, required
      - `routing` Routing: What sources every routed figure of a twin: the credit (OpenStreetMap contributors, routed with the named engine), the date of the map data, the date computed and the method of each figure.
        - `source` Source, required
          - `label` string, required
          - `url` string, uri, nullable, required
          - `dataset` string, nullable, required
          - `licenseBasis` string, required
          - `checkedOn` string, date, required
        - `engine` string, required
        - `mapDataOn` string, date, required
        - `computedOn` string, date, required
        - `walkMethod` string, required
        - `driveMethod` string, required
        - `note` string, required
    - `routing` Routing, required: What sources every routed figure of a twin: the credit (OpenStreetMap contributors, routed with the named engine), the date of the map data, the date computed and the method of each figure.
      - `source` Source, required
        - `label` string, required
        - `url` string, uri, nullable, required
        - `dataset` string, nullable, required
        - `licenseBasis` string, required
        - `checkedOn` string, date, required
      - `engine` string, required
      - `mapDataOn` string, date, required
      - `computedOn` string, date, required
      - `walkMethod` string, required
      - `driveMethod` string, required
      - `note` string, required
    - `qa` object[], required
      - `id` string, required
      - `question` string, required
      - `answer` string, required
    - `related` Link[], required
      - `text` string, required
      - `url` string, uri, required
      - `jsonUrl` string, uri, required
    - `alsoAskedAs` string[], required
    - `sources` Source[], required
      - `label` string, required
      - `url` string, uri, nullable, required
      - `dataset` string, nullable, required
      - `licenseBasis` string, required
      - `checkedOn` string, date, required
    - `sponsored` ListSponsoredPlace[]
      - `label` string, required
      - `placeId` string, required
      - `name` string, required
      - `url` string, uri, required
      - `organicRank` integer, nullable, required
      - `score` number, required
      - `distanceMi` number, required
      - `rankedOn` object: Event pages: the hotel position on the full best-of list the page links to, as that list publishes it, when the page shows only its first rows.
        - `rank` integer, required
        - `total` integer, required
        - `title` string, required
        - `url` string, uri, required

## Other responses

- `404`: No such page. Twins are not redirected: when a page moved or a question fell below the publish threshold, its HTML URL redirects but its .json and .md twins return 404, so re-read answers.json.

---

[API](https://skmtc.dev/journeyed/apis/journeyed-answers.md) · [All operations](https://skmtc.dev/journeyed/apis/journeyed-answers/llms.txt) · [OpenAPI document](https://skmtc.dev/journeyed/apis/journeyed-answers/revisions/16020bee9761?raw)