1. Media
swonkie.dev
  • Introduction
  • Quick Start
  • Changelog
  • Social Networks
    • Facebook
    • Instagram
    • LinkedIn
    • TikTok
    • Threads
  • Profiles
    • My Profiles
      GET
    • Competitors
      GET
  • Insights
    • Getting Started
    • My Profile Insights
      GET
    • My Profile Insights Posts
      GET
    • Competitor Insights
      GET
    • Competitor Insights Posts
      GET
  • Posts
    • Getting Started
    • List Posts
      GET
    • Get a Post
      GET
    • Create a Post
      POST
    • Update a Post
      PUT
    • Validate a Post
      GET
    • Delete a Post
      DELETE
    • Change Post Stage
      PATCH
  • Labels
    • Getting Started
    • List Labels
    • Create a Label
  • Media
    • Get a Media
      GET
    • Create a Media
      POST
    • Upload File to Media
      PUT
    • Confirm Uploaded Media
      PATCH
    • Delete a Media
      DELETE
  • Examples
    • Publish
Back to Home
Back to Home
Login
  1. Media

Get a Media

GET
/media/{mediaId}
Retrieves detailed information about a specific media file from your workspace's media library. This endpoint returns metadata about the media including its URL, preview, type, dimensions, file size, and processing status. Use this to verify media uploads or retrieve media details for display purposes.
Important: The media must belong to your workspace, otherwise a 404 error will be returned. The returned URLs are temporary signed URLs for accessing the media files.

Notes#

The media must belong to your workspace, otherwise a 404 error will be returned.
The path and preview URLs are temporary signed URLs that expire after a certain time period.
Status SUCCESS indicates the media is fully processed and ready to use in posts.
Status PROCESSING means the file is still being processed - wait before using it in posts.
Status ERROR indicates processing failed - the file may need to be re-uploaded.
Status ARCHIVED means the file has been archived and may not be available for use.
The specs object contains technical metadata extracted during processing.
For videos, the duration field indicates length in seconds.
Use this endpoint to verify that media uploaded via POST /media has been successfully processed before using it in posts.

Request

Path Params

Header Params

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.swonkie.dev/v2/media/TWVkaWFJZDk4NzY1NDMyMQ21' \
--header 'X-API-ID: {{apiId}}' \
--header 'X-API-KEY: {{apiKey}}'
Response Response Example
{
    "id": "TWVkaWFJZDk4NzY1NDMyMQ",
    "name": "product-photo.jpg",
    "path": "https://storage.example.com/media/abc123.jpg",
    "preview": "https://storage.example.com/previews/abc123-thumb.jpg",
    "type": "image/jpeg",
    "status": "SUCCESS",
    "specs": {
        "width": 1920,
        "height": 1080,
        "duration": null,
        "fileSizeBytes": 2456789
    },
    "createdAt": "2026-01-15T10:30:00.000Z"
}
Modified at 2026-03-11 19:13:35
Previous
Media
Next
Create a Media
Built with