100 free credits. No credit card required.Start building
Logo
Apartments.com logoApartments.com API

Get Apartments.com rent data with one API

Fetch Apartments.com rental buildings with their rent range, rent by bedroom count, current specials, amenities and phone, as structured JSON with one SocialCrawl API key. Reads are priced in credits.

Apartments.com logo
/v1/apartments

2 active endpoints. Building search and building detail.

  • GET /v1/apartments/search
  • GET /v1/apartments/property

What Apartments.com endpoints does SocialCrawl ship?

Two read endpoints for public Apartments.com data. Search an area's rental buildings from a search link, and read one building in full.

/v1/apartments/search

The rental buildings of an Apartments.com search link, 40 a page with the site's total, filters in the link kept. Each building has its listing id, name, address, coordinates, phone, lowest and highest rent, the lowest rent for each bedroom count, the current special and its amenities. Standard tier (1 credit).

url, page

/v1/apartments/property

One building in full by its Apartments.com link. Adds the full description, every photo and the star rating with its count where the listing shows one. Standard tier (1 credit).

url

Apartments.com API2 endpoints supported
View docs
Listings

Returns the rental buildings of an Apartments.com search link, 40 a page: lowest and highest rent, rent by bedroom count, specials, amenities and phone.

Use it to compare an area's rents and specials from an Apartments.com search link, filters included.

1 credit

GET/v1/apartments/search?url=https%3A%2F%2Fwww.apartments.com%2Faustin-tx%2F
$ curl https://www.socialcrawl.dev/v1/apartments/search?url=https%3A%2F%2Fwww.apartments.com%2Faustin-tx%2F \
    -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 Apartments.com API works

Apartments.com is a normal SocialCrawl data surface. You call GET /v1/apartments/… 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 Apartments.com account or partner access is needed for public reads. The same key works across SocialCrawl platforms.

GET with query params

Search takes url, an Apartments.com search link with any filters, plus the cursor. Property takes url, the building's link. Formats are validated before any charge.

Pay in credits, not seats

Both Apartments.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 compare an area's rents first, then read only the buildings that matter.

01Search buildings
GET /v1/apartments/search?url=…

PlaceList of 40 buildings a page

An Apartments.com search link carries its own price, bedroom and amenity filters.

02Compare rents
GET /v1/apartments/search?url=…&cursor=2

Rent by bedroom count and specials

place.ext.apartments holds the lowest rent per bedroom count and the current offer.

03Read the building
GET /v1/apartments/property?url=…

Place with description, photos and rating

Pass the building's link, which ends in its seven-character listing id.

request
GET /v1/apartments/search?url=https%3A%2F%2Fwww.apartments.com%2Faustin-tx%2F
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

GET /v1/apartments/property?url=https%3A%2F%2Fwww.apartments.com%2Floyola-junction-i-austin-tx%2F940ms65%2F
response envelope
{
  "success": true,
  "data": {
    "place": {
      "id": "940ms65",
      "name": "Loyola Junction I",
      "phone": "864-528-1774",
      "rating": { "value": 3, "max": 5 },
      "ext": {
        "listing": {
          "price": 1243,
          "currency": "USD",
          "status": "for_rent"
        },
        "apartments": {
          "price_max": 2257,
          "availability": "in_stock"
        }
      }
    }
  },
  "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 (listing id), name, address, coordinates, phone, ext.listing with the lowest rent, ext.apartments with price_max, rent_by_bedroom[], specials, amenities[]

Placeproperty

adds the description, every photo, rating and reviews_count

Rent by bedroomsearch

rent_by_bedroom[] with beds (0 for a studio), beds_text, price_from, price_text

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. Apartments.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 apartments 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

    Apartments.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: 40 buildings a page
  • Beds and baths per floor plan, not per building
  • Money in US dollars, per month
  • No lease applications, tours or messaging

How SocialCrawl gets Apartments.com data

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

What Apartments.com is for this API

Public search results and building pages for rental buildings in the United States, with rents by bedroom count, specials, amenities, phone and rating.

How SocialCrawl reaches it

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

What leaves our edge

PlaceList for searches and Place for one building. The lowest rent sits in place.ext.listing, the shape Zillow and Redfin homes use, and the rest in place.ext.apartments.

What we do not ship live

No lease applications, tour requests, messaging or saved searches.

field map sketch
Apartments.com building→ place.*listing id, building name, full address, coordinates, phone
lowest rent→ place.ext.listinglowest rent, status for_rent, home type apartment
rents, specials, amenities→ place.ext.apartmentshighest rent, rent by bedroom count, specials, amenities

What this API is used for

The jobs this API is most often used for.

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

Rent comparison, specials and rental supply by area

Callers search an area's buildings to compare rents and specials, then read the buildings that matter. Rent by bedroom count, current specials and amenities for every building of an Apartments.com search, 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.

Rent comparison

Python, notebooks

search an area and compare the lowest rent per bedroom count across buildings.

Specials tracking

Node, scheduled jobs

search the same link on a schedule to see which buildings start or end an offer.

Building records

Python, warehouse loads

property to store each building's description, amenities, photos and rating.

How to call the Apartments.com API

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

curl "https://www.socialcrawl.dev/v1/apartments/search?url=https%3A%2F%2Fwww.apartments.com%2Faustin-tx%2F" \n  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/apartments/property?url=https%3A%2F%2Fwww.apartments.com%2Floyola-junction-i-austin-tx%2F940ms65%2F" \n  -H "x-api-key: sc_your_api_key_here"
Apartments.com logoApartments.com on SocialCrawl

Same key as the rest of the catalog

Endpoints

What data does the Apartments.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 Apartments.com API cover?
It covers 2 endpoints: Search and Property. They search an area's rental buildings and read one building in full, in the same unified JSON as the other 94 platforms.
Can I get rent by bedroom count from Apartments.com?
Yes. place.ext.apartments.rent_by_bedroom lists the lowest rent for each bedroom count (0 is a studio), with the label as Apartments.com shows it, for example $1,243+.
Does the Apartments.com API return specials?
Yes. place.ext.apartments.specials carries the building's current offer as listed, for example 2 Months Free, and is null when there is none.
Why are beds and baths null on an Apartments.com listing?
A building has many floor plans, so place.ext.listing carries the lowest rent and the rents per bedroom count sit in place.ext.apartments.
How much does the Apartments.com API cost?
Both Apartments.com routes cost 1 credit a call and cache hits are free. A new account gets 100 free credits with no card.
Is scraping Apartments.com data legal?
SocialCrawl returns publicly available Apartments.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 Apartments.com's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Apartments.com scraping API vs the official Apartments.com API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Apartments.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 Apartments.com API reference in the docs

🤖 AI agent or LLM? Read this page as markdown