Partner API

How to fix media_unavailable for a public media URL in a social publishing API

8 min read

Quick answer

Fix media_unavailable by making the exact imageUrl, videoUrl or every imageUrls item reachable over HTTPS without cookies, browser login or private-network access. Test redirects and expiry from a server environment, use the field matching the post type, and retry with a stable URL after MultiPost can fetch and re-host the asset.

01.

How do you fix media_unavailable when publishing a public media URL by API?

Make the submitted imageUrl, videoUrl or everyimageUrls item reachable by MultiPost without cookies, browser login or private-network access. A 502 media_unavailable response means MultiPost could not fetch and host the supplied media.

Test the exact URL from a server-side environment, including redirects and expiry. A link that works only in your signed-in browser is not a public media input for an API publishing job.

02.

What is the fast way to send external media through MultiPost?

Link the customer through MultiPost accounts, then send a stable HTTPS URL in the field matching the post type. MultiPost re-hosts external media on its verified storage before publishing to the selected networks.

API publishing is available on Pro and Agency. Check plans and billing separately from media reachability so a plan error is not misdiagnosed as a failed download.

03.

Which media field should each API post type use?

Use imageUrl for an image, videoUrl for a video and one to twenty imageUrls for a slideshow. Text posts do not need media, while the target list must still contain at least one supported platform.

For a concrete multi-image payload, see how to schedule a TikTok photo slideshow from public image URLs.

04.

What should you verify before retrying an inaccessible media URL?

Verify that the URL returns the intended file, remains valid long enough for processing, does not require custom browser headers and has not been replaced by an HTML error page. For a slideshow, test every item because one inaccessible source can invalidate media preparation.

Generate a new stable URL after fixing access and submit a deliberate new request. Do not loop on the same private or expired link; the response has already identified media preparation as the blocking stage.

05.

How does MultiPost handle the media after it becomes reachable?

MultiPost downloads and re-hosts the external file before the network publish or scheduled queue is accepted. Your integration remains responsible for supplying the correct asset and content type, while MultiPost handles the verified hosting step needed by supported targets.

Frequently asked questions

What does media_unavailable mean?

MultiPost could not fetch and host one or more media URLs supplied in the publish request.

Can the source URL require a login cookie?

No. The URL must be reachable by the MultiPost server without an interactive browser session.

Which field does a slideshow use?

Use imageUrls with between one and twenty public image URLs.

Does MultiPost re-host external media?

Yes. MultiPost fetches external inputs and hosts them on its verified storage before publishing.

Start free

Make the asset fetchable before you blame the network target.

MultiPost handles verified hosting once your integration supplies the correct stable public media URL.

Back to the blog