Agent Winds API Documentation

Authentication

Demo API Key (for AI agents):

Rate Limit: 15 requests per hour

Usage: Include in request header: X-API-Key: treas-demo-api-key

1. Search Properties

Headers:

X-API-Key: treas-demo-api-key

Query Parameters:

• site_id (required) - Your site identifier
• state - State code (e.g., "OK")
• city - City name
• min_price - Minimum price
• max_price - Maximum price
• beds - Number of bedrooms
• baths - Number of bathrooms
• property_type - Property type
• min_sqft - Minimum square footage
• max_sqft - Maximum square footage

Example:

curl -H "X-API-Key: treas-demo-api-key" \
  "https://tophamtechbe.com/api/treas/idx/v1/retrieve-property-summary?site_id=t.doan.la&state=OK&city=Oklahoma%20City&beds=3&max_price=400000"

Response:

{
  "properties": [
    {
      "listingKey": "12345",
      "address": "123 Main St",
      "city": "Oklahoma City",
      "state": "OK",
      "listPrice": 375000,
      "bedroomsTotal": 3,
      "bathroomsTotalInteger": 2,
      "livingArea": 1850,
      "propertyType": "Residential",
      "media": [...]
    }
  ]
}

2. Get Property Details

Headers:

X-API-Key: treas-demo-api-key

Query Parameters:

• site_id (required) - Your site identifier
• listing_key (required) - Property listing key

Example:

curl -H "X-API-Key: treas-demo-api-key" \
  "https://tophamtechbe.com/api/treas/idx/v1/retrieve-property-details?site_id=t.doan.la&listing_key=12345"

3. Get Property Media

Headers:

X-API-Key: treas-demo-api-key

Query Parameters:

• site_id (required) - Your site identifier
• listing_key (required) - Property listing key

Example:

curl -H "X-API-Key: treas-demo-api-key" \
  "https://tophamtechbe.com/api/treas/idx/v1/retrieve-property-media?site_id=t.doan.la&listing_key=12345"

4. Submit Chat Lead

Headers:

X-API-Key: treas-demo-api-key
Content-Type: application/json

Request Body:

{
  "site_id": "t.doan.la",
  "name": "John Doe",
  "email": "john@example.com",
  "phone": "555-1234",
  "message": "Interested in property at 123 Main St"
}

Example:

curl -X POST -H "X-API-Key: treas-demo-api-key" \
  -H "Content-Type: application/json" \
  -d '{"site_id":"t.doan.la","name":"John Doe","email":"john@example.com","message":"Interested"}' \
  "https://tophamtechbe.com/api/treas/chat/v1/chatleads"

Use Cases for AI Agents

• Search properties based on natural language queries
• Retrieve detailed property information and photos
• Help users find homes matching their criteria
• Submit lead information when users want to contact the agent

Rate Limits

Demo API Key: 15 requests per hour

Rate limit exceeded responses return HTTP 429 status code.

For higher limits, contact us at: support@agentwinds.com

Support

Questions or issues? Contact: support@agentwinds.com