DEV Community

Mikayla Rakolta
Mikayla Rakolta

Posted on

Adding event-aware STR pricing to your AI agent in 2 curl commands

#api #ai #python #webdev

If you're building an AI agent that touches short-term rental pricing — whether that's a chatbot for Airbnb hosts, a booking automation tool, or a portfolio-level dashboard — you've probably run into the same problem I did: there's no clean API that returns agent-ready pricing data.

Most rental pricing tools assume a human is reading the output. They return raw numbers and leave formatting to you. For agent pipelines, that means extra processing: parse the price, build the reasoning string, inject it into your context. Annoying boilerplate that stacks up fast.

PriceNest is built differently. Here's how to get started in two commands.

Step 1: Get an API key

No signup form. Just POST your email:

curl -X POST https://api.mikiware.com/create-api-key \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'
Enter fullscreen mode Exit fullscreen mode

Your key comes back in the response. That's it.

Step 2: Price a property 

curl -X POST https://api.mikiware.com/rental/pricing \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address": "123 Beach Rd, Destin, FL", "date": "2026-03-15"}'
Enter fullscreen mode Exit fullscreen mode

Example response:

{
  "adjusted_pricing": {
    "suggested_nightly_price": 412,
    "active_events": ["spring_break_vacation"],
    "confidence_label": "high",
    "reasons_for_agents": "$412/night (+25% above $330 baseline) — spring_break_vacation window active, high confidence"
  },
  "calls_remaining": 74
}
Enter fullscreen mode Exit fullscreen mode

The field that matters: reasons_for_agents

The reasons_for_agents string is the whole point for agent developers. It's a complete, human-readable explanation of the pricing recommendation, pre-formatted for injection into any LLM message. You return it as-is from a tool call. No formatting work. No string building. Your agent gets clean context with the reasoning already embedded.

Here's how it looks as a LangChain tool:

@tool
def get_rental_pricing(address: str, date: str) -> str:
    """Returns nightly pricing recommendation for an STR property."""
    resp = requests.post(
        "https://api.mikiware.com/rental/pricing",
        headers={"x-api-key": PRICENEST_KEY},
        json={"address": address, "date": date}
    )
    return resp.json()["adjusted_pricing"]["reasons_for_agents"]
Enter fullscreen mode Exit fullscreen mode

What data powers it

  • 60+ Power 4 college football and basketball home game dates (with 10-mile surge radius)
  • 310+ universities: graduation, move-in week, family weekend, and homecoming windows
  • 26 spring break vacation markets with school-specific date windows
  • Up to 15 live comparable listings per query via RentCast

Free endpoints

GET /events/preview — free, no key required — returns active event windows for your market. GET /universities/nearby is also free. Both useful for pre-flight checks before committing a paid call.

Batch pricing

/rental/pricing/batch lets you price up to 7 dates in a single call. RentCast is queried once, so cost does not scale linearly with dates.

Pricing model

$2.99/call or discounted credit packs. No subscription. Credits never expire — ideal for bursty agent workloads.

Full docs and credit packs at https://mikiware.com.

Top comments (0)