100 free credits. No credit card required.Start building
Logo
Realtor.com logoRealtor.com API

Get Realtor.com listing data with one API

Fetch Realtor.com homes for sale and for rent from any search link, then read one home with its description and photos, as structured JSON with one SocialCrawl API key. Reads are priced in credits.

Realtor.com logo
/v1/realtor

2 active endpoints. Home search and home detail.

  • GET /v1/realtor/search
  • GET /v1/realtor/property

What Realtor.com endpoints does SocialCrawl ship?

Two read endpoints for public Realtor.com data. Search an area from a Realtor.com search link, for sale or for rent, page by page, and read one home by its link.

Home search

1 credit
/v1/realtor/search

Homes for sale or for rent for a Realtor.com search link, 40 a page by default and up to 200 with limit, with Realtor.com's total. Each home has its Realtor.com property id, address, coordinates, main photo, price or monthly rent, status, beds, baths, square feet, lot size, year built and home type. Standard tier (1 credit).

url, limit, page

Home detail

1 credit
/v1/realtor/property

One home by its Realtor.com link: the same listing facts as a search row plus the description and the photo gallery. Realtor.com sends no price or tax history here. Standard tier (1 credit).

url

Realtor.com API2 endpoints supported
View docs
Listings

Returns Realtor.com homes for sale or for rent from a search link: price or monthly rent, status, beds, baths, size, lot, year built and home type, up to 200 a page.

Use it to list an area's homes from a Realtor.com search link, then page through with the cursor.

1 credit

GET/v1/realtor/search?url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2FAustin_TX
$ curl https://www.socialcrawl.dev/v1/realtor/search?url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2FAustin_TX \
    -H "x-api-key: sc_YOUR_API_KEY"
idle
// Running this live needs your own API key. Hit "Try it" to see an example response

How the Realtor.com API works

Realtor.com is a normal SocialCrawl data surface. You call GET /v1/realtor/… with an API key, spend credits on live misses, and get a single JSON envelope back.

Authenticate every call

Send your key in the x-api-key header. No Realtor.com account or partner access is needed for public reads. The same key works across SocialCrawl platforms.

GET with query params

Search takes url, a Realtor.com search link with any filters, plus limit and the cursor. Property takes url, a home's link. Formats are validated before any charge.

Pay in credits, not seats

Both Realtor.com routes cost 1 credit. Cache hits cost 0.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists also carry pagination when the route pages.

The usual integration chain

Most products page through an area's listings from a saved search link, often on a schedule.

01Search homes for sale
GET /v1/realtor/search?url=…&limit=…

PlaceList of up to 200 homes a page

A Realtor.com city or ZIP code search link carries its own filters.

02Search rentals
GET /v1/realtor/search?url=https%3A%2F%2Fwww.realtor.com%2Fapartments%2F…

PlaceList of homes for rent

A link under /apartments/ returns status for_rent with the monthly rent as price.

03Read the home
GET /v1/realtor/property?url=…

Place with description and photos

Pass the home's Realtor.com link; place.url on every search row is one.

request
GET /v1/realtor/search?url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2F78704&limit=40
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
response envelope
{
  "success": true,
  "data": {
    "items": [
      {
        "place": {
          "id": "7006116543",
          "name": "2200 Dickson Dr Apt 127",
          "category": "condo",
          "ext": {
            "listing": {
              "price": 269000,
              "currency": "USD",
              "status": "for_sale",
              "beds": 1,
              "baths": 1,
              "sqft": 640,
              "year_built": 2008
            }
          }
        }
      }
    ],
    "total": 389,
    "next_cursor": "2"
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

What lands in data

Field names match the rest of SocialCrawl where archetypes align. Parse once, reuse across platforms.

PlaceListsearch

items[] with id (Realtor.com property id), name, address, coordinates, photo, ext.listing with price, status, beds, baths, sqft, lot_sqft, year_built, home_type

Listing statussearch

status for_sale or for_rent; on a rental, price is the monthly rent

Placeproperty

the search row's listing facts plus the description and image_urls[]; no price or tax history

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. Realtor.com is not a sidecar.

  1. 01

    Edge receives the call

    Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).

  2. 02

    Validate, then debit

    Registry lookup finds the realtor route. Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before the read starts.

  3. 03

    Cache or fetch

    A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the public page is read live, with retries on 5xx or network errors and a circuit breaker if the source is unhealthy.

  4. 04

    Normalize and return

    Realtor.com data is mapped to the Place and PlaceList archetypes with the listing facts in place.ext.listing, validated, then wrapped in the success envelope and logged for billing audit.

Billing rules that matter in production

  • search and property: 1 credit
  • Cache hit: 0 credits
  • Empty / hard fail: auto-refund
  • Bad params: 400, never charged
  • No credits: 402, never charged
  • Search: up to 200 homes a page
  • No price history on this source
  • Money in US dollars, areas in square feet
  • No agent contact, tour or offer tools

How SocialCrawl gets Realtor.com data

Realtor.com is public read data. We normalize it into the SocialCrawl schema so your code does not learn a second vendor SDK.

What Realtor.com is for this API

Public search results for homes for sale and for rent in the United States, with price or monthly rent, beds, baths, size, lot size, year built and home type.

How SocialCrawl reaches it

Public pages are read on request and normalized server-side. You never run a Realtor.com login or partner integration.

What leaves our edge

PlaceList for searches and Place for one home. The listing facts sit in place.ext.listing, the same shape Zillow and Redfin homes use.

What we do not ship live

No price history, agent contact, tour requests, offers or saved searches.

field map sketch
Realtor.com home→ place.*Realtor.com property id, street line, full address, coordinates
listing facts→ place.ext.listingprice or monthly rent, status, beds, baths, square feet, lot size, home type
search page→ data.total / next_cursorRealtor.com's total and the next page cursor

What this API is used for

The jobs this API is most often used for.

2active Realtor.com endpoints in the registry
1credit per call on every Realtor.com route

Inventory by area, for sale and for rent

Callers page through an area's listings from a saved Realtor.com search link, often on a schedule. For-sale and rental listings from any Realtor.com search link, up to 200 a page, from one key in the shared Place schema Zillow and Redfin homes use.

Live misses read the public page on request. Repeat calls hit cache and cost 0 credits.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

Inventory monitoring by area

Node, scheduled jobs

search on the same Realtor.com link on a schedule to see which homes were newly listed, changed price or no longer appear.

Rental supply

Python, notebooks

search a rental link under /apartments/ to count homes for rent and their asking rents by area.

Cross-site listing coverage

Python, warehouse loads

search the same area on Realtor.com, Zillow and Redfin and join on address to see which homes each site carries.

How to call the Realtor.com API

Both Realtor.com routes are 1 credit. Cache hits are free.

curl "https://www.socialcrawl.dev/v1/realtor/search?url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2FAustin_TX&limit=40" \n  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/realtor/property?url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-detail%2F14109-Willow-Tank-Dr_Austin_TX_78717_M78336-55435" \n  -H "x-api-key: sc_your_api_key_here"
Realtor.com logoRealtor.com on SocialCrawl

Same key as the rest of the catalog

Endpoints

What data does the Realtor.com API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What does the SocialCrawl Realtor.com API cover?
It covers 2 endpoints: Search and Property. They search homes for sale or for rent from a Realtor.com search link, page by page, and read one home by its link, in the same unified JSON as the other 94 platforms.
Can I get Realtor.com rental listings?
Yes. Pass a rental search link under /apartments/, for example https://www.realtor.com/apartments/Austin_TX. Rows come back with status for_rent and the monthly rent as the price.
Does the Realtor.com API return price history?
No. Realtor.com search rows and home records carry the current price only, so place.ext.listing.price_history is null. Zillow and Redfin homes return their price and tax history on SocialCrawl.
How many homes does one Realtor.com search return?
40 a page by default and up to 200 with limit, with Realtor.com's total. Pass the returned cursor for the next page and de-duplicate on place.id, because a home can appear on two consecutive pages.
How much does the Realtor.com API cost?
The Realtor.com route costs 1 credit a call and cache hits are free. A new account gets 100 free credits with no card.
Is scraping Realtor.com data legal?
SocialCrawl returns publicly available Realtor.com data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Realtor.com's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Realtor.com scraping API vs the official Realtor.com API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Realtor.com endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Read the Realtor.com API reference in the docs

🤖 AI agent or LLM? Read this page as markdown