GIF Posts

Animated GIFs are a fun, engaging way to capture attention. Use the Publer API to create or schedule single‐GIF posts with caption and thumbnail support across multiple platforms.

Overview

GIF posts let you share looping animations with optional captions and metadata. Perfect for reactions, announcements, or adding personality to your feed.

Key Features

• Cross-Platform GIF Publishing
• Custom Caption Support
• Thumbnail Preview
• Immediate or Scheduled Posting

Platform Support & Limits

Network	Size Limit	Notes
Facebook	4 MB	—
Twitter/X	15 MB	4×4 to 2048×2048 px resolution
LinkedIn	Unlimited	Native GIF support
Telegram	50 MB	—
Mastodon	8 MB	Supports JPEG, PNG, WEBP, and GIF
Pinterest	Unlimited	—

Request Structure

Send to the scheduling endpoint (/posts/schedule) or immediate‐publish (/posts/schedule/publish):

POST /api/v1/posts/schedule
{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "gif",
            "text": "Check out this fun GIF!",
            "media": [
              {
                "id": "external",
                "type": "gif",
                "url": "https://media.giphy.com/media/xyz/giphy.gif",
                "path": "https://media.giphy.com/media/xyz/giphy.gif",
                "thumbnail": "https://media.giphy.com/media/xyz/200w.webp",
                "name": "Fun Reaction GIF"
              }
            ]
          }
        },
        "accounts": [
          { 
            "id": "ACCOUNT_ID", 
            "scheduled_at": "2025-08-02T23:18:00+02:00" 
          }
        ]
      }
    ]
  }
}

Required Parameters

Field	Description
networks.{provider}.type	Must be "gif".
networks.{provider}.media	Array of exactly one media object
networks.{provider}.media[].id	"external" or your uploaded media ID
networks.{provider}.media[].type	Must be "gif".
networks.{provider}.media[].url	Direct URL to the GIF file
networks.{provider}.media[].path	Same as URL or CDN path
networks.{provider}.media[].thumbnail	URL to a GIF thumbnail (e.g., WebP format)
networks.{provider}.media[].name	Descriptive name or title for the GIF
accounts[].id	Target social media account ID
accounts[].scheduled_at	ISO 8601 timestamp for scheduling (omit for immediate)

Workflow

1. Reference or upload your GIF via the Media Handling API.
2. Build your post object with "type": "gif".
3. (Optional) Add "thumbnail" and "name" for preview.
4. Call /posts/schedule or /posts/schedule/publish.
5. Monitor /api/v1/job_status/{job_id} for completion.

Best Practices

• Compress GIFs to meet platform size limits without sacrificing quality.
• Provide a clear, engaging thumbnail to boost click-through.
• Use concise captions to add context or calls-to-action.

Related Topics

• Platform-Specific Formats
• Publishing Methods
• Content Types