# Scrapier — Realtor.com API > Scrapier endpoints for Realtor.com: Realtor.com Agents by ZIP, Realtor.com Property Detail Scraper, Realtor.com Search Listings. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/realtor.md ## GET /realtor-agent-by-zipcode/ Realtor.com Agents by ZIP: Structured Realtor.com data: send `zipcodes`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.agents · Long-running (client timeout 210 s or more) Parameters: - zipcodes (required, string, example 90210): ZIP/postal code. Required on first call; ignored when `cursor` is supplied. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - sort_by (optional, string, one of: RELEVANT_AGENTS|RATINGS_REVIEWS|MOST_SALES|MOST_RECENT_ACTIVITY|TESTIMONIALS_RECOMMENDATIONS, default RELEVANT_AGENTS): RELEVANT_AGENTS | RATINGS_REVIEWS | MOST_SALES | MOST_RECENT_ACTIVITY | TESTIMONIALS_RECOMMENDATIONS. Locked into the cursor on first call. - max_retries (optional, integer, default 3): HTTP retry attempts for GraphQL calls (1–10). Locked into the cursor. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/realtor-agent-by-zipcode/?zipcodes=90210" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/realtor/realtor-agent-by-zipcode.md ## GET /realtor-property/ Realtor.com Property Detail Scraper: Structured Realtor.com data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.properties · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://www.realtor.com/realestateandhomes-search/Las-Vegas_NV): Realtor.com search or detail URL. Required on first call; ignored when `cursor` is supplied. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - mode (optional, string, one of: BUY|RENT|SELL, default BUY): Mode for search URLs: BUY | RENT | SELL (detail URLs unchanged). Locked into the cursor. - include_floorplans (optional, boolean, default true): Include floor plan images in photos. Locked into the cursor. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/realtor-property/?urls=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2FLas-Vegas_NV" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/realtor/realtor-property.md ## GET /realtor-search-listings/ Realtor.com Search Listings: Structured Realtor.com data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.listings · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://www.realtor.com/realestateandhomes-search/Austin_TX): Realtor.com search URL. Required on first call; ignored when `cursor` is supplied. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - deep_details (optional, boolean, default false): Reserved for future expansion to fetch deep detail pages. Locked into the cursor. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/realtor-search-listings/?urls=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2FAustin_TX" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/realtor/realtor-search-listings.md