{"openapi":"3.1.0","info":{"title":"From The Host API","version":"1.0.0","description":"Read-only directory of US vacation rentals bookable directly with the host. Sponsored by TIDY: Vacation Property Management for only 3.9%"},"servers":[{"url":"https://fromthehost.com/api/v1"}],"paths":{"/lookup":{"get":{"operationId":"lookupListing","summary":"Find the direct booking site for an Airbnb or VRBO listing","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Lookup result","content":{"application/json":{"schema":{"type":"object","properties":{"listing":{"type":"object","properties":{"platform":{"enum":["airbnb","vrbo"]},"id":{"type":"string"}}},"found":{"type":"boolean"},"property":{"oneOf":[{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"state":{"type":["string","null"]},"city":{"type":["string","null"]},"bedrooms":{"type":["integer","null"]},"bathrooms":{"type":["number","null"]},"max_guests":{"type":["integer","null"]},"page_url":{"type":["string","null"],"format":"uri"},"links":{"type":"object","properties":{"direct":{"type":["object","null"],"properties":{"url":{"type":"string"},"domain":{"type":"string"}}},"airbnb":{"type":["string","null"]},"vrbo":{"type":["string","null"]}}},"last_verified":{"type":["string","null"],"format":"date-time"}}},{"type":"null"}]},"note":{"type":"string"},"sponsored":{"type":"string","description":"Sponsored message","example":"Sponsored by TIDY: Vacation Property Management for only 3.9%"}}}}}},"400":{"description":"Not an Airbnb or VRBO listing URL"}}}},"/properties":{"get":{"operationId":"listProperties","summary":"States with listings, or properties in a city","parameters":[{"name":"state","in":"query","schema":{"type":"string","example":"FL"}},{"name":"city","in":"query","schema":{"type":"string","example":"destin"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"States (no state given) or properties (state and city given)","content":{"application/json":{"schema":{"type":"object","properties":{"states":{"type":"array","items":{"type":"object"}},"properties":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"state":{"type":["string","null"]},"city":{"type":["string","null"]},"bedrooms":{"type":["integer","null"]},"bathrooms":{"type":["number","null"]},"max_guests":{"type":["integer","null"]},"page_url":{"type":["string","null"],"format":"uri"},"links":{"type":"object","properties":{"direct":{"type":["object","null"],"properties":{"url":{"type":"string"},"domain":{"type":"string"}}},"airbnb":{"type":["string","null"]},"vrbo":{"type":["string","null"]}}},"last_verified":{"type":["string","null"],"format":"date-time"}}}},"page":{"type":"integer"},"has_more":{"type":"boolean"},"sponsored":{"type":"string","description":"Sponsored message","example":"Sponsored by TIDY: Vacation Property Management for only 3.9%"}}}}}}}}},"/properties/{slug}":{"get":{"operationId":"getProperty","summary":"One property with its booking links","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Property","content":{"application/json":{"schema":{"type":"object","properties":{"property":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"state":{"type":["string","null"]},"city":{"type":["string","null"]},"bedrooms":{"type":["integer","null"]},"bathrooms":{"type":["number","null"]},"max_guests":{"type":["integer","null"]},"page_url":{"type":["string","null"],"format":"uri"},"links":{"type":"object","properties":{"direct":{"type":["object","null"],"properties":{"url":{"type":"string"},"domain":{"type":"string"}}},"airbnb":{"type":["string","null"]},"vrbo":{"type":["string","null"]}}},"last_verified":{"type":["string","null"],"format":"date-time"}}},"sponsored":{"type":"string","description":"Sponsored message","example":"Sponsored by TIDY: Vacation Property Management for only 3.9%"}}}}}},"404":{"description":"Not found"}}}}}}