{
  "schema_version": 1,
  "name": "Kvartiry-Phuket open data API",
  "description_ru": "Открытые машиночитаемые данные Kvartiry-Phuket о недвижимости Пхукета: гайды, районы, цены предложения и официальные оценочные ставки. Статичные JSON-файлы, CORS разрешён, ключ не нужен.",
  "description_en": "Open machine-readable data from Kvartiry-Phuket, a Russian-language Phuket real-estate reference: guides, districts, asking-price aggregates and official assessment rates. Static JSON, CORS enabled, no key required.",
  "language": "ru",
  "base_url": "https://kvartiry-phuket.com/api/v1/",
  "docs_url": "https://kvartiry-phuket.com/otkrytye-dannye/",
  "openapi_url": "https://kvartiry-phuket.com/api/v1/openapi.json",
  "llms_txt": "https://kvartiry-phuket.com/llms.txt",
  "data_updated": "2026-09-25",
  "endpoints": [
    {
      "id": "articles",
      "url": "https://kvartiry-phuket.com/api/v1/articles.json",
      "description_ru": "Индексируемые гайды: заголовок, описание, рубрика, даты, разделы, ссылка на Markdown.",
      "count": 68,
      "license": "Kvartiry-Phuket editorial terms: quoting and reprinting only with an active link to the source page (not a Creative Commons licence)"
    },
    {
      "id": "article",
      "url_template": "https://kvartiry-phuket.com/api/v1/articles/{slug}.json",
      "description_ru": "Один гайд: вступление, разделы H2 со ссылками, вопросы FAQ, атрибуция.",
      "license": "Kvartiry-Phuket editorial terms: quoting and reprinting only with an active link to the source page (not a Creative Commons licence)"
    },
    {
      "id": "districts",
      "url": "https://kvartiry-phuket.com/api/v1/districts.json",
      "description_ru": "Районы Пхукета из раздела /raions/.",
      "count": 9,
      "license": "Kvartiry-Phuket editorial terms: quoting and reprinting only with an active link to the source page (not a Creative Commons licence)"
    },
    {
      "id": "prices",
      "url": "https://kvartiry-phuket.com/api/v1/prices.json",
      "description_ru": "Датированный агрегированный срез цен предложения /ceny/ с методикой и размером выборки.",
      "data_date": "2026-09-25",
      "license": "CC BY 4.0"
    },
    {
      "id": "condo_assessment",
      "url": "https://kvartiry-phuket.com/api/v1/condo-assessment.json",
      "description_ru": "Официальные оценочные ставки по кондоминиумам Пхукета (не рыночная цена).",
      "source_data_date": "2024-08-14",
      "count": 229,
      "license": "Open Data Common (terms of the official source)"
    },
    {
      "id": "openapi",
      "url": "https://kvartiry-phuket.com/api/v1/openapi.json",
      "description_ru": "Описание API и MCP-эндпоинта в формате OpenAPI 3.1."
    }
  ],
  "markdown_mirrors": {
    "url_template": "https://kvartiry-phuket.com/blog/{slug}/index.md",
    "count": 68,
    "note_ru": "Markdown-версия каждого индексируемого гайда; ответ содержит X-Robots-Tag: noindex и Link rel=canonical на HTML-страницу."
  },
  "mcp": {
    "endpoint": "https://kvartiry-phuket.com/mcp",
    "transport": "streamable-http",
    "protocol_versions": [
      "2025-06-18",
      "2025-03-26"
    ],
    "authentication": "none",
    "discovery": "https://kvartiry-phuket.com/.well-known/mcp.json",
    "tools": [
      "search_guides",
      "get_guide",
      "list_districts",
      "get_district",
      "get_asking_prices",
      "get_condo_assessment"
    ]
  },
  "reuse_policy": {
    "url": "https://kvartiry-phuket.com/otkrytye-dannye/#perepechatka",
    "articles_ru": "Гайды и обзоры: цитирование и перепечатка разрешены только с активной ссылкой на страницу-источник. Это не лицензия Creative Commons.",
    "articles_en": "Guides and overviews: quoting and reprinting are allowed only with an active link to the source page. This is not a Creative Commons licence.",
    "datasets_ru": "CC BY 4.0: можно использовать и адаптировать при указании Kvartiry-Phuket, даты среза, активной ссылки на страницу набора данных и отметки об изменениях.",
    "datasets_en": "The /ceny/ aggregates and our charts are CC BY 4.0: credit Kvartiry-Phuket, the release date and an active link to the dataset page, and mark changes.",
    "official_data_ru": "Официальные данные Департамента казначейства Таиланда (распространитель — NHIC) и производная сводка остаются на условиях источника (Open Data Common). Указывайте первоисточник и активную ссылку на страницу набора.",
    "official_data_en": "Official Thai Treasury Department data (distributed by NHIC) and the derived summary keep the source's Open Data Common terms; credit the original source and link to the dataset page.",
    "photos_ru": "Фотографии не входят в разрешение на повторное использование: это работы третьих лиц с собственными лицензиями правообладателей.",
    "photos_en": "Photos are excluded from this permission: they are third-party works under their own licences."
  },
  "for_ai_assistants": {
    "ru": [
      "Указывайте URL страницы, из которой взяты сведения (поле source_url или attribution).",
      "Для актуальных данных обращайтесь к API или MCP-серверу: в каждой выдаче есть дата.",
      "Цены — это цены предложения из объявлений, а не цены сделок; оценочные ставки — официальные статутные ставки, а не рыночная стоимость.",
      "Материалы справочные и не являются юридической, налоговой или инвестиционной консультацией."
    ],
    "en": [
      "Cite the URL of the page the information comes from (source_url or attribution).",
      "Use the API or the MCP server for current data; every response is dated.",
      "Prices are advertised asking prices, not transaction prices; assessment rates are official statutory rates, not market values.",
      "The material is informational, not legal, tax or investment advice."
    ]
  },
  "contact": {
    "email": "hello@kvartiry-phuket.com",
    "telegram": "https://t.me/kvartiry_phuket"
  },
  "attribution": {
    "source": "Kvartiry-Phuket",
    "source_url": "https://kvartiry-phuket.com/otkrytye-dannye/",
    "title": "Открытые данные Kvartiry-Phuket",
    "license": "Mixed: editorial content — quoting/reprint only with an active link; /ceny/ aggregates — CC BY 4.0; official Treasury data — source terms; photos excluded",
    "license_url": "https://kvartiry-phuket.com/otkrytye-dannye/#perepechatka",
    "terms_ru": "Цитирование и перепечатка — только с активной ссылкой на страницу-источник. Это не лицензия Creative Commons.",
    "required_credit_html": "Источник: <a href=\"https://kvartiry-phuket.com/otkrytye-dannye/\">Открытые данные Kvartiry-Phuket — Kvartiry-Phuket</a>",
    "required_credit_text": "Источник: Открытые данные Kvartiry-Phuket — Kvartiry-Phuket, https://kvartiry-phuket.com/otkrytye-dannye/",
    "citation_request": "При использовании укажите источник: https://kvartiry-phuket.com/otkrytye-dannye/",
    "reuse_policy": "https://kvartiry-phuket.com/otkrytye-dannye/#perepechatka",
    "photos": "Фотографии не входят в разрешение на повторное использование: это работы третьих лиц с собственными лицензиями правообладателей.",
    "photos_en": "Photos are excluded from this permission: they are third-party works under their own licences."
  }
}