SearchAds - Give search capabilities to retrieve real-estate ads. This is suitable for an end-user search experience.

curl --request POST \
  --url https://api.f6o.co/v2/ad/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "search": {
    "fullTexts": [
      "<string>"
    ],
    "keywords": [
      "<string>"
    ],
    "filterAd": {
      "firstSeenAt": [
        {
          "min": "2023-11-07T05:31:56Z",
          "max": "2023-11-07T05:31:56Z"
        }
      ],
      "firstPublishedAt": [
        {
          "min": "2023-11-07T05:31:56Z",
          "max": "2023-11-07T05:31:56Z"
        }
      ],
      "lastModifiedAt": [
        {
          "min": "2023-11-07T05:31:56Z",
          "max": "2023-11-07T05:31:56Z"
        }
      ],
      "offlineAt": [
        {
          "min": "2023-11-07T05:31:56Z",
          "max": "2023-11-07T05:31:56Z"
        }
      ],
      "tags": [
        "<string>"
      ],
      "isUrgent": true,
      "offer": [
        {
          "type": "OFFER_UNKNOWN",
          "renting": {
            "isSubLease": true,
            "isShortTerm": true,
            "isLongTerm": true,
            "isColocation": true
          },
          "isCurrentlyOccupied": true
        }
      ],
      "type": [
        "CLASS_UNKNOWN"
      ],
      "process": [
        "PROCESS_UNKNOWN"
      ],
      "currentPrice": {
        "value": {
          "min": 123,
          "max": 123
        },
        "valuePerArea": {
          "min": 123,
          "max": 123
        },
        "source": {
          "website": "<string>",
          "url": "<string>",
          "flxId": "<string>"
        }
      },
      "estimatedPrice": {
        "value": {
          "min": 123,
          "max": 123
        },
        "valuePerArea": {
          "min": 123,
          "max": 123
        },
        "source": {
          "website": "<string>",
          "url": "<string>",
          "flxId": "<string>"
        }
      },
      "warrantyDeposit": {
        "min": 123,
        "max": 123
      },
      "charges": {
        "yearlyRentalFees": 123,
        "yearlyCondoniumFees": 123,
        "yearlyHeatingFees": 123,
        "yearlyElectricityFees": 123,
        "yearlyHousingTax": 123,
        "yearlyLivingTax": 123,
        "monthlyRentSupplement": 123
      },
      "isAuction": true,
      "scope": [
        "PRICING_ONE_OFF"
      ],
      "currency": [
        "CURRENCY_EUR"
      ],
      "habitation": {
        "type": "PROPERTY_TYPE_UNKNOWN",
        "roomCount": {
          "min": 123,
          "max": 123
        },
        "bedroomCount": {
          "min": 123,
          "max": 123
        },
        "bathroomCount": {
          "min": 123,
          "max": 123
        },
        "wcCount": {
          "min": 123,
          "max": 123
        },
        "roomsDetails": [
          {
            "roomType": "ROOM_TYPE_UNKNOWN",
            "area": 123,
            "floor": 123,
            "contextInfo": [
              "<string>"
            ]
          }
        ],
        "heatTypes": [
          "HEAT_TYPE_UNKNOWN"
        ],
        "heatTypeDetails": [
          "HEAT_DETAIL_UNKNOWN"
        ],
        "heatings": [
          "HEATING_UNKNOWN"
        ],
        "kitchenEquipped": [
          "KITCHEN_UNKNOWN_EQUIPPED"
        ],
        "features": {
          "propertyTotalFloor": {
            "min": 123,
            "max": 123
          },
          "propertyFloor": {
            "min": 123,
            "max": 123
          },
          "viewTypes": [
            "VIEW_TYPE_UNKNOWN"
          ],
          "exposure": [
            "EXPOSURE_UNKNOWN"
          ],
          "furniture": [
            "UNKNOWN_FURNITURE"
          ],
          "constructionMaterials": [
            "MATERIAL_UNKNOWN"
          ],
          "viewOns": [
            "VIEW_ON_UNKNOWN"
          ],
          "glazingTypes": [
            "GLAZING_TYPE_UNKNOWN"
          ],
          "hasThroughExposure": true
        },
        "characteristics": {
          "hasLift": true,
          "hasCellar": true,
          "hasBalcony": true,
          "hasTerrace": true,
          "hasGarden": true,
          "hasFireplace": true,
          "hasGrenier": true,
          "hasPool": true,
          "hasParking": true,
          "hasGarage": true,
          "hasLand": true,
          "hasConcierge": true,
          "hasDigicode": true,
          "hasInterphone": true,
          "hasAlarm": true,
          "hasVisAVis": true,
          "isPeaceful": true,
          "hasMezzanine": true,
          "hasJacuzzi": true
        },
        "climate": {
          "epcEnergy": [
            "ENERGY_CLASSIFICATION_UNKNOWN"
          ],
          "epcClimate": [
            "GREENHOUSE_CLASSIFICATION_UNKNOWN"
          ],
          "epcEnergyScore": {
            "min": 123,
            "max": 123
          },
          "epcClimateScore": {
            "min": 123,
            "max": 123
          },
          "epcClimateDate": {
            "min": "2023-11-07T05:31:56Z",
            "max": "2023-11-07T05:31:56Z"
          },
          "epcEnergyDate": {
            "min": "2023-11-07T05:31:56Z",
            "max": "2023-11-07T05:31:56Z"
          }
        },
        "propertyCondition": [
          {
            "interiorCondition": "INTERIOR_CONDITION_UNKNOWN",
            "constructionYear": 123,
            "generalConditions": [
              "GENERAL_CONDITION_UNKNOWN"
            ],
            "renovationYear": 123
          }
        ],
        "surface": {
          "total": {
            "min": 123,
            "max": 123
          },
          "livingSpace": {
            "min": 123,
            "max": 123
          },
          "floorSpace": {
            "min": 123,
            "max": 123
          },
          "livingroom": {
            "min": 123,
            "max": 123
          },
          "kitchen": {
            "min": 123,
            "max": 123
          },
          "groundFloor": {
            "min": 123,
            "max": 123
          },
          "balconies": {
            "min": 123,
            "max": 123
          },
          "terraces": {
            "min": 123,
            "max": 123
          },
          "gardens": {
            "min": 123,
            "max": 123
          }
        }
      },
      "parking": {
        "type": [
          "PARKING_UNKNOWN"
        ],
        "count": {
          "min": 123,
          "max": 123
        },
        "numberOfCars": {
          "min": 123,
          "max": 123
        },
        "surface": {
          "min": 123,
          "max": 123
        }
      },
      "land": {
        "type": [
          "LAND_UNKNOWN"
        ],
        "haveBuildingPermit": true,
        "canConstruct": true,
        "surfaceConstructable": {
          "min": 123,
          "max": 123
        },
        "surface": {
          "min": 123,
          "max": 123
        },
        "isServiced": true,
        "haveWater": true,
        "haveElectricity": true,
        "haveTelecom": true
      },
      "source": {
        "website": "<string>",
        "url": "<string>",
        "flxId": "<string>"
      },
      "location": {
        "address": {
          "number": "<string>",
          "streetName": "<string>"
        },
        "postalCode": "<string>",
        "inseeCode": "<string>",
        "irisCode": "<string>",
        "department": "<string>",
        "city": "<string>",
        "locationCoordinate": {
          "location": {
            "preregisteredShape": {
              "index": "UNKNOWN_GEO_INDEX",
              "id": "<string>"
            },
            "geoDistance": {
              "distanceKm": 123,
              "pin": {
                "lat": 123,
                "lon": 123
              }
            },
            "geoBoundingBox": {
              "topLeft": {
                "lat": 123,
                "lon": 123
              },
              "bottomRight": {
                "lat": 123,
                "lon": 123
              }
            },
            "geoShape": {
              "relation": "UNKNOWN_SPATIAL_RELATION",
              "type": "UNKNOWN_GEO_SHAPE_TYPE",
              "coordinates": [
                {
                  "lat": 123,
                  "lon": 123
                }
              ]
            },
            "geoInseeCodeDistance": {
              "distanceKm": 123,
              "inseeCode": "<string>"
            }
          },
          "h3Indices": {
            "h3Index1": "<string>",
            "h3Index2": "<string>",
            "h3Index3": "<string>",
            "h3Index4": "<string>",
            "h3Index5": "<string>",
            "h3Index6": "<string>",
            "h3Index7": "<string>",
            "h3Index8": "<string>",
            "h3Index9": "<string>",
            "h3Index10": "<string>",
            "h3Index11": "<string>",
            "h3Index12": "<string>"
          }
        },
        "cityCoordinate": {
          "location": {
            "preregisteredShape": {
              "index": "UNKNOWN_GEO_INDEX",
              "id": "<string>"
            },
            "geoDistance": {
              "distanceKm": 123,
              "pin": {
                "lat": 123,
                "lon": 123
              }
            },
            "geoBoundingBox": {
              "topLeft": {
                "lat": 123,
                "lon": 123
              },
              "bottomRight": {
                "lat": 123,
                "lon": 123
              }
            },
            "geoShape": {
              "relation": "UNKNOWN_SPATIAL_RELATION",
              "type": "UNKNOWN_GEO_SHAPE_TYPE",
              "coordinates": [
                {
                  "lat": 123,
                  "lon": 123
                }
              ]
            },
            "geoInseeCodeDistance": {
              "distanceKm": 123,
              "inseeCode": "<string>"
            }
          },
          "h3Indices": {
            "h3Index1": "<string>",
            "h3Index2": "<string>",
            "h3Index3": "<string>",
            "h3Index4": "<string>",
            "h3Index5": "<string>",
            "h3Index6": "<string>",
            "h3Index7": "<string>",
            "h3Index8": "<string>",
            "h3Index9": "<string>",
            "h3Index10": "<string>",
            "h3Index11": "<string>",
            "h3Index12": "<string>"
          }
        }
      },
      "hasAnomaly": true,
      "anomalies": [
        "<string>"
      ],
      "isPro": true,
      "seller": [
        {
          "type": "SELLER_TYPE_UNKNOWN",
          "flxId": "<string>",
          "name": "<string>",
          "siren": "<string>"
        }
      ],
      "contactInCharge": {
        "firstName": "<string>",
        "lastName": "<string>",
        "phoneNumber": "<string>",
        "email": "<string>",
        "pseudonym": "<string>"
      },
      "isKnownProperty": true,
      "mainPropertyAdFlxId": [
        "<string>"
      ],
      "propertyFlxId": [
        "<string>"
      ],
      "isOnline": true,
      "isExclusive": true
    }
  },
  "searchAfter": [
    "<string>"
  ],
  "sortBy": "RELEVANCE",
  "orderBy": "ASC",
  "size": 123,
  "excludedFields": [
    "<string>"
  ],
  "includedFields": [
    "<string>"
  ]
}'

{
  "apiVersion": "<string>",
  "context": "<string>",
  "data": {
    "results": {
      "kind": "<string>",
      "id": "<string>",
      "lang": "<string>",
      "updated": "<string>",
      "deleted": "<string>",
      "items": [
        {
          "legacyId": "<string>",
          "flxId": "<string>",
          "firstSeenAt": "2023-11-07T05:31:56Z",
          "firstPublishedAt": "2023-11-07T05:31:56Z",
          "lastModifiedAt": "2023-11-07T05:31:56Z",
          "lastSeenAt": "2023-11-07T05:31:56Z",
          "offlineAt": "2023-11-07T05:31:56Z",
          "title": "<string>",
          "description": "<string>",
          "tags": [
            "<string>"
          ],
          "medias": {
            "virtualVisitExternalUrl": [
              "<string>"
            ],
            "images": [
              {
                "imageId": "<string>",
                "url": "<string>",
                "s3Path": "<string>",
                "gaussianHash": "<string>",
                "perceptualHash": "<string>",
                "meanHash": "<string>",
                "tags": [
                  "<string>"
                ],
                "caption": "<string>",
                "room": "ROOM_UNKNOWN"
              }
            ]
          },
          "isUrgent": true,
          "offer": {
            "type": "OFFER_UNKNOWN",
            "renting": {
              "isSubLease": true,
              "isShortTerm": true,
              "isLongTerm": true,
              "isColocation": true
            },
            "isCurrentlyOccupied": true
          },
          "type": "CLASS_UNKNOWN",
          "process": "PROCESS_UNKNOWN",
          "currentPrice": {
            "value": 123,
            "valuePerArea": 123,
            "source": {
              "website": "<string>",
              "url": "<string>",
              "flxId": "<string>"
            }
          },
          "estimatedPrice": {
            "value": 123,
            "valuePerArea": 123,
            "source": {
              "website": "<string>",
              "url": "<string>",
              "flxId": "<string>"
            }
          },
          "warrantyDeposit": 123,
          "charges": {
            "yearlyRentalFees": 123,
            "yearlyCondoniumFees": 123,
            "yearlyHeatingFees": 123,
            "yearlyElectricityFees": 123,
            "yearlyHousingTax": 123,
            "yearlyLivingTax": 123,
            "monthlyRentSupplement": 123
          },
          "isAuction": true,
          "scope": "PRICING_ONE_OFF",
          "currency": "CURRENCY_EUR",
          "habitation": {
            "type": [
              "PROPERTY_TYPE_UNKNOWN"
            ],
            "roomCount": 123,
            "bedroomCount": 123,
            "bathroomCount": 123,
            "wcCount": 123,
            "roomsDetails": [
              {
                "roomType": "ROOM_TYPE_UNKNOWN",
                "area": 123,
                "floor": 123,
                "contextInfo": [
                  "<string>"
                ]
              }
            ],
            "heatTypes": [
              "HEAT_TYPE_UNKNOWN"
            ],
            "heatTypeDetails": [
              "HEAT_DETAIL_UNKNOWN"
            ],
            "heatings": [
              "HEATING_UNKNOWN"
            ],
            "kitchenEquipped": "KITCHEN_UNKNOWN_EQUIPPED",
            "features": {
              "propertyTotalFloor": 123,
              "propertyFloor": 123,
              "viewTypes": [
                "VIEW_TYPE_UNKNOWN"
              ],
              "exposure": "EXPOSURE_UNKNOWN",
              "furniture": "UNKNOWN_FURNITURE",
              "constructionMaterials": [
                "MATERIAL_UNKNOWN"
              ],
              "viewOns": [
                "VIEW_ON_UNKNOWN"
              ],
              "glazingTypes": [
                "GLAZING_TYPE_UNKNOWN"
              ],
              "hasThroughExposure": true
            },
            "characteristics": {
              "hasLift": true,
              "hasCellar": true,
              "hasBalcony": true,
              "hasTerrace": true,
              "hasGarden": true,
              "hasFireplace": true,
              "hasGrenier": true,
              "hasPool": true,
              "hasParking": true,
              "hasGarage": true,
              "hasLand": true,
              "hasConcierge": true,
              "hasDigicode": true,
              "hasInterphone": true,
              "hasAlarm": true,
              "hasVisAVis": true,
              "isPeaceful": true,
              "hasMezzanine": true,
              "hasJacuzzi": true
            },
            "climate": {
              "epcEnergy": "ENERGY_CLASSIFICATION_UNKNOWN",
              "epcClimate": "GREENHOUSE_CLASSIFICATION_UNKNOWN",
              "epcEnergyScore": 123,
              "epcClimateScore": 123,
              "epcClimateDate": "2023-11-07T05:31:56Z",
              "epcEnergyDate": "2023-11-07T05:31:56Z"
            },
            "propertyCondition": {
              "interiorCondition": "INTERIOR_CONDITION_UNKNOWN",
              "constructionYear": 123,
              "generalConditions": [
                "GENERAL_CONDITION_UNKNOWN"
              ],
              "renovationYear": 123
            },
            "surface": {
              "total": 123,
              "livingSpace": 123,
              "floorSpace": 123,
              "livingRoom": 123,
              "kitchen": 123,
              "groundFloor": 123,
              "balconies": 123,
              "terraces": 123,
              "gardens": 123
            }
          },
          "parking": {
            "type": "PARKING_UNKNOWN",
            "count": 123,
            "numberOfCars": 123,
            "surface": 123
          },
          "land": {
            "type": "LAND_UNKNOWN",
            "hasBuildingPermit": true,
            "canConstruct": true,
            "surfaceConstructable": 123,
            "surface": 123,
            "isServiced": true,
            "hasWater": true,
            "hasElectricity": true,
            "hasTelecom": true
          },
          "source": {
            "website": "<string>",
            "url": "<string>",
            "flxId": "<string>"
          },
          "location": {
            "address": {
              "number": "<string>",
              "streetName": "<string>"
            },
            "postalCode": "<string>",
            "inseeCode": "<string>",
            "irisCode": "<string>",
            "department": "<string>",
            "city": "<string>",
            "locationCoordinate": {
              "location": [
                123
              ],
              "h3Indices": {
                "h3Index1": "<string>",
                "h3Index2": "<string>",
                "h3Index3": "<string>",
                "h3Index4": "<string>",
                "h3Index5": "<string>",
                "h3Index6": "<string>",
                "h3Index7": "<string>",
                "h3Index8": "<string>",
                "h3Index9": "<string>",
                "h3Index10": "<string>",
                "h3Index11": "<string>",
                "h3Index12": "<string>"
              }
            },
            "cityCoordinate": {
              "location": [
                123
              ],
              "h3Indices": {
                "h3Index1": "<string>",
                "h3Index2": "<string>",
                "h3Index3": "<string>",
                "h3Index4": "<string>",
                "h3Index5": "<string>",
                "h3Index6": "<string>",
                "h3Index7": "<string>",
                "h3Index8": "<string>",
                "h3Index9": "<string>",
                "h3Index10": "<string>",
                "h3Index11": "<string>",
                "h3Index12": "<string>"
              }
            }
          },
          "isCityCenter": true,
          "hasAnomaly": true,
          "anomalies": [
            "UNKNOWN_ANOMALY"
          ],
          "isPro": true,
          "seller": {
            "type": "SELLER_TYPE_UNKNOWN",
            "flxId": "<string>",
            "name": "<string>",
            "siren": "<string>"
          },
          "contactInCharge": {
            "firstName": "<string>",
            "lastName": "<string>",
            "phoneNumber": "<string>",
            "email": "<string>",
            "pseudonym": "<string>"
          },
          "isKnownProperty": true,
          "mainPropertyAdFlxId": "<string>",
          "propertyFlxId": "<string>",
          "isOnline": true,
          "websiteRefs": [
            "<string>"
          ],
          "isExclusive": true
        }
      ]
    },
    "searchAfter": [
      "<string>"
    ]
  },
  "internalDelay": 123,
  "count": 123
}