Trulia Search API
Overview
Trulia search API to gather detailed property information, including the address, price, and over 10 additional data points from the Trulia property listing details page. This tool provides a comprehensive analysis of each property, helping users to efficiently evaluate and compare real estate options.
Authentication
Visit our Authentication Docs on learning how to get started on integrating this API in your application.
Endpoint
GET https://get.scrapehero.com/api/trulia/search/?x-api-key=<YOUR_API_KEY>&url=https://www.trulia.com/CA/San_Francisco/
Request Parameters
Parameter | Type | Required | Description |
---|---|---|---|
url | string | Yes | Listing page URL |
Response Format
The API returns data in JSON format. Here's an example of the response structure:
{
"input": "https://www.trulia.com/CA/San_Francisco/",
"total_homes": 1309,
"total_pages": "25",
"pagination_url": "https://www.trulia.com/CA/San_Francisco/2_p/",
"listing_data": [
{
"rank": 1,
"property_id": "15168380 ZPID",
"listing_id": "5029761883",
"address": "206 Yale St, San Francisco, CA 94134",
"price": "$1,098,888",
"status": "for sale",
"status_tags": [
"NEW - 26 MIN AGO"
],
"geo_coordinates": {
"latitude": 37.72647,
"longitude": -122.41755
},
"property_url": "https://www.trulia.com/home/206-yale-st-san-francisco-ca-94134-15168380",
"primary_image": "https://www.trulia.com/pictures/thumbs_4/zillowstatic/fp/94d06073325a20c6d2ef6533bf8cbe45-full.jpg",
"area": "1,338 sqft",
"land_area": null,
"bedrooms": "3",
"bathrooms": "3",
"property_type": "SINGLE FAMILY HOME",
"agent_details": {
"agent_name": "Samantha Huang"
},
"broker_details": {
"broker_name": "NEXTGEN Properties"
},
"listing_date": "2025-04-09",
"sold_date": null,
"listing_type": "RESALE",
"images": [
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/94d06073325a20c6d2ef6533bf8cbe45-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/a474ddf2ce17a57169166c2634cdba12-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/45bddb6d35977063662a46f45bb664e2-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/26c57f0379045ecd7335a84816fced1b-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/f210077fcf28c23514873f3b7ed175a5-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/5a34c8fd4ddb005cadd3d6fe6e29c791-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/0a097392d6b5026908832c3babe515ad-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/90a8c0f69c05b1b5e5e75b20b3ecddff-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/7f3493cb5214cb670fda1777c4de9996-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/93036bde60448d2c2d91cc06f40e3a50-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/40d650d396521eb0cda4b3ee0e453190-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/437471330984c522a841031034f5a30a-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/9fbc4d766e44342c9c42f35496d258ce-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/8eed43f240fc7d452f20ef59bcd05ddb-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/1295e33e710f3e11dc3bdb66d3f8a833-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/d0580e811d221de8785edd372f5dcc0e-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/dead51a6a25987a872ce9b83526506f0-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/43a4677ce12054a008b4fc37ac568c15-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/36748c8ce03b89f2918fbf2a365256b3-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/32750ebbdd4b77f527266dbc0ca7f905-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/fb12115c1cb179c182600081963e5981-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/5a0b6464de1f71db00eca4d428eddd98-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/f0a0a9a4c998d7ef41d612c2868df57c-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/bae7341074c4a53e18ec8a11bb585b08-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/d8b91859cab94c49960e87230d4140dc-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/999876135b6398819fa51008c313af4a-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/57d5a6fb5a5107e343d17bbb93945bba-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/b4dd1b79f2f6ba6b7c7cc50526f38c7d-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/9ed9028c754146bc0d920cf14953b019-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/4f2d6083ea7cfe51633a745703087843-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/8ca548d01d301ca116b74a768ea2bdae-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/5c4aaf7f0c0795045c84abbeebc776fe-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/e6424851e64e8f316c5f6c40afa6160e-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/6db4e58547485654085da09f10c462ff-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/b6e4b6a44cc77cdc3276ef6db528ce9e-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/469d7778617eeae032a279d383226039-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/ccf6220c93d8156cfe84ab69e60c0c5a-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/7e070044e27300e63b0990a44d8b6cef-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/96d2a387dde55be7b5cfc828181cee84-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/d39a22bdb7f733f31903e31d487d4b13-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/4874201987fc7a1c1f3c635a78e6a36f-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/50d98e398c6ba464e16a5922ef072d3b-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/0b0dfc1a202ecf61bed8fc9f5f3d6f17-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/15b18b2facf74db5f5f5ba12d962f226-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/b9faa4ca64fd2789c9df5ed757f7db8f-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/8021c22e93b356f55e0b029d08694a65-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/c387debca2209b494db3e8b04b810f7d-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/3619928ac81454f60e579728fd0c4e65-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/c75e22f7f53cae1b8f007a653ca7f4a7-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/e3ec7bcc20695fcfb0b3015fcb1334a4-full.jpg",
"https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/0f7e59a2038c26c8e54c7564f5219144-full.jpg"
]
}
]
}
Response Fields
Field | Type | Description |
---|---|---|
rank | integer | rank |
property_id | string | property_id |
listing_id | string | listing_id |
address | string | address |
price | string | price |
status | string | status |
status_tags | list | status_tags |
geo_coordinates | dict | geo_coordinates |
property_url | string | property_url |
primary_image | string | primary_image |
area | string | area |
land_area | string | land_area |
bedrooms | string | bedrooms |
bathrooms | string | bathrooms |
property_type | string | property_type |
agent_details | dict | agent_details |
broker_details | dict | broker_details |
listing_date | string | listing_date |
sold_date | string | sold_date |
listing_type | string | listing_type |
images | list | images |
Usage Example
Here's an example of how to use the API with Python:
- JavaScript
- Python
- Java
- Ruby
const http = require("https");
const options = {
"method": "GET",
"hostname": "get.scrapehero.com",
"port": null,
"path": "/api/trulia/search/?x-api-key=<YOUR_API_KEY>&url=https://www.trulia.com/CA/San_Francisco/",
"headers": {}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
import http.client
conn = http.client.HTTPSConnection("get.scrapehero.com")
conn.request("GET","/api/trulia/search/?x-api-key=<YOUR_API_KEY>&url=https://www.trulia.com/CA/San_Francisco/")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
HttpResponse<String> response = Unirest.get("https://get.scrapehero.com/api/trulia/search/?x-api-key=<YOUR_API_KEY>&url=https://www.trulia.com/CA/San_Francisco/")
.asString();
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://get.scrapehero.com/api/trulia/search/?x-api-key=<YOUR_API_KEY>&url=https://www.trulia.com/CA/San_Francisco/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
This API uses 10 data credit per API call. Learn more about data credits.
Rate Limits
Rate limits are based off the plan that you have subscribed to. To learn more about the plan specification vist our Plans page.
Response Codes
Check out the response codes here.
Best Practices
- Use appropriate error handling in your code.
- Implement exponential backoff for rate limiting.
- Cache results when possible to minimize API calls.
Support
If you encounter any issues or have questions, please contact our API support team at cloud-support@scrapehero.com or visit our API documentation at https://app.scrapehero.com/docs/api_intro.