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

Network	Preview Elements	Notes
Facebook	Title, description, images, CTA	Full link card support
LinkedIn	Title, description, images, CTA	Full link card support
Twitter/X	Automatic card preview	Metadata driven by Twitter Card tags
Pinterest	Custom images	Requires uploaded images in media
Telegram	Title, description	Native link preview
Mastodon	Title, description	Native link preview
Threads	Title, description	Native link preview
Bluesky	Title, description	Native link preview

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.

Extract Link Metadata

post

Extracts metadata from a URL including title, description, images, and more. Useful for previewing links before creating a post.

Authorizations

BearerApiAuth

AuthorizationstringRequired

API key authentication. Format: "Bearer-API YOUR_API_KEY"

Body

application/x-www-form-urlencoded

urlstringRequired

The URL to extract metadata from

Responses

200

Successful operation

application/json

401

Unauthorized

application/json

422

Unprocessable Entity - Invalid URL

application/json

post

/posts/links

HTTPcURLJavaScriptPython

POST /api/v1/posts/links HTTP/1.1
Host: app.publer.com
Authorization: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 14

"url='text'"

{
  "link": {
    "title": "text",
    "description": "text",
    "url": "text",
    "original_url": "text",
    "images": [
      "text"
    ],
    "favicon": "text",
    "provider_display": "text",
    "type": "link"
  }
}

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

Field	Type	Description
bulk.state	string	scheduled, publish, or a draft state
networks.{provider}.type	string	Must be "link"
networks.{provider}.text	string	Caption or message to accompany the link (optional)
networks.{provider}.link.url	string	The target URL
networks.{provider}.link.title	string	Preview title (overrides fetched metadata)
networks.{provider}.link.description	string	Preview description (overrides fetched metadata)
networks.{provider}.link.images	array	Array of image URLs for the preview (overrides fetched metadata)
networks.{provider}.link.default_image	integer	Index (0-based) of the default image in the images array
networks.{provider}.link.call_to_action	string	CTA button type (e.g., LEARN_MORE, SIGN_UP)
accounts[].id	string	Target account identifier
accounts[].scheduled_at	string	ISO 8601 timestamp for scheduling (omit to publish immediately)

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