Photo Posts

Visual content that drives engagement across social networks. Use photo posts to share high-quality images—single or multiple—while respecting each platform’s unique requirements.

Key Features

  • Multi-Platform Publishing Post images simultaneously to all supported networks.

  • Multiple Image Support Single photos or carousels (up to platform limits).

  • Advanced Customization Captions, alt text, and location tags where available.

  • Resolution Optimization Automatic resizing and format handling per network.

Platform Support & Limits

Platform
Max Photos
Photo Size Limit
Caption Support
Notes

Facebook

Unlimited

No restriction

Yes

Supports alt text, no restrictions on photo size.

Instagram

10

8 MB

Yes

Minimum resolution: 320x320 px, automatically cropped.

TikTok

35

No restriction

No

Cannot mix photos with GIFs or videos.

Threads

20

8 MB

No

Cannot mix photos with GIFs or videos.

Twitter

4

5 MB

No

Supports only up to 4 photos per post.

LinkedIn

20

No restriction

No

Photos and GIFs are supported, cannot mix with videos.

Telegram

10

10 MB

No

Cannot mix photos with GIFs or videos.

Mastodon

4

8 MB

No

Supports JPEG, PNG, or WEBP formats.

Request Structure

Below is an example showing a photo post scheduled for multiple platforms.

Omit scheduled_at for immediate posts.

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "photo",
            "text": "Our new office is complete! #OfficeLife",
            "media": [
              {
                "id": "asset123456",
                "type": "photo",
                "alt_text": "Modern office with open layout"
              },
              {
                "id": "asset123457",
                "type": "photo",
                "alt_text": "Collaborative meeting area"
              }
            ]
          },
          "instagram": {
            "type": "photo",
            "text": "We’ve moved into our new HQ! 🏢✨",
            "media": [
              { "id": "asset123456", "type": "photo", "alt_text": "Modern office space" },
              { "id": "asset123457", "type": "photo", "alt_text": "Meeting area" }
            ]
          }
        },
        "accounts": [
          { "id": "FB_ACCOUNT_ID", "scheduled_at": "2025-05-20T14:30:00Z" },
          { "id": "IG_ACCOUNT_ID", "scheduled_at": "2025-05-20T15:00:00Z" }
        ]
      }
    ]
  }
}

Required Parameters

Field
Description

networks.{provider}.type

Must be "photo".

networks.{provider}.media

Array of { id, type, alt_text? } objects.

accounts[].id

Target social account ID.

accounts[].scheduled_at*

ISO 8601 timestamp for scheduling (optional).

* Omit scheduled_at when publishing immediately.

Media Workflow

  1. Upload Images: Use the Media Handling API to upload files.

  2. Receive IDs: Note each media object’s id.

  3. Compose Post: Reference those IDs in your media array.

  4. Publish/Schedule: Send the payload to the posts endpoint.

Best Practices

  • Optimize Quality: Compress and resize images to platform specs.

  • Descriptive Alt Text: Enhance accessibility and SEO.

  • Tailor Captions: Adjust tone and length per network.

  • Experiment Carousels: Test image order to boost engagement.

  • Consistent Branding: Use uniform styles and watermarks.

Last updated

Was this helpful?