Find real estate agents by ZIP code and profile filters
View all Realty in US Property & Mortgage Data endpoints →Search for agents using a postal code, with optional name or marketing-area criteria, buyer/seller role, spoken language, identifier-presence filters, and ranking. This operation marks postal_code as required: although the source description describes marketing_area_city, name, and postal_code as alternative search criteria, this contract still requires postal_code even when another criterion is supplied. marketing_area_city is documented as a location result id from the agent location-search operation; its response format has not been verified here. limit controls the page size, up to 20, and offset skips that many results. The documented sort default is RELEVANT_AGENTS. A successful probe using postal_code=10001, limit=3, offset=0, and sort=RELEVANT_AGENTS returned data.search_agents.matching_rows=486 and three records in data.search_agents.agents. Observed agent records included names, identifiers, brokerages, ratings, and listing statistics. matching_rows is the total match count, not the length of the current agents page. Some returned listing activity referred to October 2026; this does not establish a refresh schedule or the freshness of every record. The supplied source response example is empty, so no additional response fields or guaranteed field completeness are established. Only the probed ZIP-code search and ranking combination was observed; the other documented filters have not been separately verified.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/realty-in-us/agents-v2-list API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-v2-list?key=<API_KEY>&postal_code=<postal_code>&sort=RELEVANT_AGENTS'
Query Result
Use Cases
- Create a relocation shortlist for a ZIP code using a documented language value and BUYER role, then verify the selected filters against returned records.
- Build an agent directory that displays the total matching_rows count separately from each limit-and-offset result page.
- Help a homeowner explore local seller representatives with SELLER and MOST_SALES while keeping ratings and listing activity distinct.
- Support an agent, team, or company name lookup within the required postal-code search context.
- Let users compare observed brokerage and profile metrics before choosing which agent to research further, without implying an endorsement or guaranteed availability.
Frequently asked questions
Can I omit postal_code when I provide a name or marketing_area_city?
No. The source description refers to those three criteria as alternatives, but this operation marks postal_code as required. Supply it even when using name or marketing_area_city; do not assume those fields replace the required input.
How do matching_rows, limit, and offset differ?
matching_rows is the observed total match count, limit is the requested page size with a documented maximum of 20, and offset is the number of results to skip. One successful probe returned 486 matching rows but only three agents because limit was 3.
Which agent roles and languages can I request?
agent_type documents BUYER or SELLER, or it may be omitted. languages accepts one documented language slug, such as spanish, chinese, or english. Combining several languages in one request is not documented, and these filters were not separately probed.
What is the default ranking, and what alternatives are documented?
The documented default is RELEVANT_AGENTS. Other documented values are RATINGS_REVIEWS, MOST_SALES, TESTIMONIALS_RECOMMENDATIONS, and MOST_RECENT_ACTIVITY. The successful probe used RELEVANT_AGENTS.
Do identifier filters or recent activity verify an agent profile?
No. agent_filter_criteria tests for the documented identifier-presence conditions; it is not a licensing or quality certification. Some observed listing activity referenced October 2026, but that does not verify the freshness or completeness of every agent record.