{
  "openapi": "3.0.1",
  "info": {
    "title": "Trulia Scraper - Property Listings, Prices, Agents & History",
    "description": "Scrape Trulia.com property listings by location, filters, or URL. Extract prices, beds, baths, square footage, addresses, GPS coordinates, photos, agents, and brokers, plus detailed price and tax history, property features, and open house information.",
    "version": "1.0",
    "x-build-id": "fBvtgnT0p2bvA5QEz"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~trulia-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-trulia-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/abotapi~trulia-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-trulia-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/abotapi~trulia-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-trulia-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Start mode",
            "enum": [
              "search",
              "url"
            ],
            "type": "string",
            "description": "How to start. 'Search by location' builds Trulia search URLs from the filters below. 'Direct URLs' takes Trulia search or property URLs you already have.",
            "default": "search"
          },
          "searchLocation": {
            "title": "Location",
            "type": "string",
            "description": "Search mode only. A US location such as 'Austin, TX', 'Austin TX', Austin,TX or New_York,NY. Spaces are converted automatically; a location that matches nothing fails loudly.",
            "default": "New_York,NY"
          },
          "searchListingType": {
            "title": "Listing type",
            "enum": [
              "FOR_SALE",
              "FOR_RENT",
              "SOLD"
            ],
            "type": "string",
            "description": "Search mode only. For sale, for rent, or recently sold listings.",
            "default": "FOR_SALE"
          },
          "searchKeyword": {
            "title": "Keyword (optional)",
            "type": "string",
            "description": "Search mode only. Narrows results to listings whose text mentions this keyword (e.g. pool, waterfront, garage). Leave empty for no keyword filter."
          },
          "searchSort": {
            "title": "Sort by",
            "enum": [
              "RECOMMENDED",
              "NEWEST",
              "PRICE_LOW_TO_HIGH",
              "PRICE_HIGH_TO_LOW"
            ],
            "type": "string",
            "description": "Search mode only. Result ordering. Newest is currently served in the recommended order because the site no longer offers a newest-first order; use incremental mode to catch new listings. Trulia may place a few promoted listings ahead of the chosen order.",
            "default": "RECOMMENDED"
          },
          "minBeds": {
            "title": "🛏️ Minimum bedrooms (optional)",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Search mode only. Keep listings with at least this many bedrooms (1-5). Leave empty for any."
          },
          "minBaths": {
            "title": "🛁 Minimum bathrooms (optional)",
            "minimum": 1,
            "maximum": 4,
            "type": "integer",
            "description": "Search mode only. Keep listings with at least this many bathrooms (1-4). Trulia applies this filter on its side and counts half-baths, so a listing with one and a half baths can appear under 2 or more. Works with or without Minimum bedrooms. Leave empty for any."
          },
          "propertyType": {
            "title": "🏠 Property type (optional)",
            "enum": [
              "SINGLE_FAMILY",
              "CONDO",
              "TOWNHOUSE",
              "MULTI_FAMILY",
              "LAND",
              "MOBILE_MANUFACTURED"
            ],
            "type": "string",
            "description": "Search mode only. Restrict to one property type. Leave empty for all."
          },
          "searchZip": {
            "title": "📮 ZIP code (optional)",
            "type": "string",
            "description": "Search mode only. 5-digit US ZIP code. When set it replaces the location field."
          },
          "startUrls": {
            "title": "Trulia URLs",
            "type": "array",
            "description": "URL mode only. Trulia search URLs (for sale, for rent, sold, state/city, neighborhood, ZIP, filtered, sorted, paginated, m.trulia.com) or property pages (/home/, /p/, /building/). Paginated automatically; property URLs return one record each. Left untouched, URL mode scrapes these 17 example URLs.",
            "default": [
              "https://www.trulia.com/for_sale/Austin,TX/",
              "https://www.trulia.com/for_rent/Austin,TX/",
              "https://www.trulia.com/sold/Austin,TX/",
              "https://www.trulia.com/for_rent/Austin,TX/2_p/",
              "https://www.trulia.com/for_sale/Austin,TX/pool_keyword/",
              "https://www.trulia.com/for_sale/Austin,TX/price;a_sort/",
              "https://www.trulia.com/for_sale/Austin,TX/?sort=price_desc",
              "https://www.trulia.com/for_sale/Austin,TX/2p_beds/",
              "https://www.trulia.com/for_sale/Austin,TX/SINGLE-FAMILY_HOME_type/",
              "https://www.trulia.com/TX/Austin/",
              "https://www.trulia.com/TX/Austin,Downtown/",
              "https://www.trulia.com/TX/Austin/78701/",
              "https://www.trulia.com/for_sale/78701_zip/",
              "https://m.trulia.com/for_sale/Austin,TX/",
              "https://www.trulia.com/home/11221-gadsen-ln-105-austin-tx-78754-338244892",
              "https://www.trulia.com/p/tx/austin/11221-gadsen-ln-105-austin-tx-78754--338244892",
              "https://www.trulia.com/building/33hundred-3300-wells-branch-pkwy-austin-tx-78728-1146835547"
            ],
            "items": {
              "type": "string"
            }
          },
          "fetchDetails": {
            "title": "Fetch property details",
            "type": "boolean",
            "description": "Include full property details: price history, tax history, full feature list, open houses, listing agent and broker contact, affordability and more. Slower and uses more proxy traffic; billed per enriched listing. Leave off for fast search-result data, which already includes price, beds, baths, address, GPS, photos and agent name.",
            "default": false
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of listings to scrape across all searches/URLs. This is the run cap. Set 0 for unlimited.",
            "default": 20
          },
          "maxPages": {
            "title": "Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Optional safety cap on search pages to walk per location/URL (40 listings per page). Leave empty to walk every result page; the run stops at Max items."
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Datacenter exits (the default) read search results and home pages. Building pages need a residential exit; the actor switches to Apify Residential for those and can fall back to a backup connection if the selected one is unavailable. You can pick Apify Residential (US) yourself, or supply your own proxy URLs. Free Apify plans do not include Apify proxy.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyCountry": "US"
            }
          },
          "resumeFromRunId": {
            "title": "Resume from a previous run",
            "type": "string",
            "description": "Paste a previous run ID (or dataset ID) from this actor to continue a large crawl without returning or charging for listings already collected there. Use this after an interrupted run. For recurring daily monitoring of the same search, use Incremental mode below instead."
          },
          "incrementalMode": {
            "title": "Incremental changes for scheduled runs",
            "type": "boolean",
            "description": "Turn this on for daily or recurring monitoring. The first run returns all matching listings as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED listings. UPDATED means any field of the stored listing record changed (price, status, description, photos, agent, tags and so on); the only things never compared are the relative \"last checked ... ago\" text and the MLS refresh stamp inside the listing source, plus any field you list in Ignore fields. Use What counts as a change to compare price and status only. Turn on \"Emit unchanged\" or \"Emit expired\" only when you also want those listings returned (and billed). State is kept separately per location/URL, listing type, keyword, sort, and fetchDetails setup; use State key when you want to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.",
            "default": false
          },
          "stateKey": {
            "title": "State key (optional, incremental mode only)",
            "type": "string",
            "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the location/URLs, listing type, keyword, sort, and fetchDetails settings -- different searches then never mix state with each other."
          },
          "emitUnchanged": {
            "title": "Emit unchanged listings (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return listings that have not changed since the last run, marked UNCHANGED. This returns -- and bills -- extra rows you already have, so leave it off unless you specifically want the full snapshot every run.",
            "default": false
          },
          "emitExpired": {
            "title": "Emit expired listings (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return listings that were present in a previous run but are no longer found, marked EXPIRED, once a run has fully scanned the search (not capped, not a resume). Adds and bills extra synthetic rows, so leave it off unless you need expiry tracking.",
            "default": false
          },
          "changeScope": {
            "title": "What counts as a change (incremental mode only)",
            "enum": [
              "all",
              "priceAndStock"
            ],
            "type": "string",
            "description": "All fields (default): any change to the listing record, except the always-ignored relative-time text inside the listing source (\"last checked ... ago\") and the MLS refresh stamp, returns an UPDATED row. Price and status only: only a change to price, formatted price, price type, currency, listing type, current status (active, pending, sold, off market) or the price-change block returns an UPDATED row; descriptions, photos, tags, agent details and other fields never do. Changing this option on a search with no State key continues from that search's saved baseline instead of starting over.",
            "default": "all"
          },
          "compactUpdates": {
            "title": "Compact update rows (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. When on, UPDATED rows (and EXPIRED rows) are short: listing id, url, location, current price and status, plus priceChanges (old and new value of each moved price or status field) and variantChanges (per-unit changes when a listing carries units). NEW rows always carry the complete record. The Fetch details enrichment charge does not apply to a compact row because it no longer carries the detail data.",
            "default": false
          },
          "expireAfterMissedScans": {
            "title": "Expire after N missed full scans (incremental mode only)",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Only used with Emit expired listings. A listing is marked EXPIRED only after it has been missing from this many complete scans in a row (default 1). Raise it (for example 3) so a listing that briefly drops out of the results is not reported as gone. A listing that comes back resets the count. EXPIRED means the listing was no longer found in the results; it does not prove the property was delisted, so check the status fields for availability.",
            "default": 1
          },
          "ignoreFieldsForChanges": {
            "title": "Ignore fields when detecting changes (incremental mode only)",
            "type": "array",
            "description": "Optional. Field names to exclude from UPDATED change detection and from changedFields, in addition to the built-in handling (the relative \"last checked\" text and MLS refresh stamp already never trigger an UPDATED). Use this if a field in your setup turns out to be noisy. Nested fields use dotted names, for example provider.logoUrl or homeDetails.activeListing.provider. The fields stay in the output rows; they just do not decide UPDATED.",
            "items": {
              "type": "string"
            }
          },
          "mcpConnectors": {
            "title": "Pipe results into your apps (optional)",
            "type": "array",
            "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (address + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)."
          },
          "notionParentPageUrl": {
            "title": "Notion parent page (Notion connector only)",
            "type": "string",
            "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors."
          },
          "maxNotifyListings": {
            "title": "Max items to export per connector",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on items written to each connector per run. Does not affect the dataset.",
            "default": 50
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}