Get reviews associated with a selected real estate agent
View all Realty in US Property & Mortgage Data endpoints →Request reviews for a selected agent by sending fulfillment_id as the required string query parameter. Obtain its value from the fulfillment_id field in an /agents/v2/list result; the documented example is 1365510. This request does not take profile_id. No review-specific pagination, date range, star-rating filter or sorting parameter is documented. The available documentation example is an incomplete profile-shaped object, repeated across the agent profile, recommendation and review operations. Its ratings object includes numeric reviews_count, average_rating and overall_rating fields, plus responseCount, overall_satisfaction, performance_rating, recommendation_rating, show_scores and testimonial_return_rate shown as strings. These are unverified example fields rather than observed review-response guarantees. The evidence does not define a list of individual reviews, review text, reviewer names, review dates, attribution fields or a rating scale. No live probe response is available for this operation. Inspect an actual result before building review cards or aggregating ratings, and preserve any review metadata and attribution that are actually returned. Do not infer a star scale or derive a score from missing fields. If an actual result explicitly returns an empty review collection, label it as no retrieved reviews rather than a poor rating; an absent or unsuccessful response is not evidence of zero reviews.
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-get-reviews API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-v2-get-reviews?key=<API_KEY>&fulfillment_id=1365510'
Query Result
Use Cases
- Fetch reviews on demand for two or three agents a homebuyer is actively comparing instead of bulk-copying feedback for an entire directory.
- Retain review metadata and attribution from actual entries in a selected-agent reading pane without inventing reviewer names or publication dates.
- Design distinct UI states for an explicit empty review collection, a missing review field and a failed request so none is displayed as a low rating.
- Validate the returned ratings.reviews_count and rating types before adding a comparison summary, avoiding an unsupported conversion to a five-star score.
- Assess whether a review timeline is feasible by checking actual date fields first, since the documentation example provides no review-entry date schema.
Frequently asked questions
Where does the review lookup get its fulfillment_id?
Use the fulfillment_id field from the agent selected in /agents/v2/list. It is a required string parameter with documented example 1365510. Do not substitute the agent's id or pass profile_id to this operation.
Which rating fields are documented for agent reviews?
The incomplete profile-shaped example includes ratings.reviews_count, average_rating and overall_rating as numbers. It also shows responseCount and several satisfaction-related fields as strings. No live response is available to confirm this review operation's structure, and the example does not define a rating scale.
Are individual review text, reviewer and date fields verified?
No. The supplied example does not establish a review-entry collection or its text, reviewer, attribution or date fields. Inspect the actual response before building review cards, and preserve any metadata and attribution actually provided.
Can I request only recent reviews or a specific star rating?
No date-range, star-rating, pagination or sorting parameters are documented. Only fulfillment_id is defined for this request. Do not assume the operation supports those filters or that the available evidence establishes a complete review history.
How should my application display an agent with no retrieved reviews?
If the actual response explicitly contains an empty review collection, show a neutral no retrieved reviews state. If fields are missing or the request fails, show unavailable data instead. Neither condition proves poor service, a zero rating or an absence of all reviews elsewhere.