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

ZIP-code agent discovery Start with the required postal_code search input. A successful Manhattan ZIP-code probe returned a populated agent page.
Buyer, seller, and language refinement Use the documented BUYER or SELLER role and one listed language slug to design a focused shortlist; these filters were not independently probed.
Agent-specific ranking choices Choose relevance, ratings and reviews, sales, recommendations, or recent activity using the documented sort values. RELEVANT_AGENTS is the documented default.
Count-aware directory pagination Combine limit up to 20 with offset, and keep the observed matching_rows total separate from the agents array on the current page.
Observed brokerage and activity context Compare the brokerage, rating, and listing-statistic information seen in the successful response without treating activity dates as a freshness guarantee.

Live API Demo

GET /api/project/realty-in-us/agents-v2-list

Request cost is temporarily unavailable. No price is assumed.

View pricing

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'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →