> ## Documentation Index
> Fetch the complete documentation index at: https://help.lobyco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get list of content items

> Allows clients to query content items based on filters such as campaign name, status, 
publish/modified date ranges, and author. Supports pagination using limit and offset.



## OpenAPI

````yaml openapi/feed-v1.json GET /v1/Content/filter
openapi: 3.0.4
info:
  title: Feed.Api
  version: v1
servers:
  - url: https://{host}/feed
    description: Your Lobyco environment
    variables:
      host:
        default: your-environment.lobyco.net
        description: >-
          The API host for your Lobyco environment. Replace it with the host you
          were given — this placeholder does not resolve.
security:
  - Bearer: []
paths:
  /v1/Content/filter:
    get:
      tags:
        - S2S
      summary: Get list of content items
      description: >-
        Allows clients to query content items based on filters such as campaign
        name, status, 

        publish/modified date ranges, and author. Supports pagination using
        limit and offset.
      parameters:
        - name: Id
          in: query
          description: Internal unique identifier of the content item to filter by.
          schema:
            type: integer
            format: int64
        - name: CampaignName
          in: query
          description: Campaign name to filter content items by.
          schema:
            type: string
        - name: AnalyticsIdentifier
          in: query
          description: Analytics tracking identifier to filter by.
          schema:
            type: string
        - name: Status
          in: query
          description: >-
            Array of content statuses to include in the results (e.g., Draft,
            Published).
          schema:
            type: array
            items:
              $ref: '#/components/schemas/Feed.Api.DTO.ContentStatus'
        - name: FeedType
          in: query
          description: Array of feed types to include in the results (e.g., Inspiration).
          schema:
            type: array
            items:
              $ref: '#/components/schemas/Feed.Api.DTO.FeedType'
        - name: PublishDateFrom
          in: query
          description: Lower bound of the content publish date range to filter by.
          schema:
            type: string
            format: date-time
        - name: PublishDateTo
          in: query
          description: Upper bound of the content publish date range to filter by.
          schema:
            type: string
            format: date-time
        - name: ModifiedDateFrom
          in: query
          description: Lower bound of the content modified date range to filter by.
          schema:
            type: string
            format: date-time
        - name: ModifiedDateTo
          in: query
          description: Upper bound of the content modified date range to filter by.
          schema:
            type: string
            format: date-time
        - name: AuthorName
          in: query
          description: Author name to filter content items by.
          schema:
            type: string
        - name: Sort
          in: query
          description: Sorting expression for results (e.g., "Id:asc", "CampaignName:asc").
          schema:
            type: string
        - name: Limit
          in: query
          description: |-
            Maximum number of items to return in a single page of results. 
            Must be greater than 0.
          required: true
          schema:
            maximum: 2147483647
            minimum: 1
            type: integer
            format: int32
        - name: Offset
          in: query
          description: |-
            Number of items to skip before starting to return results. 
            Useful for paging through large datasets. Must be 0 or greater.
          required: true
          schema:
            maximum: 2147483647
            minimum: 0
            type: integer
            format: int32
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/Feed.Api.DTO.GetContentItemsResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/Feed.Api.DTO.GetContentItemsResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/Feed.Api.DTO.GetContentItemsResponse'
components:
  schemas:
    Feed.Api.DTO.ContentStatus:
      enum:
        - Draft
        - Scheduled
        - Published
        - Expired
        - Disabled
      type: string
    Feed.Api.DTO.FeedType:
      enum:
        - Inspiration
        - Purchase
        - GreenNews
        - StoreOffer
        - StoreNews
        - StoreSpecial
        - GoodPrice
        - WeeklyGoodPrice
        - Survey
        - Event
        - SpecialPoll
        - PartnerBenefit
        - PartnerBenefitBanner
      type: string
    Feed.Api.DTO.GetContentItemsResponse:
      type: object
      properties:
        content:
          type: array
          items:
            $ref: '#/components/schemas/Feed.Api.DTO.ContentItem'
          description: The list of content items returned (after filtering and pagination).
          nullable: true
        totalAmount:
          type: integer
          description: The total number of content items returned.
          format: int32
      additionalProperties: false
    Feed.Api.DTO.ContentItem:
      type: object
      properties:
        id:
          type: integer
          description: Internal unique identifier of the content item.
          format: int64
        campaignName:
          type: string
          description: Name of the content to be easily identified.
          nullable: true
        title:
          type: string
          description: Title of the content item.
          nullable: true
        feedType:
          $ref: '#/components/schemas/Feed.Api.DTO.FeedType'
        contentType:
          $ref: '#/components/schemas/Feed.Api.DTO.ContentType'
        status:
          $ref: '#/components/schemas/Feed.Api.DTO.ContentStatus'
        analyticsIdentifier:
          type: string
          description: Tracking identifier used for analytics.
          nullable: true
        publishDate:
          type: string
          description: The date and time when the content should be published.
          format: date-time
          nullable: true
        expirationDate:
          type: string
          description: >-
            The date and time when the content expires and should no longer be
            displayed.
          format: date-time
          nullable: true
        imageUrl:
          type: string
          description: URL of the image displayed in the content item.
          nullable: true
        altText:
          type: string
          description: Alternative text describing the image, used for accessibility.
          nullable: true
        videoUrl:
          type: string
          description: URL of the video displayed in the content item.
          nullable: true
        topMessage:
          type: string
          description: Short message displayed at the top of the content.
          nullable: true
        bottomMessage:
          type: string
          description: Short message displayed at the bottom of the content.
          nullable: true
        longDescription:
          type: string
          description: Message displayed when the content type is text.
          nullable: true
        buttonText:
          type: string
          description: Text displayed on the action button.
          nullable: true
        navigationType:
          $ref: '#/components/schemas/Feed.Api.DTO.NavigationType'
        externalUrl:
          type: string
          description: External URL to be opened when button is clicked.
          nullable: true
        useWebWrapper:
          type: boolean
          description: >-
            Indicates whether the external content should be opened in a web
            wrapper.
          nullable: true
        deepLinkId:
          type: string
          description: >-
            Deep link identifier. Used to open a specific page from the
            application when button is clicked.
          nullable: true
        deepLinkParameters:
          type: object
          additionalProperties:
            type: string
          description: >-
            Additional parameters for deep link. (e.g. redirect user to a
            specific entity from the section configured with DeepLinkId)
          nullable: true
        deepLinkUrl:
          type: string
          description: Deep link URL for navigation.
          nullable: true
        isReadyToDistribute:
          type: boolean
          description: Indicates whether the content is ready to be distributed.
        isSegmented:
          type: boolean
          description: |-
            Obsolete: Indicates whether the content is segmented. 
            Use Feed.Api.DTO.ContentItem.SegmentationType instead.
          deprecated: true
        segmentationType:
          $ref: '#/components/schemas/Feed.Api.DTO.SegmentationType'
        segmentationFiles:
          type: array
          items:
            $ref: '#/components/schemas/Feed.Api.DTO.SegmentationFile'
          description: Collection of segmentation files associated with the content.
          nullable: true
        authorId:
          type: string
          description: Identifier of the content's author.
          nullable: true
        authorName:
          type: string
          description: Name of the content's author.
          nullable: true
        createdDate:
          type: string
          description: Date and time when the content was created.
          format: date-time
        modifiedDate:
          type: string
          description: Date and time when the content was last modified.
          format: date-time
        membersCount:
          type: integer
          description: Number of members associated with the content.
          format: int32
        fileName:
          type: string
          description: File name associated with the content (if any).
          nullable: true
        fileSize:
          type: number
          description: Size of the associated file in bytes.
          format: double
        externalId:
          type: string
          description: External identifier for the content.
          nullable: true
        storeId:
          type: string
          description: Identifier of the store targeted by this content.
          nullable: true
          deprecated: true
        audienceIds:
          type: array
          items:
            type: string
          description: List of audience identifiers targeted by this content.
          nullable: true
        chainIds:
          type: array
          items:
            type: string
          description: List of chain identifiers targeted by this content.
          nullable: true
        storeIds:
          type: array
          items:
            type: string
          description: List of store identifiers targeted by this content.
          nullable: true
        isBoardContent:
          type: boolean
          description: Client specific property used for custom integration.
          nullable: true
        placeholders:
          type: array
          items:
            type: string
          description: List of placeholders defined for this content.
          nullable: true
        customProperties:
          type: object
          additionalProperties: {}
          description: Dictionary of custom properties.(e.g. logoUrl, terms)
          nullable: true
        disablingReasons:
          type: array
          items:
            $ref: '#/components/schemas/Feed.Api.DTO.ContentDisablingReason'
          description: Reasons why the content may be disabled.
          nullable: true
        priority:
          type: integer
          description: Priority with which the content is displayed in the application.
          format: int32
          nullable: true
        openedCount:
          type: integer
          description: >-
            Number of times the content has been clicked and the user is either
            redirected accordingly to the configured navigation or the feed is
            expanded.
          format: int64
        requiresApproval:
          type: boolean
          description: >-
            Indicates whether the content requires approval before being
            published.
        unifiedCampaignId:
          type: string
          description: Unified campaign identifier associated with the content item
          nullable: true
        validForDays:
          type: integer
          description: >-
            Validity period in days for the content item. The validity period is
            calculated starting from the allocation date. This property is only
            applicable for content items with Customer Segmentation Type.
          format: int32
          nullable: true
      additionalProperties: false
    Feed.Api.DTO.ContentType:
      enum:
        - Image
        - Video
        - Text
      type: string
    Feed.Api.DTO.NavigationType:
      enum:
        - External
        - DeepLink
      type: string
    Feed.Api.DTO.SegmentationType:
      enum:
        - None
        - Audience
        - Customer
        - File
      type: string
    Feed.Api.DTO.SegmentationFile:
      required:
        - customerCount
        - name
        - size
        - url
      type: object
      properties:
        url:
          type: string
          description: URL to access the segmentation file.
          nullable: true
        name:
          type: string
          description: Name of the segmentation file.
          nullable: true
        size:
          type: integer
          description: Size of the segmentation file.
          format: int64
        customerCount:
          type: integer
          description: Number of members included in this segmentation.
          format: int32
      additionalProperties: false
    Feed.Api.DTO.ContentDisablingReason:
      type: object
      properties:
        date:
          type: string
          description: Date at which the feed was disabled.
          format: date-time
        reason:
          type: string
          description: Description of disabling reason.
          nullable: true
        imageUrls:
          type: array
          items:
            type: string
          description: Collection of image URLs attached for the disable action.
          nullable: true
      additionalProperties: false
  securitySchemes:
    Bearer:
      type: apiKey
      description: >-
        Opaque Authorization header using the Bearer scheme. Example:
        "Authorization: Bearer {token}"
      name: Authorization
      in: header

````