Introduksjon

Telescopes eksterne API gir systemene dine lesetilgang til organisasjonens data i Telescope, og lar godkjente organisasjoner legge til eiendommer. Det er et vanlig JSON REST-API som autentiseres med en API-nøkkel, så det fungerer med Power BI, Excel, Python, dataløp og alt annet som kan sende en HTTP-forespørsel.

Hva du kan gjøre

Du vil	Les
Lage klimarisikorapporter i Power BI	Power BI
Kopiere eiendommer og resultater til et datavarehus eller din egen app	Synkroniser data
Sende eiendommer fra eiendomsregisteret ditt til Telescope	Opprett eiendommer
Stille spørsmål om eiendomsmassen din i Claude Desktop	Claude (MCP)
Slå opp et felt eller en tillatt verdi	Referanse

Miljøer

Miljø	Base-URL
Produksjon	https://api.telescope.eco
Staging	https://api-staging.telescope.eco

Alle endepunkter ligger under /external/. En API-nøkkel virker bare i miljøet den ble opprettet i. Bruk staging når Telescope har gitt deg en staging-konto å teste mot.

Endepunktene i korte trekk

Metode	Sti	Hva det gjør
GET	/external/portfolios/	Lister rotmappene dine
GET	/external/portfolios/{id}/	Én mappe med undermappene og eiendommene som ligger rett i den
GET	/external/properties/	Lister eiendommer med lagrede resultater, med filtre
GET	/external/properties/{id}/	Én eiendom med lagrede resultater
POST	/external/properties/	Oppretter en eiendom, eller oppdaterer den med samme referanse-ID

Den fullstendige maskinlesbare beskrivelsen er OpenAPI-skjemaet på /external/openapi.yaml. Du kan prøve alle endepunktene i nettleseren i API-utforskeren: klikk Authorize og lim inn API-nøkkelen din.

Din første forespørsel

1. Opprett en API-nøkkel i Telescope.
2. List eiendommene dine:

curl -H "X-API-Key: $TELESCOPE_API_KEY" https://api.telescope.eco/external/properties/

Du får tilbake den første siden med opptil 100 eiendommer:

{
  "next": "https://api.telescope.eco/external/properties/?cursor=cD0yMDI2LTEw...",
  "previous": null,
  "results": [
    {
      "id": "3f6c1a52-8a1e-4c3e-9a57-0b1f6f0c2d11",
      "internal_reference_id": "P-1001",
      "name": "Storgata 1",
      "value_estimate": 85000000,
      "portfolio_id": "b2a4c7e0-1d2f-4f39-8e2a-5c6d7e8f9a01",
      "address": "Storgata 1",
      "postal_code": "0155",
      "postal_area": "Oslo",
      "country": "Norway",
      "matrikkelnummer": "0301-208/101/0/0",
      "created_at": "2026-03-02T09:14:07.512345Z",
      "updated_at": "2026-09-30T12:01:44.104221Z",
      "hazards": [
        {
          "name": "surface_flooding",
          "exposure": "HIGH",
          "relevant": true,
          "sensitivity": null,
          "vulnerability": null,
          "updated_at": "2026-09-30T12:05:10.000000Z"
        }
      ],
      "biodiversity": [],
      "buildings": [],
      "energy_certificates": []
    }
  ]
}

Følg next til den er null for å hente resten. Synkroniser data forklarer paginering og hvordan du holder en kopi oppdatert, og Grunnbegreper forklarer hva objektene betyr.

Greit å vite

• Bare din organisasjon. En nøkkel ser bare organisasjonen til brukeren som opprettet den.
• Lagrede resultater. Lesing starter aldri nye analyser. Du får resultatene Telescope allerede har beregnet.
• Lese og opprette, ikke slette. Det finnes ingen endepunkter som bare oppdaterer eller sletter. Endre eller fjern data i Telescope-appen.
• Vær skånsom. Send forespørslene én om gangen i stedet for i store parallelle støt.