Link Posts

Share URLs with rich previews (title, description, image, and call-to-action) across your social networks via the Publer API.

Overview

Link posts display a URL preview alongside optional caption text. You control metadata (title, description, images, CTA) to enhance engagement.

Key Features

• Rich previews with title, description, and image

• Custom call-to-action buttons (e.g., LEARN_MORE, SIGN_UP)

• Platform-specific metadata overrides

• Schedule or publish immediately

Platform Support

Step 1: Extract Link Metadata

Before scheduling a link post, you can extract rich metadata from any URL using the /posts/links endpoint. This step is optional but highly recommended for accurate previews.

Use this extracted metadata to build your link post payload.

Step 2: Create or Schedule a Link Post

Use the unified scheduling endpoint (/posts/schedule) or the immediate-publish endpoint (/posts/schedule/publish):

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "link",
            "text": "This is the link post type",
            "link": {
              "url": "http://publer.com",
              "provider_display": "publer.com",
              "description": "Boost your social media strategy with Publer’s suite of tools. Manage multiple accounts, schedule posts, collaborate with your team, and analyze performance—all in one place.",
              "title": "Powerful Social Media Management & Scheduling Tools | Publer",
              "images": [
                "https://framerusercontent.com/assets/20xDElBhD9Xg3L7Cx7jVMwL56FU.png",
                "https://framerusercontent.com/images/OVMI4DbyRxf9neKFkqKesfnSlHE.png",
                "https://framerusercontent.com/images/ShxTAH03BsTSB29AeYZzpPZqi8.jpg",
                "https://framerusercontent.com/images/iuLpS9a0syZanung3ZFGrbYXTKM.jpg",
                "https://framerusercontent.com/images/d7Gg6Hvachd0DuRzXGKoB1szAl4.jpg"
              ],
              "default_image": 0,
              "call_to_action": "LEARN_MORE",
              "phone_number": ""
            }
          }
        },
        "accounts": [
          {
            "id": "63c675b54e299e9cf2b667ea",
            "scheduled_at": "2025-05-24T23:18+02:00"
          }
        ]
      }
    ]
  }
}

Parameters

Note: You can also include original_title, original_description, and original_images if you pre‐fetch metadata yourself, but only the link.* fields above are required.

Workflow

1. Extract Metadata Use /posts/links to fetch title, description, and images from your target URL.

2. Compose Metadata Define url, title, description, and images in the link object.

3. Set Caption Add optional text to introduce or contextualize the link.

4. Choose Default Image Use default_image to highlight your preferred preview image.

5. Schedule or Publish

   • For future posts: include scheduled_at under accounts.

   • For immediate posting: call /posts/schedule/publish or omit scheduled_at.

Best Practices

• Provide Complete Metadata: Supply title, description, and images for compelling previews.

• Optimize Image Dimensions: Match each network’s recommended preview size for best display.

• Use Clear CTAs: Select a relevant call_to_action to guide user action.

Related Topics

• Media Handling

• Content Types

• Publishing Methods