EveryData platform API
Realtor API
The scope of this Realtor API is Realtor.com property and agent discovery plus property details; its 3 actions, including `search`, `property_search`, `property_detail`, retain independent inputs and returned-object meanings.
In the Realtor catalog, `keyword` drives `search` for matching Realtor results, whereas `keyword` drives `property_search` for property-search results; a shared identifier never merges their response fields.
- Endpoint
- POST /api/v1/social
- Capabilities
- 3
- Per 1,000
- $1.389
Available capabilities
Compare the Realtor actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on Realtor. Accepts these parameters: | keyword | agent_type, min_rating | Sync delivery | Catalog values: defaultLimit=100, maxLimit=500. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · name · url · title · text · office_name · broker_name · city · state · postal_code · country · license_no · rating · rating_scale · review_count · active_listings · recently_sold · price_min · price_max · specialties · languages · served_areas · emails · phones · image_url · platform |
property_searchProperty search Search Realtor with the | keyword | city, max_price, min_price, sort, status | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · status · price · sold_price · sold_at · listed_at · property_type · beds · baths · area_sqft · lot_sqft · year_built · address · city · state · postal_code · county · lat · lng · image_url · photo_count · is_new_listing · is_price_reduced · is_foreclosure · platform |
property_detailProperty details Retrieve property details from Realtor. Accepts these parameters: | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · title · status · price · sold_price · sold_at · updated_at · property_type · beds · baths · area_sqft · year_built · address · city · state · postal_code · platform |
What does each Realtor action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Realtor search parameters mean?
Search public results on Realtor. Accepts these parameters: keyword, min_rating, and agent_type. Returns these fields: name, office_name, rating_scale, and specialties.
keywordRequired- Specifies the search location for Realtor requests. For
search, enter a city and state (e.g.,Austin, TX) to find agents. Forproperty_search, enter a 5-digit US ZIP code or aCity, STabbreviation. Arbitrary property descriptions are not accepted. agent_typeOptional- Specifies the agent type for
search. Allowed values areboth(includes buyer and seller agents, default),buyer(buyer agents only), andseller(seller agents only). This parameter does not represent property listing status.Realtor: Differences Between Buyer's and Seller's AgentsRealtor agent search categorizes agents as Buy, Sell, and Both, explaining that buyer's agents and listing seller's agents fulfill different roles. This clarifies practitioner categories and does not indicate that EveryInfra provides brokerage representation services.Checked min_ratingOptional- Filters agents by minimum rating for
search. Pass a string array, such as["4"]. Allowed values are0,1,2,3,4, and5, where0disables filtering. This parameter filters agent ratings, not property ratings.
What do the Realtor property_search parameters mean?
Search Realtor with the property_search action. Accepts these parameters: city, min_price, keyword, max_price, status, and sort. Returns these fields: title, state, lot_sqft, and price.
keywordRequired- Specifies the search location for Realtor requests. For
search, enter a city and state (e.g.,Austin, TX) to find agents. Forproperty_search, enter a 5-digit US ZIP code or aCity, STabbreviation. Arbitrary property descriptions are not accepted. cityOptional- Overrides the city name for
property_search. Do not pass a conflicting city when searching by ZIP code to avoid generating contradictory location conditions. max_priceOptional- Specifies the maximum listing price for the standard input and takes precedence over
price_maxin the same request. Interpret prices separately for sale and rental listings. min_priceOptional- Specifies the minimum listing price for the standard input and takes precedence over
price_minin the same request. This parameter filters property prices, not agent service fees. sortOptional- Specifies the sort key for
property_search. Defaults tolist_date. Allowed values arelist_date,list_price,sold_price,sold_date,beds,lot_sqft,photo_count, andlast_update_date. Sorting is fixed in descending order;price_ascis not supported for low-to-high pricing. statusOptional- Specifies a single property status string for
property_search. Defaults tofor_sale. Allowed values arefor_sale,sold,for_rent,ready_to_build,off_market,other, andnew_community. The system wraps this string into a single-element list; passing a raw array directly is not accepted.
What do the Realtor property_detail parameters mean?
Retrieve property details from Realtor. Accepts these parameters: url. Returns these fields: price, postal_code, year_built, and city.
urlRequired- Specifies the Realtor detail URL for
property_detail, which should contain a_M<digits>-<digits>suffix to extract theproperty_id. You may also pass a property ID or full address in this field. Other URLs lacking an extractable ID are not guaranteed to resolve.
How to use the Realtor API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"realtor","action":"search","params":{"keyword":"<keyword>"}}'
Realtor API questions
What can I retrieve with the Realtor API?
Set platform to realtor. The current catalog lists search, property search, and property details. These action names identify different Realtor objects or views; they are not interchangeable search modes.
Which input starts a Realtor `search` request?
Specifies the search location for Realtor requests. For search, enter a city and state (e.g., Austin, TX) to find agents. For property_search, enter a 5-digit US ZIP code or a City, ST abbreviation. Arbitrary property descriptions are not accepted. Send it as keyword inside params.
Which fields can Realtor `search` return?
Its declared schema includes name, title, text, and office_name. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Realtor action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.