# Отели на Авито

**Use case:** 

Отели и гостевые дома на Авито с ценой на выбранные даты: типы номеров и тарифы, звёзды, оценка гостей, удобства и правила заселения.

## Input

```json
{
  "maxResults": 50,
  "query": "iPhone 15 Pro",
  "location": "Сочи",
  "category": "hotels",
  "sort": "cheapest",
  "checkIn": "2027-03-10",
  "checkOut": "2027-03-12",
  "guests": 2,
  "childAges": [],
  "includePhone": false,
  "includeDetails": true,
  "includeReviews": false,
  "includeComparables": false
}
```

## Output

```json
{
  "id": {
    "label": "ID",
    "format": "number"
  },
  "title": {
    "label": "Title",
    "format": "text"
  },
  "snippet": {
    "label": "Текст карточки"
  },
  "url": {
    "label": "URL",
    "format": "link"
  },
  "status": {
    "label": "Status",
    "format": "text"
  },
  "price": {
    "label": "Price",
    "format": "number"
  },
  "pricePrevious": {
    "label": "Previous Price",
    "format": "number"
  },
  "priceWithoutDiscount": {
    "label": "Price Before Discount",
    "format": "number"
  },
  "discountPercent": {
    "label": "Discount",
    "format": "text"
  },
  "priceFormatted": {
    "label": "Price Formatted",
    "format": "text"
  },
  "normalizedPrice": {
    "label": "Price/m²",
    "format": "text"
  },
  "stayLength": {
    "label": "Stay Length",
    "format": "text"
  },
  "pricePeriod": {
    "label": "Цена за период",
    "format": "text"
  },
  "currency": {
    "label": "Currency",
    "format": "text"
  },
  "description": {
    "label": "Description",
    "format": "text"
  },
  "descriptionHtml": {
    "label": "Description HTML",
    "format": "text"
  },
  "imageAlt": {
    "label": "Image Alt",
    "format": "text"
  },
  "address": {
    "label": "Address",
    "format": "text"
  },
  "addressId": {
    "label": "Address ID",
    "format": "number"
  },
  "locationId": {
    "label": "Location ID",
    "format": "number"
  },
  "districtId": {
    "label": "District ID",
    "format": "number"
  },
  "metroId": {
    "label": "Metro ID",
    "format": "number"
  },
  "latitude": {
    "label": "Latitude",
    "format": "number"
  },
  "longitude": {
    "label": "Longitude",
    "format": "number"
  },
  "geoReferences": {
    "label": "Geo References",
    "format": "array"
  },
  "categoryId": {
    "label": "Category ID",
    "format": "number"
  },
  "verticalId": {
    "label": "Vertical ID",
    "format": "number"
  },
  "breadcrumbs": {
    "label": "Breadcrumbs",
    "format": "array"
  },
  "postedTimestamp": {
    "label": "Posted Timestamp",
    "format": "number"
  },
  "postedAt": {
    "label": "Posted At",
    "format": "date"
  },
  "images": {
    "label": "Images",
    "format": "array"
  },
  "imageCount": {
    "label": "Image Count",
    "format": "number"
  },
  "hasVideo": {
    "label": "Has Video",
    "format": "boolean"
  },
  "parameters": {
    "label": "Parameters",
    "format": "array"
  },
  "badges": {
    "label": "Badges",
    "format": "array"
  },
  "isNegotiable": {
    "label": "Negotiable",
    "format": "boolean"
  },
  "variants": {
    "label": "Variants",
    "format": "array"
  },
  "stock": {
    "label": "Наличие"
  },
  "stockInfo": {
    "label": "Stock Info",
    "format": "text"
  },
  "hasInstallments": {
    "label": "Installments",
    "format": "boolean"
  },
  "anonymousNumber": {
    "label": "Anonymous Number",
    "format": "text"
  },
  "contactMethods": {
    "label": "Contact Methods",
    "format": "array"
  },
  "rating": {
    "label": "Rating",
    "format": "number"
  },
  "reviewCount": {
    "label": "Review Count",
    "format": "number"
  },
  "modelReviewsSummary": {
    "label": "Model Reviews",
    "format": "text"
  },
  "modelReviewsScore": {
    "label": "Model Review Score",
    "format": "number"
  },
  "modelComparables": {
    "label": "Model comparables"
  },
  "seller": {
    "label": "Seller",
    "format": "object"
  },
  "phone": {
    "label": "Phone",
    "format": "text"
  },
  "phoneType": {
    "label": "Phone Type",
    "format": "text"
  },
  "phoneIsAnonymous": {
    "label": "Phone Anonymous",
    "format": "boolean"
  },
  "phoneAnonymousReason": {
    "label": "Почему номер скрыт"
  },
  "userType": {
    "label": "User Type",
    "format": "text"
  },
  "shopId": {
    "label": "Shop ID",
    "format": "number"
  },
  "viewsTotal": {
    "label": "Views Total",
    "format": "number"
  },
  "viewsToday": {
    "label": "Views Today",
    "format": "number"
  },
  "productSpecs": {
    "label": "Product Specs",
    "format": "object"
  },
  "productReviews": {
    "label": "Product Reviews",
    "format": "array"
  },
  "catalogInfo": {
    "label": "Catalog Info",
    "format": "object"
  },
  "carMarketPrice": {
    "label": "Car Market Price",
    "format": "object"
  },
  "vehicleType": {
    "label": "Vehicle Type",
    "format": "text"
  },
  "vehicleHistory": {
    "label": "Vehicle History",
    "format": "object"
  },
  "dealerDiscount": {
    "label": "Dealer Discount",
    "format": "object"
  },
  "dealerOffers": {
    "label": "Dealer Offers",
    "format": "array"
  },
  "buildingInfo": {
    "label": "Building Info",
    "format": "array"
  },
  "realtyInfo": {
    "label": "Realty Info",
    "format": "object"
  },
  "realtyReport": {
    "label": "Realty Report",
    "format": "object"
  },
  "marketValuation": {
    "label": "Market Valuation",
    "format": "object"
  },
  "rentConditions": {
    "label": "Rent Conditions",
    "format": "array"
  },
  "rentalRules": {
    "label": "Rental Rules",
    "format": "array"
  },
  "layoutImages": {
    "label": "Layout Images",
    "format": "array"
  },
  "isDeliveryAvailable": {
    "label": "Delivery",
    "format": "boolean"
  },
  "listingReviews": {
    "label": "Listing Reviews",
    "format": "array"
  },
  "hotel": {
    "label": "Hotel",
    "format": "object"
  },
  "bookingFlow": {
    "label": "Тип бронирования",
    "format": "text"
  },
  "availableDates": {
    "label": "Свободные даты",
    "format": "array"
  },
  "scrapedAt": {
    "label": "Scraped At",
    "format": "date"
  },
  "priceList": {
    "label": "Прайс-лист"
  },
  "providerEducation": {
    "label": "Образование исполнителя"
  },
  "jobAdvantages": {
    "label": "Преимущества вакансии"
  },
  "jobSeeker": {
    "label": "Соискатель"
  },
  "infrastructure": {
    "label": "Инфраструктура рядом"
  },
  "videoUrl": {
    "label": "Видео"
  },
  "sparePart": {
    "label": "Запчасть"
  },
  "campaigns": {
    "label": "Оптовые предложения"
  },
  "highwayDirectionId": {
    "label": "Направление (шоссе)"
  },
  "building": {
    "label": "О доме"
  }
}
```

## About this Actor

This example demonstrates how to use [Парсер объявлений Авито / Avito Scraper: телефоны и цены](https://apify.com/zen-studio/avito-listings-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/zen-studio/avito-listings-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/zen-studio/avito-listings-scraper.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).