Typed Python client for Repull — one API for vacation-rental tech: Airbnb, Booking.com, Vrbo and more channels, plus 14 PMS platforms, behind one key, with white-label Connect for linking your users' accounts.
Async by default. Generated from OpenAPI. Fully typed (attrs + httpx).
pip install repull-sdkThe package installs as repull-sdk and imports as repull.
Requires Python 3.10+.
import asyncio
import os
from repull import AuthenticatedClient
from repull.api.reservations import list_reservations
async def main():
client = AuthenticatedClient(
base_url="https://api.repull.dev",
token=os.environ["REPULL_API_KEY"],
)
async with client as c:
page = await list_reservations.asyncio(client=c, limit=10)
for r in page.data:
print(r.id, r.check_in, r.check_out, r.platform)
asyncio.run(main())There is also a sync flavour for every endpoint — drop the async with and call list_reservations.sync(...) instead.
Every call goes through AuthenticatedClient(token=...). The token is your Repull API key — it looks like sk_live_....
Get one at repull.dev/dashboard → API keys.
The client is generated tag-by-tag from the OpenAPI spec. The modules mirror the API surface:
| Module | Endpoints |
|---|---|
repull.api.system |
GET /v1/health |
repull.api.properties |
list / get properties |
repull.api.reservations |
list / get / create / patch / delete reservations |
repull.api.availability |
per-property calendar read + bulk write |
repull.api.guests |
guest CRM list + detail |
repull.api.conversations |
list threads, read & post messages |
repull.api.connect |
white-label OAuth Connect — list, status, create, disconnect |
repull.api.webhooks |
manage subscriptions + fire test events |
repull.api.airbnb |
listings, pricing, availability, photos, messaging, reservations, reviews, sync |
repull.api.booking_com |
properties, availability, content, messaging, sync |
repull.api.vrbo |
listings, reservations |
repull.api.billing |
view & change plan |
Everything is fully typed — your editor will autocomplete every parameter and every response field.
examples/quickstart.py— list 10 reservations.examples/connect_airbnb.py— mint a Connect session and poll for the linked Airbnb account.
Run them with a real API key:
REPULL_API_KEY=sk_live_... python examples/quickstart.pyRepull Connect lets you link a property manager's Airbnb, Booking.com, Vrbo or PMS account in a few lines:
from repull.api.connect import create_connect_session
from repull.models.create_connect_session_body import CreateConnectSessionBody
session = await create_connect_session.asyncio(
client=c,
body=CreateConnectSessionBody(
redirect_url="https://yourapp.example.com/airbnb/return",
allowed_providers=["airbnb"],
),
)
# Send the user to session.urlAfter the user comes back, poll get_connect_status.asyncio(provider="airbnb", client=c) to confirm.
Every list endpoint returns the same canonical envelope:
page = await list_reservations.asyncio(client=c, limit=50)
page.data # list[Reservation]
page.pagination.next_cursor # str | None — pass back as `cursor=`
page.pagination.has_more # bool — stop when False
page.pagination.total # int | UNSET — present when ?include_total=trueLoop until pagination.has_more is False, threading pagination.next_cursor
back as the next call's cursor arg. Cursors are opaque base64 — never parse
or construct them by hand.
By default, unexpected HTTP statuses return None from the high-level .asyncio() / .sync() calls. To raise instead:
client = AuthenticatedClient(
base_url="https://api.repull.dev",
token=os.environ["REPULL_API_KEY"],
raise_on_unexpected_status=True,
)You can also call .asyncio_detailed() / .sync_detailed() to get the full Response (status code, headers, raw bytes, parsed body).
The repo snapshots the current spec at openapi/v1.json so codegen is fully reproducible.
# Pull a fresh spec from api.repull.dev and regenerate
./scripts/regen.sh
# Use the snapshot in openapi/v1.json without hitting the network
./scripts/regen.sh --offlineYou'll need openapi-python-client on your PATH:
uv tool install openapi-python-client
# or
pipx install openapi-python-client- API base: https://api.repull.dev
- OpenAPI spec: https://api.repull.dev/openapi.json
- Product docs: https://repull.dev/docs
- Other SDKs:
repull-sdk(TypeScript),repull-php,repull-go,repull-ruby,repull-dotnet
MIT — see LICENSE. The Python client is a thin auto-generated wrapper, free to use anywhere.
(Note: the TypeScript SDK is licensed differently because it ships a hand-written facade plus the demo + channel-manager template. See repull-sdk if you need that.)
Powered by Repull.