Realitica Advertiser API lists the property ads of one advertiser, an agency or an owner, with 25 listings per page. Realitica has no profile page, so the advertiser name is taken from the listing cards and total_listings is the advertiser total. Get the advertiser_id from the listing route.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
1 optional filter available.
integer
Required
The advertiser.advertiser_id of a listing. Example: 127210.
1234567890
integer
Optional
One-based page number, 25 results per page. Example: 1.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"listings": [
{
"url": "https://www.realitica.com/en/listing/3456582",
"price": {
"amount": 240000,
"currency": "EUR"
},
"title": "is selling an apartment",
"area_m2": 65,
"snippet": "Apartment of 65 sq. m, located on the raised ground floor of a four-storey building at Lazi Street, bb, Budva. The apartment has a functional layout and consists of: a spacio...",
"bedrooms": 1,
"location": {
"text": "Lazi, Budva, Montenegro",
"place": "Lazi",
"region": null,
"country": "Montenegro",
"municipality": "Budva"
},
"thumbnail": "https://www.realitica.com/images/listing_photos/thumb_3456582_dsc_5273.jpg",
"listing_id": 3456582,
"listing_type": "sale",
"property_type": "Apartment",
"advertiser_name": "Monteflower"
}
],
"advertiser": {
"name": "Monteflower",
"advertiser_id": 127210,
"total_listings": 1
},
"search_metadata": {
"page": 1,
"page_size": 25,
"total_pages": 1,
"filtered_out": 0,
"has_next_page": false,
"total_results": 1,
"upstream_items": 25,
"dropped_invalid": 0
},
"search_parameters": {
"page": 1,
"user_id": 127210
}
},
"meta": {
"billable": true,
"endpoint_family": "advertiser"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a value is invalid. This response is not billable.
{
"errors": {
"field": [
"The field is invalid."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Realitica could not be reached. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "advertiser"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Realitica could not be reached. Please retry shortly."
},
"success": false
}Unexpected Upstream Data
Realitica returned data in an unexpected shape. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "advertiser"
},
"error": {
"code": "INVALID_UPSTREAM_SHAPE",
"message": "Realitica returned data in an unexpected shape. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.