# Documentation

- Getting Started

  - **Getting Started**
  - [Overview](/docs): Get started with monetizing travel. Explore our suite of APIs and products to help you earn commissions on hotel and rental bookings.
  - [Quickstart](/docs/quickstart): Get from zero to your first tracked booking
- API

  - **Direct Travel API**
  - [Overview](/docs/api): Direct Travel API — live hotel and rental availability, prices, and deeplinks across Booking.com, VRBO, Expedia, and Hotels.com.
  - [Quickstart](/docs/api/quickstart): Make your first live accommodation search with the Direct Travel API in a few minutes.
  - [Authentication](/docs/api/authentication): Create an API key, send it with your requests, and handle missing or invalid keys.
  - [Rate Limits](/docs/api/rate-limits): Request limits and best practices for the Direct Travel API.
  - Concepts
    - [Overview](/docs/api/concepts): How the Direct Travel API resolves locations, prices stays, paginates, clusters, and shapes its responses.
    - [Locations & geocoding](/docs/api/concepts/locations): The four ways to tell the Direct Travel API where to search — address, coordinates, bounding box, or hotel IDs.
    - [Response & supplier model](/docs/api/concepts/response-model): How a search response is shaped — results, prices, deeplinks, and the supplier map.
    - [Pricing & quotes](/docs/api/concepts/pricing): When prices appear, what they cover, and how the price filters behave.
    - [Pagination](/docs/api/concepts/pagination): Paging through results with page and pageSize, and how to read meta.total and hasMore.
    - [Clustering](/docs/api/concepts/clustering): Summarizing dense map viewports into hex-grid (H3) markers instead of a flat list.
    - [Caching](/docs/api/concepts/caching): Cache responses to cut latency and stay within rate limits.
  - Recipes
    - [Code Examples](/docs/api/recipes/code-examples): JavaScript, Python, and cURL examples for the Direct Travel API.
  - Build with AI
    - [Overview](/docs/api/build-with-ai): Connect AI assistants and agents to the Direct Travel API.
    - [MCP Integration](/docs/api/build-with-ai/mcp): Connect AI assistants like Claude to the Direct Travel API via MCP.
    - [Agent Skills](/docs/api/build-with-ai/agent-skills): Install the accommodation search skill for AI coding agents.

  - **REST API**
  - [OpenAPI Spec](https://api.stay22.com/openapi.json)
  - Accommodations
    - [Search Accommodation](/docs/api/accommodations/search): Search accommodations (v2)
  - Reporting
    - [Retrieve partner transaction](/docs/api/reporting/transactions): Retrieve partner transactions
- Allez

  - **Allez**
  - [Overview](/docs/allez): Stay22's universal affiliate redirect endpoint for all major OTAs.
  - [Quick Start](/docs/allez/quick-start): Build a working Allez link in 30 seconds.
  - [Familiarize Yourself](/docs/allez/familiarize): Interactive examples and link builder for Allez.
  - [Parameters](/docs/allez/parameters): Complete parameter reference for Allez links.
  - [Troubleshooting](/docs/allez/troubleshooting): Common issues with Allez links and how to fix them.

  - ** Special Use cases**
  - [Searchbar](/docs/allez/searchbar): A dedicated Allez endpoint for integrating accommodation search into the search box.
  - [Retail](/docs/allez/retail): Monetize product references with Allez retail affiliation.

  - **Under the hood**
  - [Roam](/docs/allez/roam): How /allez/roam uses ML to pick the best provider for each user.
  - [Providers](/docs/allez/providers): OTA providers, geo-routing, and hotel name matching.
- Maps

  - **Maps**
  - [Overview](/docs/maps): Stay22 Maps is an embeddable accommodation map widget.
  - [Quick Start](/docs/maps/quick-start): Get a working Maps widget on your page in under a minute.
  - [Parameters](/docs/maps/parameters): All iframe URL parameters for Maps embeds.
  - [Troubleshooting](/docs/maps/troubleshooting): Common issues with Maps embeds and how to fix them.

  - **Under the hood**
  - [Widescale](/docs/maps/widescale): Deploy Allez links and Maps at scale without maintaining individual URLs.
  - [Secrets](/docs/maps/secrets): Advanced integration features using the SMAPS script.
- Mobile SDK

  - **Mobile SDK**
  - [Overview](/docs/mobile-sdk): The Stay22 Mobile SDK turns travel intent in your app into well-timed accommodation offers.
  - [Quick Start](/docs/mobile-sdk/quick-start): Install the Stay22 Mobile SDK, initialize it, and schedule your first accommodation notification.
  - [Notifications & Events](/docs/mobile-sdk/notifications): How the Stay22 notification lifecycle works, how to customize the copy, and how to observe every decision the SDK makes.
  - [Testing & Troubleshooting](/docs/mobile-sdk/testing): Verify your Stay22 Mobile SDK integration in minutes and diagnose why a notification didn't show.