Homesage.ai sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.homesage.ai/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

> Is there a neighborhood data API?

Is there a neighborhood data API?

Follow us on:

Inside this article:
Our Newsletter

Share

“Quick answer: Yes, a neighborhood data API returns facts about the area around one property. Our red-flags stream scores nearby places that can weigh on value for 5 credits, and our info call adds nearby school ratings for 2. On 2026-11-07 one Baltimore, Maryland property drew 7 flags within 0.3 miles and an aggregate risk score of 0.55 out of 10, labeled Low.

Is there a neighborhood data API, with nearby red flags and school ratings for one property

This page is for an engineer at a single-family rental fund. The acquisitions team screens properties on an internal tool and wants a neighborhood data API to score the surroundings of each one before anyone visits. Our neighborhood guide for investors covers what to look for in person.

Public neighborhood data and its limits

The Census Bureau's API serves the 2020 to 2024 American Community Survey 5-year estimates. They reach down to census tracts and block groups. Variable B25077_001E, for example, is the median value of owner-occupied units in an area.

For schools, the Education Department's Common Core of Data is an annual database of every public elementary and secondary school and district. It carries no ratings. Neither source lists what sits 0.2 miles from one property.

What a neighborhood data API returns

Our location red-flags call takes one field, address, and answers as a stream of Server-Sent Events. The docs give examples of flags from bars and liquor stores to power lines and visible blight.

Field in the API docsWhat it holds
flag_typeWhat the nearby place is, for example Transit Station
categoryThe group the type falls in, for example Transportation
distance_milesDistance from the property
importanceA weight from 1 to 5
flag_scoreThe score for that flag. The docs give no range
nameThe place's own name. Our example leaves it out
total_flags, aggregate_risk_scoreThe flag count, and a score from 0 to 10
risk_levelNone, Low, Moderate or High
school_ratings (info call)Per school, name, rating, parent_rating, distance_in_miles, grades, student_count, funding_type and education_levels

A fresh run costs 5 credits. The docs say a repeat of the same address by the same account within the cache TTL costs 0 credits and replays every event. A 400, 401 or 402 error costs 0 credits.

School ratings come from a second call. Our info endpoint returns a school_ratings list for 2 credits, and its docs say the ratings are refreshed annually.

A real example from a Homesage.ai API call

We ran both calls on one single-family property in Baltimore, Maryland, on 2026-11-07. A 1-credit search found the property, so the 3 calls used 8 credits.

What the calls returnedOne Baltimore property
Events, in orderrun_started, geocoded, area_classified, flags_detected, vision_analyzed, complete
area_typeUrban
detection_modesingle
search_radius_miles0.3
total_flags7
Flags by categoryTransportation 4, Adult/Vice 2, Commercial/Industrial 1
Nearest flagManufacturing Plant / Factory, 0.12 miles, importance 4, flag_score 0.68
vision_analyzed count0
aggregate_risk_score0.55
risk_levelLow
school_ratings4 schools. 3 public, rated 4, 2 and 2. 1 private, rating null
Credits1 for the search, 5 for the stream, 2 for info
info response time474 milliseconds

Seven flags sat within 0.3 miles, and the aggregate score came out at 0.55 out of 10, labeled Low. Four of the 7 were transit stations with importance 2. The nearest flag, a manufacturing plant, had the highest flag_score at 0.68.

Seven red flags near a Baltimore, Maryland property, risk score 0.55 out of 10, level Low

Seven red flags within 0.3 miles of one Baltimore property came with an aggregate risk score of 0.55 out of 10.

The stream sent run_started before the 5 events the docs list, and the vision step flagged nothing. In the info call, 3 public schools came back rated 4, 2 and 2. The private school had a null rating and a parent_rating of 5.

Baltimore school ratings: public elementary 4, public middle 2, public high 2, private school unrated

How to wire the 2 calls

Five steps to wire the neighborhood calls: open stream, read complete event, add schools, handle nulls

  1. Open the stream. POST the address to the red-flags stream. A fresh run costs 5 credits.
  2. Show the progress events. geocoded, area_classified, flags_detected and vision_analyzed arrive before the result. Our run also sent run_started first.
  3. Read the complete event. It holds total_flags, aggregate_risk_score, risk_level and the flags list. The docs say to use its payload as the final response.
  4. Add school ratings. GET info returns school_ratings for 2 credits.
  5. Handle errors and nulls. An error event ends the run, and the docs say errored runs never reach the cache. A school rating can be null.

Here is the stream call. The -N flag stops curl from buffering the events.

curl -N -X POST "https://api.homesage.ai/api/properties/red-flags/stream/" \ -H "Authorization: Bearer $HOMESAGE_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address": "<a US property address>"}'

The complete event from our Baltimore run looked like this, trimmed to 2 of the 7 flags with the place names removed.

{ "area_type": "Urban", "detection_mode": "single", "search_radius_miles": 0.3, "total_flags": 7, "aggregate_risk_score": 0.55, "risk_level": "Low", "flags": [ {"name": "<removed>", "flag_type": "Manufacturing Plant / Factory", "category": "Commercial/Industrial", "distance_miles": 0.12, "importance": 4, "flag_score": 0.68}, {"name": "<removed>", "flag_type": "Transit Station", "category": "Transportation", "distance_miles": 0.21, "importance": 2, "flag_score": 0.33} ] }

The full payload also echoes the address and coordinates. A cache hit adds from_cache and cached_at.

These fields describe places near a property, not the people who live there. They must not be used to steer buyers toward or away from an area. Federal fair-housing rules at 24 CFR 100.70(c) treat steering as unlawful.

Common neighborhood data mistakes

  • Expecting exactly 5 events: Our run sent run_started first. Match each event by its name.
  • Reading the flag count as the risk: Baltimore had 7 flags and a risk_level of Low. Read risk_level and aggregate_risk_score.
  • Assuming a range for flag_score: The docs give ranges for importance and the aggregate score only.
  • Treating a null rating as zero: The private school's rating came back null. Store it as missing.
  • Paying for a re-run: A repeat run inside the cache TTL costs 0 credits. The cache key is per account and address.

Your account terms set where these outputs can be shown, so check them before a flag or a school rating reaches your own customers.

Estimated values. Not investment advice. Data as of 2026-11-07.

Frequently asked questions

What public data describes a neighborhood?
The Census Bureau's API serves American Community Survey 5-year estimates down to census tracts and block groups. The Education Department's Common Core of Data lists every public school and district each year, with no ratings. Neither source lists the places near one property.
How do I get neighborhood data for an address?
Our neighborhood data API starts with the location red-flags stream, at 5 credits. Each nearby flag carries 6 fields, from flag_type to flag_score, and the stream adds a 0 to 10 aggregate risk score. Add our info call for nearby school ratings at 2 credits.
What counts as a location red flag?
Our API docs describe red flags as nearby places and street-level conditions that can weigh on a property's value. Their examples run from bars and liquor stores to power lines and visible blight.
How is the neighborhood risk score scaled?
The aggregate_risk_score runs from 0 to 10. The risk_level field reads None, Low, Moderate or High. Each flag's importance runs from 1 to 5. One Baltimore property with 7 flags scored 0.55, labeled Low, on 2026-11-07.
Does the API return school ratings?
Yes. Our info call returns a school_ratings list for 2 credits, and its docs say the ratings are refreshed annually. A rating can be null. In our Baltimore call, a private school had no rating.

Try the call

Run the red-flags stream on one property and read the complete event before you wire up a list. The API docs list every field and error code.

Read the API docs

Sources
Written by: The team at homesage.ai

We are a team of dedicated individuals with extensive experience in Real Estate, Home Improvement, and Artificial intelligence.  

Our mission is to help realtors, lenders, contractors and other professionals harness the power of AI to increase Business Volume.

Website Audit Icon Improve Performance

Increase Business Volume
with the power of AI

🔍

DealFinder Extension

Analyze any property listing instantly from your browser

Add to Chrome
📱

DealFinder Mobile App

AI-Powered Investment Analysis in Your Pocket

Scan QR to download DealFinder on the App Store App Store
Scan QR to download DealFinder on Google Play Google Play