Looker

Developers

Looker

Developers

    Starting June 2022, API 3.x is deprecated. Read our deprecation notice to see how this affects you.

    Looker API 3.x Deprecation Notice

    Following our API 4.0 GA release in Looker 22.4, we announced the deprecation of our 3.1 API, in addition to our already deprecated 3.0 API.

    As of our deprecation announcement in June 2022, both the 3.1 API and the 3.0 API, referred to as 3.x, are in deprecated status. The 3.x API versions will continue to be available in deprecated status at least one year, and will be removed starting with the Looker release in June 2023.

    As a result, we encourage you to upgrade your applications to use 4.0 API endpoints instead of 3.x API endpoints before June 2023. The 4.0 API fully covers the functionality offered by the deprecated APIs, and we expect the upgrade from 3.1x to 4.0 to be straightforward for most customers.

    Timeline

    • Pre-2022: API 3.0 is in deprecated status, 3.1 is in stable status, and 4.0 is in beta status
    • March 2022: API 4.0 enters stable status and is generally available in Looker 22.4
    • June 23 2022 - API 3.1 deprecation is announced
    • June 2023 - API 3.x will be removed from Looker

    API 4.0 Migration Overview

    API 3.x Endpoint Replacements

    API 4.0 replaces a few deprecated API 3.x endpoints with equivalent or improved endpoints, listed below:

    • “Space” endpoints have been renamed. Use synonymous “Folder” endpoints instead.
      • Review folder feature documentation.
      • Refer to the list of folder API endpoints.
    • “Homepage” endpoints have been removed. Use expanded functionality “board” endpoints instead.
      • Review board feature documentation.
      • Refer to the list of board API endpoints.

    API 4.0 Breaking ID Field Types

    API 4.0 has updated types for some ID fields from numbers to strings. Use our API reference diff tool to determine which ID fields have changed between 3.1 and 4.0. Use up-to-date (22.0+) Looker-supported language SDKs to ensure your applications are type correct during and after migration. Most community-supported language SDKs, including Kotlin, Swift, R, C# and Go, already work with the updated types as well.

    API 4.0 Diff

    In addition to the above guidelines, the Looker API Interactive Reference provides a full listing of all differences between the 3.1 API and 4.0 API.

    Build on Examples and Tutorials

    Python SDK Examples

    Source code examples and projects that use SDKs to communicate with the Looker API.

    Language Specific Content

    Content related to the language that is currently selected or generic content that works for all languages.

    Data from a Look to a Block

    The Get Look Data Block contains an API call for retrieving the results of a Look.

    API

    OverviewGetting StartedInteractive ReferenceAdvanced UsageExamples & SamplesArticles & Tutorials

    Embedding

    OverviewGetting StartedEmbed SDKAdvanced EmbeddingTroubleshooting

    Actions

    OverviewGetting StartedWriting Custom ActionsExamples & Samples

    Extensions

    OverviewGetting StartedAPI ReferenceExamples & Samples

    Components

    OverviewGetting StartedDocumentation Visualization Components

    Marketplace

    OverviewGetting StartedVisit the MarketplaceCustom Viz BuilderArticles & Tutorials

    Community

    EventsForumsOpen Source

    © 2023 Looker Data Sciences, Inc.
    Privacy | Terms | Cookies