Passer au contenu principal
GET
/
classifieds
/
lookup
Find a classified by URL
curl --request GET \
  --url https://api.immoteur.com/public/v1/classifieds/lookup \
  --header 'Authorization: Bearer <token>'
{
  "classified": {
    "currency": "euro",
    "id": "7f6e3b4d-9c22-46a0-8f20-0d1a2b3c4d5e",
    "propertyId": "1cc6f941-3024-48ad-9ad2-3a56d5d5e9f6",
    "squareUnit": "squareMeter",
    "status": {
      "current": "available"
    },
    "meta": {
      "firstSeenAt": "2024-05-10T08:00:00Z",
      "lastModifiedAt": "2024-05-18T09:45:00Z",
      "lastSeenAt": "2024-05-20T12:30:00Z"
    },
    "source": {
      "domain": "seloger.com",
      "url": "https://www.seloger.com/annonces/achat/appartement/paris-1er-75/5-pieces/0.htm"
    },
    "property": {
      "type": "apartment"
    },
    "publisher": {
      "isProfessional": true,
      "siren": "123456789",
      "siret": "12345678900011"
    },
    "location": {
      "city": {
        "inseeCode": "75056",
        "name": "Paris"
      },
      "country": "france",
      "department": "75",
      "postcode": "75001"
    },
    "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"
    }
  },
  "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 to resolve. Accepts incomplete URLs without a scheme; fragment identifiers and tracking parameters are ignored during lookup.

Required string length: 3 - 2048

Response

Classified matching the requested URL.

​
classified
object
required
​
meta
object
required