PropHunt.ai APIs

Create New Ad (Listing/Requirement)

This api allows to to create listings/requirents on PropHunt.ai throught one simple request. All the status updates will be sent to you on the callback url provided by you.You can integrate this api with your CRM to manage inventory.End Points

POST

/create-new-ad

Request Header

Key	Value
externalauth	Your API Key

Request BodyMandatory Parameters

Key	Type	Value
adType	string	Type of ad : ["lookingtobuy", "lookingtorent", "listforsale", "listforrent"]
description	string	A brief description of the property or requirement.
callbackUrl	string	The URL to receive ad updates.
externalRefId	string	A unique reference ID for tracking the ad.

Optional Parameters

Key	Type	Value
imageUrls	array	List of image URLs for the property.
bedrooms	integer	Number of bedrooms.
carpetArea	integer	Total carpet area in square feet.
bathrooms	integer	Number of bathrooms.
Any Other Extra Detail	string	Any additional information.

Sample Request

{
  "mandatory": {
    "adType": "listforsale",
    "description": "Luxury 3BHK apartment in downtown with premium amenities.",
    "callbackUrl": "https://yourapp.com/api/listing-update",
    "externalRefId": "ABC123XYZ"
  },
  "optional": {
    "imageUrls": [
      "https://yourcdn.com/images/property1.jpg",
      "https://yourcdn.com/images/property2.jpg"
    ],
    "bedrooms": 3,
    "carpetArea": 1500,
    "bathrooms": 2,
    "facingDirection": "East",
    "nearbyLandmarks": "Metro Station",
    "customTag": "Luxury"
  }
}

Sample Response

{
  "status": "success"
}

Status UpdatesThe callback will be sent on the following status updates:

Draft

Active

Duplicate

Expired