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

Mikayla Rakolta — Thu, 09 Apr 2026 23:57:18 +0000

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"}'

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"}'

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
}

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"]

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.

DEV Community: Mikayla Rakolta