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

Selected-agent review request Use the selected directory record's fulfillment_id for a review lookup, without introducing unsupported reviewer, date or star-filter parameters.
Review count and rating field reference The documentation example includes ratings.reviews_count, average_rating and overall_rating, but does not verify their availability in the review response or define a rating scale.
Mixed-type rating parsing guidance The sample shows responseCount and several satisfaction-related values as strings alongside numeric ratings; preserve types and avoid assuming every value is a number.
Review attribution preservation If review entries are returned, retain their actual metadata and attribution. The available example does not establish reviewer, text or date field names.
Honest empty-review states An explicitly empty review collection can be shown as no retrieved reviews, while missing or failed results remain unavailable rather than implying negative feedback.

Live API Demo

GET /api/project/realty-in-us/agents-v2-get-reviews

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-get-reviews?key=<API_KEY>&fulfillment_id=1365510'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →