For the complete documentation index, see llms.txt. This page is also available as Markdown.

Posts & Fields

Every FeedSpring feed is made up of posts and fields.

Understanding this structure is the key to building layouts with FeedSpring.

What is a post?

A post is a single item inside a feed.

Depending on the source, this could be:

  • An Instagram post

  • A Google review

  • A TikTok video

  • A Dribbble shot

  • A YouTube video

Each feed contains multiple posts.

What is a field?

A field is a piece of data inside a post.

For example:

  • An image

  • A caption or description

  • A link

  • A timestamp

  • A rating

Fields are what you use to display content.

Example

Here is a simplified example of a post:

Each key is a field.

Fields are different for each feed

Each platform provides different data.

Instagram (Preview)

Just a preview, view all attributes on the Instagram feeds page

  • img

  • caption

  • like-count

  • comment-count

Google Reviews (Preview)

Just a preview, view all attributes on the Google Review feeds page

  • review

  • rating

  • name

  • avatar

TikTok (Preview)

Just a preview, view all attributes on the TikTok feeds page

  • img

  • description

  • view-count

  • like-count

Dribbble (Preview)

Just a preview, view all attributes on the Dribbble feeds page

  • img

  • title

  • tag

  • location

👉 See each feed pages for the full list of fields.

Profile fields vs post fields

Feeds also include profile-level data.

Profile fields

These describe the account or source:

  • Name

  • Avatar

  • Bio

  • Follower count

Post fields

These describe individual items:

  • Image or media

  • Text content

  • Timestamp

  • Engagement data

Both can be used when building layouts.

How fields are used

No matter how you use FeedSpring:

  • Attributes

  • React components

  • API

You are always working with the same fields.

Only the syntax changes.

Why this matters

Once you understand posts and fields:

  • You can build any layout

  • You can switch between delivery methods

  • You can combine feeds across platforms

This is the core of how FeedSpring works.

Summary

  • A feed contains posts

  • Each post contains fields

  • Fields are the data you display

  • Fields vary by platform

  • The structure is always the same

Last updated