Legacy agent recommendations lookup (deprecated)

View all Realty in US Property & Mortgage Data endpoints →

Retrieve the legacy recommendation resource associated with an agent's advertiser identifier. This deprecated operation is a maintenance and migration reference for existing recommendation widgets, not a recommended starting point for a new integration. Its single required query parameter is numeric advertiser_id, sourced from the advertiser_id field in the legacy /agents/list result for the agent. No pagination or filter inputs are documented. The only available response example is labeled HTTP 200 and contains an empty JSON object ({}); it is an unverified source example, with no observed probe response. Recommendation text, author attribution, dates, scores, counts, result ordering, and error fields are not documented. Do not interpret the example as proof of zero recommendations or a guarantee that the route remains available, and do not treat this resource as a recommended-agent search result or a verified rating feed. When planning a move to a current fulfillment_id-based recommendation contract, verify the agent identity and each identifier mapping explicitly instead of equating advertiser_id with fulfillment_id.

API Features

Advertiser-keyed recommendation lookup Retain the single required numeric advertiser_id query value documented for an agent's legacy recommendation resource.
Recommendation-widget provenance Keep the association between cached recommendation content and its original advertiser_id visible during an older widget's migration audit.
Recommendation schema boundary Document that the sole unverified example is {} and establishes no recommendation text, author, date, score, count, or ordering fields.
Fulfillment-key migration review Plan any move to a current fulfillment_id-based recommendation contract with explicit agent identity verification, not an automatic identifier substitution.

Live API Demo

GET /api/project/realty-in-us/agents-get-recommendations-deprecated

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

Use Cases

Frequently asked questions

Which identifier is required to request legacy agent recommendations?

Supply the numeric advertiser_id query parameter. The documented source is the advertiser_id field in the legacy /agents/list result for the intended agent. No additional query parameters are documented for this operation.

Does this operation find agents recommended for a property search?

The documented purpose is to retrieve an agent's recommendations using advertiser_id, not to search for or rank recommended agents. The supplied example does not establish the recommendation item format or ranking semantics.

Are recommendation text, authors, dates, or ratings available in the documented response?

None of those fields are established. The only source example is labeled HTTP 200 and contains {}, and no probe response is available. A recommendation list, score, count, and display ordering must not be assumed from that example.

Does the empty example mean the agent has no recommendations?

No. It is an unverified source example, not an observed recommendation count. It establishes neither an empty-result rule nor current route availability, so it should not be published as a zero-recommendation finding.

Can a legacy advertiser_id be passed unchanged to a current fulfillment_id-based recommendation route?

The supplied facts do not establish that mapping. Confirm the agent identity and the target contract first, then retain the verified crosswalk and cached-content provenance as part of migration.

Related operations

Guides

View Subscription Plans →