# ImmobilienScout24 API

**Canonical:** https://apis.io/apis/immobilienscout24/immobilienscout24-api/  
**Provider:** ImmobilienScout24 — https://apis.io/providers/immobilienscout24/  
**Base URL:** https://rest.immobilienscout24.de  
**Documentation:** https://api.immobilienscout24.de/api-docs/tutorials/building-projects

ImmobilienScout24 API is one of 2 APIs that [ImmobilienScout24](https://apis.io/providers/immobilienscout24/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

ImmobilienScout24 API as documented publicly: 42 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (42)

| Method | Path | Summary |
|---|---|---|
| DELETE | `/offer/v1.0/publish` | This method deletes the attribution of a real estate to a publish channel by publish channel ID |
| GET | `/offer/v1.0/publish` | This method shows a list of the channels, where the named real estate object is published. |
| POST | `/offer/v1.0/publish` | Creates a new resource of the requested type specified by the following URL. This method publishes a real estate object in one or more publish channels. |
| DELETE | `/offer/v1.0/publish/list` | This methods deletes a list of publications. |
| POST | `/offer/v1.0/publish/list/` | This method publishes a list of real estate objects in one or more publish channels. |
| GET | `/offer/v1.0/publish/{id}` | This method shows a list of publish channels in which the real estate object is published, by publish channel id |
| DELETE | `/offer/v1.0/user/{username or me}/contact/{id or ext-externalId}` | This method deletes the contact and assigns the referenced real estates to the default contact or to another contact. |
| GET | `/offer/v1.0/user/{username}/contact` | This method hands out all contact addresses of an ImmobilienScout24 user as a list. |
| POST | `/offer/v1.0/user/{username}/contact` | This method creates a contact address for an ImmobilienScout24 user. |
| PUT | `/offer/v1.0/user/{username}/contact/{id or ext-externalId}` | Updates the immoscout24 user contact address. |
| GET | `/offer/v1.0/user/{username}/publishchannel` | The resource PublishChannel hands out the channels on which a user can publish a Realestate. |
| GET | `/offer/v1.0/user/{username}/realestate` | This method provides all real estate objects of a user as a list. |
| GET | `/offer/v1.0/user/{username}/realestate/(ext-){id}/attachment` | This method hands out all attachments of a real estate object as a list. |
| DELETE | `/offer/v1.0/user/{username}/realestate/{id}` | This method deletes a real estate object by scout object ID or externalId. |
| GET | `/offer/v1.0/user/{username}/realestate/{id}` | This method provide a real estate object by a specific Id. |
| PUT | `/offer/v1.0/user/{username}/realestate/{id}` | Updates the resource identified by the following URL. |
| DELETE | `/offer/v1.0/user/{username}/realestate/{id}/attachment/{id}` | This method hands out the attachment by attachment ID. |
| GET | `/offer/v1.0/user/{username}/realestate/{id}/attachment/{id}` | This method hands out the attachment by attachment ID |
| PUT | `/offer/v1.0/user/{username}/realestate/{id}/attachment/{id}` | Updates the resource identified by the following URL. This method changes the meta data of an attachment to a realestate Object. |
| POST | `/offer/v1.0/user/{username}/realestate/{realestateid}/attachment/` | This method creates an attachment to a realestate. |
| GET | `/offer/v1.0/user/{username}/realestateproject` | This method retrieves all projects of the requested user |
| POST | `/offer/v1.0/user/{username}/realestateproject/project-proposal` | This method creates a proposal for contract negotiations of a new project |
| POST | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}/realestateprojectentry` | This method adds a real estate to a project. |
| GET | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}/realestateprojectentry` | This method retrieves all real estates of a project |
| GET | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}` | This method hands out a building project according to the requested Id |
| PUT | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}` | Update the resource "realestateproject" by Id |
| GET | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}/attachment` | This method retrieves all attachments' data assigned to a real estate project |
| POST | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}/attachment` | This method assigns an attachment to a real estate project |
| PUT | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}/attachment` | This method updates an attachment of a real estate project |
| PUT | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}/attachment/order` | This method changes the order of file attachments assigned to a real estate project |
| POST | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}/attachment/upload-ticket` | This method creates an upload ticket for a file attachment |
| DELETE | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}/attachment/{attachmentid}` | This method removes an attachment from a real estate project |
| GET | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}/attachment/{attachmentid}` | This method retrieves an attachment's data previously assigned to a real estate project |
| DELETE | `/offer/v1.0/user/{username}/realestateproject/{realestateprojectid}/realestateprojectentry/{realestateid}` | This method deletes a real estate object from project |
| GET | `/restapi/api/offer/v1.0/user/{userId}/videouploadticket` | Request a ticket for video upload. |
| GET | `/restapi/api/offer/v1.0/user/me/realestateproject` | Get the project ID for the user. |
| GET | `/restapi/api/offer/v1.0/user/me/realestateproject/{realestateprojectId}/realestateprojectentry` | Get the objects belonging to a project. |
| POST | `/restapi/api/offer/v1.0/user/me/realestateproject/{realestateprojectId}/realestateprojectentry` | Add a real estate to a project. |
| POST | `/restapi/api/offer/v1.0/user/{userid}/realestate/{id}/attachment` | Post to rest api a new video attachment with a videoId of pre-uploaded screen9-video. |
| GET | `/restapi/api/offer/v1.0/user/{username}/realestate` | Request for a list of real estates of a customer. |
| GET | `/restapi/api/offer/v1.0/user/{username}/realestate/{id}` | Request for a specific real estate. |
| GET | `/restapi/api/search/v1.0/search/region` | Request for all objects in Germany or international objects by geocode. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/immobilienscout24/openapi/_ae-authored/immobilienscout24-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/immobilienscout24/json-schema/immobilienscout24-put-offer-v10-user-username-realestateproject-realestateprojectid-r-schema.json
- **JSONSchema** — https://artifacts.apis.io/immobilienscout24/json-schema/immobilienscout24-put-offer-v10-user-username-contact-id-or-ext-externalid-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/immobilienscout24/json-schema/immobilienscout24-get-offer-v10-user-username-contact-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/immobilienscout24/json-schema/immobilienscout24-post-offer-v10-user-username-contact-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/immobilienscout24/json-schema/immobilienscout24-post-offer-v10-user-username-realestateproject-realestateprojectid3-schema.json
- **JSONSchema** — https://artifacts.apis.io/immobilienscout24/json-schema/immobilienscout24-post-offer-v10-user-username-realestateproject-project-proposal-requ-schema.json

## Other ImmobilienScout24 APIs (1)

- [ImmoScout24 API](https://apis.io/apis/immobilienscout24/immoscout24-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/immobilienscout24/immobilienscout24-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/immobilienscout24/.