Display Feeds in contentfry

Understand how Display Feeds work, where to find them, and how they differ from the contentfry API.

contentfry is a modular social aggregation platform used to build social walls, UGC campaigns, and custom embeds. One of the fastest ways to access curated, ready-to-display content is via Display Feeds.

This guide covers:

What Display Feeds are
How to find and configure them
How to use their JSON output
Differences vs. the contentfry API v2

1. What Is a Display Feed?

A Display Feed is a lightweight JSON endpoint that makes it easy to access posts from a specific Display inside a Room—no authentication or setup required.

All the content is pre-moderated and filtered based on:

Your selected connections
Moderation status
Applied filters and display settings
Sort order in the Display

You can use Display Feeds to:

Build custom social walls and embeds
Power event displays or in-store screens
Prototype frontends instantly—no login or API key needed
Grab curated UGC for publishing with zero integration effort

In short, a Display Feed is a ready-to-go, curated JSON output, perfect for rapid development and production use.

Try it: Here’s a sample feed URL: https://feed.contentfry.com/cats

2. Display Feeds vs. API v2

Both deliver data, but their purposes differ.

Display Feed (no authentication)

Public endpoint (no token required)
Mirrors one specific Display configuration
Frontend-ready JSON
No dynamic queries or edits
Ideal for embeds, signage, and simple clients

contentfry API v2 (bearer token)

Documentation: developer.contentfry.com/v2/api

Secure access via token
Full control over teams, rooms, displays, and posts
Advanced filtering and queries
Ideal for dashboards, automation, and multi-room access

Feature	Display Feed	API v2
🔐 Authentication	❌ No	✅ Yes
⚙️ Per-request filters	❌ No	✅ Yes
📦 JSON output	✅ Curated	✅ Raw or filtered
🧩 Multi-room access	❌ No	✅ Yes
💡 Best for	Embeds, signage	Internal tools, automation

3. Finding a Display Feed

Open Teams
Choose your Team → Room
Go to Displays
Select a Display
Navigate to Share → Feed

There you’ll find:

The Display Feed URL
Copy button and JSON preview
Derived filter information
GitHub React/Next.js examples
Social Wall and static HTML options

Example URL:

https://feed.contentfry.com/cats

4. Example JSON Response

The same consistent and predictable structure is used for all Display Feed API responses. Each response includes a meta section for status and total items, a data array containing posts, and a pagination object for navigating results. This schema is uniform across all feeds and post sources, so you can reliably parse and consume API responses without custom logic for each type.

{
  "meta": { "code": 200, "total": 27 },
  "data": [
    {
      "id": "c12345_ugc_room_20559_1730828048654",
      "room_id": 20559,
      "user_name": "User123",
      "media_type": "image",
      "posted_at": "2024-11-05T17:34:14Z",
      "source": "ugc",
      "description": "Sample description",
      "image": "https://cdn.example.com/media/sample.jpg",
      "image_size": { "width": 1440, "height": 900 },
      "color": { "h": 224, "s": 80, "l": 47 },
      "connection": {
        "id": 24318,
        "name": "Example Connection",
        "source": "ugc"
      }
    }
  ],
  "pagination": {
    "next_offset": 24,
    "total": 27,
    "next_url": "https://feed.contentfry.com/myfeed/?offset=24"
  }
}

All feeds use a consistent schema, predictable pagination, and standardized post fields across networks (Instagram, TikTok, Facebook, UGC, etc.).

5. How Display Feeds Are Configured

Feeds inherit configuration from their parent Display.
They do not have standalone settings.

Inherited attributes

Content sources: selected connections and channels
Filters: hashtags, language, media types, keywords
Moderation: only approved posts appear
Sorting: newest, random, or custom order

If you need dynamic filters via URL parameters, use API v2 instead.

6. When to Use Display Feeds

Use Display Feeds when you need:

⚡ Public JSON for embeds or prototypes
🧱 Ready-to-use Social Wall or static HTML
📺 Digital signage integrations
💻 Frontend apps that do not require authentication

Summary

Display Feeds are the fastest way to access curated, moderated, display-ready content from contentfry.
They are public, consistent, and mirror your Display configuration exactly.

Display Feeds