---
title: "ListNewsTeaserPreview returns news items from production and those that are not published yet."
url: "https://developer-qual.migros.ch/apis/content-search-api-qual-v1/versions/169d9ab2-7072-4f6f-811a-fff1e6bc0086/operations/ContentSearch_ListNewsTeaserPreview"
---

> Full API specification: https://developer-qual.migros.ch/apis/content-search-api-qual-v1/versions/169d9ab2-7072-4f6f-811a-fff1e6bc0086.md

# ListNewsTeaserPreview returns news items from production and those that are not published yet.

`GET` `/migros/contentsearch/v1/preview/news`

Operation ID: `ContentSearch_ListNewsTeaserPreview`

## Query parameters

- `contentfulAppId` (string, required) - Required. The contentful app ID to list news for, e.g. corporate.migros.ch test-corporate.migros.ch.
- `language` (string, optional) - Optional. If set, only news matching this language will be returned. By default, german news are returned.
- `newsTagIds` (array, optional) - Optional. Multiple news tags to include in the response. The order of the tags is irrelevant.
- `regionTagIds` (array, optional) - Optional. Multiple localities for which news items should be included in the response. The order of these values is irrelevant.
- `mustNotTopicTagIds` (array, optional) - Optional. Multiple topic tags to exclude from the response. The order of these values is irrelevant. These values are tag IDs.
- `publishedAtOrAfter` (string, date-time, optional) - Optional, inclusive. If specified, the 'published' timestamp of any news returned will have to be the same or after this timestamp. The format must be 'YYYY-MM-DDTHH:mm:ssZ', e.g.: '2025-08-21T11:54:34Z'.
- `publishedUntil` (string, date-time, optional) - Optional, exclusive. If specified, the 'published' timestamp of any news returned will have to be strictly before this timestamp. The format must be 'YYYY-MM-DDTHH:mm:ssZ', e.g.: '2025-08-21T11:54:34Z'.
- `pageSize` (string, int64, optional) - Optional. The maximum number of news items to return in the response.
- `nextPageFrom` (string, int64, optional) - Optional. An offset into the elasticsearch response from where news should be returned, e.g. 6
- `sortBy` (array, optional) - Optional. Multiple sort parameters to determine the order of the results. Example: ['releaseDate:desc', '_score:desc']. Valid fields are releaseDate and _score. Each entry specifies a field and its sort direction (asc/desc).

## Responses

- `200` - A successful response.
- `default` - An unexpected error response.

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: ContentSearch API QUAL
  version: v1.114.1
servers:
  - url: https://api-qual.migros.ch
paths:
  /migros/contentsearch/v1/preview/news:
    get:
      operationId: ContentSearch_ListNewsTeaserPreview
      parameters:
        - description: >-
            Required. The contentful app ID to list news for, e.g.
            corporate.migros.ch

            test-corporate.migros.ch.
          in: query
          name: contentfulAppId
          required: true
          schema:
            type: string
        - description: >-
            Optional. If set, only news matching this language will be returned.
            By

            default, german news are returned.
          in: query
          name: language
          required: false
          schema:
            default: DE
            enum:
              - DE
              - FR
              - IT
              - EN
            type: string
        - description: Optional. Multiple news tags to include in the response. The order
            of the tags is irrelevant.
          explode: true
          in: query
          name: newsTagIds
          required: false
          schema:
            items:
              type: string
            type: array
        - description: Optional. Multiple localities for which news items should be
            included in the response. The order of these values is irrelevant.
          explode: true
          in: query
          name: regionTagIds
          required: false
          schema:
            items:
              type: string
            type: array
        - description: Optional. Multiple topic tags to exclude from the response. The
            order of these values is irrelevant. These values are tag IDs.
          explode: true
          in: query
          name: mustNotTopicTagIds
          required: false
          schema:
            items:
              type: string
            type: array
        - description: >-
            Optional, inclusive. If specified, the 'published' timestamp of any

            news returned will have to be the same or after this timestamp.

            The format must be 'YYYY-MM-DDTHH:mm:ssZ', e.g.:
            '2025-08-21T11:54:34Z'.
          in: query
          name: publishedAtOrAfter
          required: false
          schema:
            format: date-time
            type: string
        - description: >-
            Optional, exclusive. If specified, the 'published' timestamp of any

            news returned will have to be strictly before this timestamp.

            The format must be 'YYYY-MM-DDTHH:mm:ssZ', e.g.:
            '2025-08-21T11:54:34Z'.
          in: query
          name: publishedUntil
          required: false
          schema:
            format: date-time
            type: string
        - description: Optional. The maximum number of news items to return in the response.
          in: query
          name: pageSize
          required: false
          schema:
            format: int64
            type: string
        - description: >-
            Optional. An offset into the elasticsearch response from where news
            should

            be returned, e.g. 6
          in: query
          name: nextPageFrom
          required: false
          schema:
            format: int64
            type: string
        - description: "Optional. Multiple sort parameters to determine the order of the
            results. Example: ['releaseDate:desc', '_score:desc']. Valid fields
            are releaseDate and _score. Each entry specifies a field and its
            sort direction (asc/desc)."
          explode: true
          in: query
          name: sortBy
          required: false
          schema:
            items:
              type: string
            type: array
      responses:
        "200":
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/contentsearchListNewsTeaserResponse"
          description: A successful response.
        default:
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/googlerpcStatus"
          description: An unexpected error response.
      security:
        - apiKeyAuth: []
      summary: >-
        ListNewsTeaserPreview returns news items from production and those that
        are

        not published yet.
      tags:
        - ContentSearch
security:
  - apiKeyAuth: []
components:
  schemas:
    contentsearchListNewsTeaserResponse:
      properties:
        news:
          description: >-
            Optional. If news items matching the requested criteria were found,
            they're

            in here. The returned order is arbitrary.
          items:
            allOf:
              - $ref: "#/components/schemas/contentsearchNewsTeaser"
            type: object
          type: array
        totalHits:
          description: >-
            Total number of news items for this request, not taking page_size
            into

            account.
          format: int64
          type: string
      type: object
    googlerpcStatus:
      properties:
        code:
          format: int32
          type: integer
        details:
          items:
            allOf:
              - $ref: "#/components/schemas/protobufAny"
            type: object
          type: array
        message:
          type: string
      type: object
    contentsearchNewsTeaser:
      description: News currently represents a "Medienmitteilung" or a "Warenrueckruf".
      properties:
        content:
          description: Required.
          type: string
        id:
          description: Required. An opaque system ID.
          type: string
        images:
          description: Optional. Any images that are part of this content.
          items:
            allOf:
              - $ref: "#/components/schemas/contentsearchImage"
            type: object
          type: array
        publishedTimestamp:
          description: The time the content was published. Disregard if published = false.
          format: date-time
          type: string
        region:
          description: Optional. The region for the news item.
          type: string
        slug:
          description: Required. The 'slug' or internal short ID of this news item.
          type: string
        tags:
          description: Tags for this news item.
          items:
            allOf:
              - $ref: "#/components/schemas/consolcontentsearchTag"
            type: object
          type: array
        title:
          description: Required. The title of this news item.
          type: string
        topic:
          description: Required.
          type: string
        translationAvailable:
          description: Required.
          type: boolean
      type: object
    protobufAny:
      additionalProperties: {}
      properties:
        "@type":
          type: string
      type: object
    contentsearchImage:
      properties:
        altText:
          type: string
        caption:
          type: string
        credits:
          type: string
        focalPoint:
          allOf:
            - $ref: "#/components/schemas/ImagePoint"
        height:
          format: int64
          type: string
        id:
          type: string
        mimeType:
          type: string
        shortCaption:
          type: string
        url:
          type: string
        width:
          format: int64
          type: string
      type: object
    consolcontentsearchTag:
      properties:
        id:
          type: string
        title:
          type: string
      type: object
    ImagePoint:
      properties:
        x:
          format: int64
          type: string
        y:
          format: int64
          type: string
      type: object
  securitySchemes:
    apiKeyAuth:
      in: header
      name: X-Api-Key
      type: apiKey
```