Passer au contenu principal
GET
/
properties
/
lookup
Find a property by URL
curl --request GET \
  --url https://api.immoteur.com/public/v1/properties/lookup \
  --header 'Authorization: Bearer <token>'
{
  "property": {
    "id": "8c7f53d2-b9a4-4c11-9d7c-8b2cbda1698a",
    "description": "Appartement traversant avec balcon filant.",
    "location": {
      "city": {
        "inseeCode": "75056",
        "name": "Paris"
      },
      "country": "france",
      "department": "75",
      "postcode": "75001",
      "latitude": 48.859,
      "longitude": 2.347
    },
    "status": {
      "current": "available"
    },
    "transaction": {
      "price": {
        "current": 650000,
        "initial": 690000,
        "history": [
          {
            "timestamp": "2024-05-10T11:15:00Z",
            "value": 690000
          },
          {
            "timestamp": "2024-05-18T09:45:00Z",
            "value": 650000
          }
        ]
      },
      "type": "sale"
    },
    "classifieds": [
      {
        "id": "3bf6c821-a572-4ef7-9c54-070f949a961d",
        "source": {
          "domain": "seloger.com",
          "url": "https://www.seloger.com/annonces/achat/appartement/paris-1er-75/5-pieces/0.htm"
        },
        "status": {
          "current": "available"
        },
        "transaction": {
          "current": 650000,
          "initial": 690000,
          "history": [
            {
              "timestamp": "2024-05-10T11:15:00Z",
              "value": 690000
            },
            {
              "timestamp": "2024-05-18T09:45:00Z",
              "value": 650000
            }
          ]
        },
        "publisher": {
          "isProfessional": true,
          "siren": "123456789",
          "siret": "12345678900011"
        }
      }
    ],
    "meta": {
      "firstSeenAt": "2024-05-01T08:00:00Z",
      "lastSeenAt": "2024-05-20T09:00:00Z"
    },
    "property": {
      "type": "apartment"
    }
  },
  "meta": {
    "subscriptionPlan": "growth100",
    "dataAccessLimit": {
      "departments": [
        "75"
      ],
      "sirens": [
        "123456789"
      ],
      "sirets": [
        "12345678900011"
      ]
    }
  }
}

Authorizations

Authorization
string
header
required

Send your Immoteur Personal Access Token in the Authorization header: Authorization: Bearer <token>

You can create and manage your Personal Access Tokens here: https://immoteur.com/dashboard/settings status: current: available

Query Parameters

url
string
required

Classified URL pointing to any listing grouped under the targeted property. Accepts incomplete URLs without a scheme; fragment identifiers and tracking parameters are ignored during lookup.

Required string length: 3 - 2048

Response

Property matching the requested URL.

meta
object
required
property
object
required