System1.3

Get Editable Media


GET http://www.mediafire.com/api/1.3/system/get_editable_media.php
POST http://www.mediafire.com/api/1.3/system/get_editable_media.php

Description : Returns a list of all file formats for editing.

Required Parameters:

  • none

Relative Parameters:

  • none

Optional Parameters:

  • group_by_filetype : Groups lists by filetype 'yes' or 'no' (default 'no').
  • response_format : 'xml' or 'json' (default 'xml')



Response Properties

Name Description Type Value
extensions The types of files which can be edited on MediaFire. list of strings
error The numerical error code integer
message The error description for error string
deprecated Indicates this API is deprecated and should no longer be used string yes
result Indicates if the API call was successful string Error/Success
current_api_version The latest stable API version number string

Error Codes

To view a list of possible error codes for this API, and their descriptions, click here.


Examples:


Example 1 (Success with JSON - group_by_filetype =no)

Request
HTTPS://www.mediafire.com/api/system/get_editable_media.php?group_by_filetype=no&response_format=json
Response
{
   action: system/get_editable_media,
   editable:{
      extensions:[
         json,
         css,
         csv,
         js,
         pl,
         sh,
         tcl,
         xhtml,
         xhtm,
         html,
         htm,
         txt,
         text,
         h,
         cc,
         cxx,
         xml,
         cpp,
         php,
         c,
         php3,
         php4,
         php5,
         phps,
         ini,
         bat,
         bsh,
         cob,
         hpp,
         java,
         jsp,
         mak,
         phtml,
         phtml,
         phtml,
         phtml,
         py,
         shtml,
         shtml,
         sql,
         vb,
         vbs,
         vbs,
         vbs,
         conf,
         inf,
         csv,
      ]
   }
   result: Success,
   current_api_version: 1.3,
}

Example 2 (group_by_file is set to 'yes' XML response):

Request
http://www.mediafire.com/api/1.3/system/get_editable_media.php?group_by_filetype=yes
Response:
<response>
    <action>system/get_editable_media</action>
    <editable>
        <document>
            <extensions>
                <extension>doc</extension>
                <extension>docx</extension>
                <extension>rtf</extension>
                <extension>odt</extension>
                <extension>sxw</extension>
                <extension>html</extension>
                <extension>txt</extension>
            </extensions>
        </document>
        <spreadsheet>
            <extensions>
                <extension>xls</extension>
                <extension>xlsx</extension>
                <extension>sxc</extension>
                <extension>ods</extension>
                <extension>csv</extension>
                <extension>tsv</extension>
            </extensions>
        </spreadsheet>
        <presentation>
            <extensions>
                <extension>ppt</extension>
                <extension>pps</extension>
                <extension>odp</extension>
                <extension>sxi</extension>
            </extensions>
        </presentation>
    </editable>
    <result>Success</result>
    <current_api_version>1.3</current_api_version>
</response>



Get Info


GET http://www.mediafire.com/api/1.3/system/get_info.php
POST http://www.mediafire.com/api/1.3/system/get_info.php

Notes:

Description: Returns all the configuration data about the MediaFire system.

Required Parameters:

  • none

Relative Parameters:

  • none

Optional Parameters:

  • response_format : 'xml' or 'json' (default 'xml')

Response Properties

Name Description Type Value
timezone The server's timezone. string
timezone_offset The server timezone offset, in seconds, from UTC. integer
image_sizes The supported image sizes and the associated thumbnail designation for a particular image size. list of objects
viewable File formats that can be viewed via MediaFire. object
editable File formats that can be edited via MediaFire. object
terms_of_service The most recent terms of service. object
max_keys The maximum number of resource keys allowed to be passed to file/get_info, file/copy, file/delete, file/move, folder/get_info, folder/copy, folder/delete, folder/move. integer
max_objects The maximum number of results that can be returned by folder/get_siblings. integer
max_image_size The maximum file size, in bytes, of an image to be uploaded. integer
error The numerical error code integer
message The error description for error string
deprecated Indicates this API is deprecated and should no longer be used string yes
result Indicates if the API call was successful string Error/Success
current_api_version The latest stable API version number string

Error Codes

To view a list of possible error codes for this API, and their descriptions, click here.


Examples:


Example 1 (Success with JSON):

Request
HTTPS://www.mediafire.com/api/1.3/system/get_info.php?response_format=json
Response
{
   action: system/get_info,
   timezone: America/Chicago,
   timezone_offset: -18000,
   image_sizes:[
      {
         width: 32,
         height: 32,
         thumbnail: 0,
      }
      {
         width: 107,
         height: 80,
         thumbnail: 1,
      }
      {
         width: 191,
         height: 145,
         thumbnail: 2,
      }
      {
         width: 335,
         height: 251,
         thumbnail: 3,
      }
      {
         width: 515,
         height: 386,
         thumbnail: 4,
      }
      {
         width: 800,
         height: 600,
         thumbnail: 5,
      }
      {
         width: 1024,
         height: 768,
         thumbnail: 6,
      }
      {
         width: 1280,
         height: 800,
         thumbnail: 7,
      }
      {
         width: 1600,
         height: 1200,
         thumbnail: 8,
      }
      {
         width: 1680,
         height: 1050,
         thumbnail: 9,
      }
      {
         width: 1920,
         height: 1080,
         thumbnail: a,
      }
      {
         width: 2240,
         height: 1680,
         thumbnail: b,
      }
      {
         width: 2560,
         height: 1920,
         thumbnail: c,
      }
      {
         width: 3072,
         height: 2304,
         thumbnail: d,
      }
      {
         width: 3264,
         height: 2448,
         thumbnail: e,
      }
      {
         width: 4064,
         height: 2704,
         thumbnail: f,
      }
      {
         width: 8000,
         height: 8000,
         thumbnail: z,
      }
   ]
   viewable:{
      extensions:[
         json,
         doc,
         pdf,
         rtf,
         xls,
         ppt,
         odg,
         odp,
         ods,
         odt,
         ac3,
         gif,
         png,
         css,
         csv,
         js,
         tsv,
         ogv,
         xlsm,
         ppsm,
         docm,
         ppsx,
         xlsx,
         xltx,
         docx,
         dotx,
         sxi,
         sxw,
         pl,
         sh,
         tcl,
         wma,
         wav,
         bmp,
         tga,
         webm,
         flv,
         wmv,
         avi,
         wks,
         wps,
         xhtml,
         xhtm,
         mp3,
         ogg,
         jpg,
         jpeg,
         jpe,
         jfif,
         tiff,
         tif,
         html,
         htm,
         txt,
         asc,
         text,
         h,
         cc,
         cxx,
         xml,
         3gp,
         3gpp,
         3g2,
         3gpp2,
         mp4,
         mpg4,
         mpeg,
         mpg,
         mov,
         aiff,
         zzz,
         pptx,
         pps,
         rtf,
         cpp,
         rtf,
         mkv,
         doc,
         mod,
         php,
         c,
         php3,
         php4,
         php5,
         phps,
         ini,
         bat,
         bsh,
         cob,
         hpp,
         java,
         jsp,
         mak,
         phtml,
         phtml,
         phtml,
         phtml,
         py,
         shtml,
         shtml,
         sql,
         vb,
         vbs,
         vbs,
         vbs,
         conf,
         inf,
         m4v,
         csv,
         vob,
         m4v,
         abw,
         ogg,
         mp3,
         wma,
         oga,
         mp4,
         mkv,
         ogv,
         wma,
         m4a,
         m4a,
         ogg,
         avi,
         mov,
         mpg,
         ogv,
         flv,
         3gp,
         vob,
         wmv,
         aac,
         ac3,
         xcf,
      ]
   }
   editable:{
      extensions:[
         json,
         css,
         csv,
         js,
         pl,
         sh,
         tcl,
         xhtml,
         xhtm,
         html,
         htm,
         txt,
         text,
         h,
         cc,
         cxx,
         xml,
         cpp,
         php,
         c,
         php3,
         php4,
         php5,
         phps,
         ini,
         bat,
         bsh,
         cob,
         hpp,
         java,
         jsp,
         mak,
         phtml,
         phtml,
         phtml,
         phtml,
         py,
         shtml,
         shtml,
         sql,
         vb,
         vbs,
         vbs,
         vbs,
         conf,
         inf,
         csv,
      ]
   }
   terms_of_service:{
      revision: 3.0,
      terms: 
   }
   max_keys: 500,
   max_objects: 6000,
   max_image_size: 26214400,
   result: Success,
   current_api_version: 1.3,
}

Get Limits


GET http://www.mediafire.com/api/1.3/system/get_limits.php
POST http://www.mediafire.com/api/1.3/system/get_limits.php

Notes:


Description: Returns a list of various limits that the API honors.

Required Parameters:

  • none

Relative Parameters:

  • none

Optional Parameters:

  • response_format : 'xml' or 'json' (default 'xml')

Response Properties

Name Description Type Value
max_keys The maximum number of resource keys allowed to be passed to file/get_info, file/copy, file/delete, file/move, folder/get_info, folder/copy, folder/delete, folder/move. integer
max_objects The maximum number of results that can be returned by folder/get_siblings. integer
max_image_size The maximum file size, in bytes, of an image to be uploaded. integer
zip_max_filesize The maximum file size, in bytes, of a file to be added to a zip container. integer
zip_max_total_filesize The maximum file size of the zip container. integer
folder_content_chunk_size The maximum number of items returned by folder/get_content. integer
folder_depth_limit The maximum number of chain folders returned by folder/get_depth. integer
limit_search_results The maximum number of search results returned by folder/search. integer
device_changes_list_limit The maximum number of changes returned by device/get_changes. integer
max_synchronous_items The maximum number of items the system will process synchronously. integer
error The numerical error code integer
message The error description for error string
deprecated Indicates this API is deprecated and should no longer be used string yes
result Indicates if the API call was successful string Error/Success
current_api_version The latest stable API version number string

Error Codes

To view a list of possible error codes for this API, and their descriptions, click here.


Examples:


Example 1 (Success with JSON):

Request
http://www.mediafire.com/api/system/get_limits.php?response_format=json&session_token=d3d60e59f2cc54457c724677eb73d4588d5f7dafdc7c9e34eb21ab67bf2b707f1d73b91e08347c9fb05193454f2ed5d304d0642d730f8e404e5781e0f1c69f17dda9fd40b9dc814d
Response:
{
  "response": {
    "action": "system/get_limits",
    "limits": {
      "max_objects": "6000",
      "max_keys": "500",
      "max_image_size": "26214400",
      "zip_max_filesize": "314572800",
      "zip_max_total_filesize": "2147483647",
      "folder_content_chunk_size": "100",
      "folder_depth_limit": "20",
      "limit_search_results": "100",
      "device_changes_list_limit": "500",
      "total_folder_items_limit": "100",
      "max_synchronous_items": "100",
    },
    "result": "Success",
    "current_api_version": "#CURRENT_API_VERSION#"
  }
}

Get Mime Types


GET www.mediafire.com/api/1.3/system/get_mime_types.php
POST www.mediafire.com/api/1.3/system/get_mime_types.php

Description: Returns a list of file extensions and their content type. This API also returns privilege level (view/edit).

Required Parameters:

  • none

Relative Parameters:

  • none

Optional Parameters:

  • response_format : 'xml' or 'json' (default 'xml')


Response Properties

Name Description Type Value
mimetype The MIME data type information list of objects
extension The file extension associated with this MIME data type. More than one extension can be associated with a single MIME data type so there may multiple entries in the response for a particular MIME data type. string
type The file type string unknown, image, video, audio, document, application, archive, data, development, spreadsheet, presentation
view Specifies if this file is viewable via MediaFire and, if so, by what system integer 0(not-viewable), 1(PDF2HMTL), 2(PDF-JS)
edit Specifies if this file can be edited via MediaFire and, if so, by what system integer 0(not-editable), 1(ACE)
error The numerical error code integer
message The error description for error string
deprecated Indicates this API is deprecated and should no longer be used string yes
result Indicates if the API call was successful string Error/Success
current_api_version The latest stable API version number string

Error Codes

To view a list of possible error codes for this API, and their descriptions, click here.


Examples:


Example 1 (Success with JSON):

Request
http://www.mediafire.com/api/system/get_limits.php?response_format=json&session_token=d3d60e59f2cc54457c724677eb73d4588d5f7dafdc7c9e34eb21ab67bf2b707f1d73b91e08347c9fb05193454f2ed5d304d0642d730f8e404e5781e0f1c69f17dda9fd40b9dc814d
Response:
{
  "action":"system\/get_mime_types",
  "mime_types":[{
    "mimetype":"application\/json",
    "extension":"json",
    "type":"development",
    "view":"1",
    "edit":"1"
  },{
    "mimetype":"application\/msword",
    "extension":"doc",
    "type":"document",
    "view":"1",
    "edit":"0"
  },....{
    "mimetype":"audio\/x-hx-aac-adts",
    "extension":"aac",
    "type":"audio",
    "view":"4",
    "edit":"0"
  },{
    "mimetype":"application\/octet-stream",
    "extension":"ac3",
    "type":"audio",
    "view":"4",
    "edit":"0"
  }],
  "result":"Success",
  "current_api_version":"1.3"
}

Get Status


GET http://www.mediafire.com/api/1.3/system/get_status.php
POST http://www.mediafire.com/api/1.3/system/get_status.php

Description: Returns the current state of the cloud infrastructure.

Required Parameters:

  • none

Relative Parameters:

  • none

Optional Parameters:

  • response_format : 'xml' or 'json' (default 'xml')


Response Properties

Name Description Type Value
database Specifies whether the database is online or not flag 1 [Online] or 2 [Offline or slow]
memcache Specifies whether the memory cache servers are online or not flag 1 [Online] or 2 [Offline or slow]
error The numerical error code integer
message The error description for error string
deprecated Indicates this API is deprecated and should no longer be used string yes
result Indicates if the API call was successful string Error/Success
current_api_version The latest stable API version number string

Error Codes

To view a list of possible error codes for this API, and their descriptions, click here.


Examples:


Example 1 (Success with XML):

Request
http://www.mediafire.com/api/1.3/system/get_status.php
Response
<response>
    <action>system/get_status</action>
    <database>1</database>
    <memcache>1</memcache>
    <result>Success</result>
    <current_api_version>1.3</current_api_version>
</response>

Get Supported Media


GET http://www.mediafire.com/api/1.3/system/get_supported_media.php
POST http://www.mediafire.com/api/1.3/system/get_supported_media.php

Description : Returns the list of all supported document types for preview.

Required Parameters:

  • none

Relative Parameters:

  • none

Optional Parameters:

  • group_by_filetype : groups lists by filetype 'yes' or 'no' (default 'no').
  • response_format : 'xml' or 'json' (default 'xml')


Response Properties

Name Description Type Value
extensions The types of files which are supported on MediaFire. object
error The numerical error code integer
message The error description for error string
deprecated Indicates this API is deprecated and should no longer be used string yes
result Indicates if the API call was successful string Error/Success
current_api_version The latest stable API version number string

Error Codes

To view a list of possible error codes for this API, and their descriptions, click here.


Examples:


Example 1 (Success with JSON)

Request
HTTPS://www.mediafire.com/api/system/get_supported_media.php?response_format=json
Response
{
   action: system/get_supported_media,
   viewable:{
      extensions:[
         json,
         doc,
         pdf,
         rtf,
         xls,
         ppt,
         odg,
         odp,
         ods,
         odt,
         ac3,
         gif,
         png,
         css,
         csv,
         js,
         tsv,
         ogv,
         ...
         wma,
         m4a,
         m4a,
         ogg,
         avi,
         mov,
         mpg,
         ogv,
         flv,
         3gp,
         vob,
         wmv,
         aac,
         ac3,
         xcf,
      ]
   }
   result: Success,
   current_api_version: 1.3,
}

Example 2 (group_by_filetype is set to 'yes' XML response):

Request
http://www.mediafire.com/api/1.3/system/get_supported_media.php?group_by_filetype=yes
Response
<response>
    <action>system/get_supported_media</action>
    <viewable>
        <image>
            <extensions>
                 <extension>bmp</extension>
                 <extension>jpeg</extension>
                        ...
                        ...
            </extensions>
            </image>
            <document>
                 <extensions>
                    <extension>doc</extension>
                    <extension>dot</extension>
                         ...
                         ...
                    </extensions>
            </document>
            <spreadsheet>
                <extensions>
                    <extension>xls</extension>
                    <extension>xlw</extension>
                         ...
                         ...
                </extensions>
            </spreadsheet>
            <presentation>
                <extensions>
                    <extension>ppt</extension>
                    <extension>pps</extension>
                         ...
                         ...
                    </extensions>
            </presentation>
        </viewable>
    <result>Success</result>
    <current_api_version>1.3</current_api_version>
</response>

Example 3 (group_by_filetype is set to 'yes' JSON response):

Request
http://www.mediafire.com/api/system/get_supported_media.php?group_by_filetype=yes


Response:
{
  "action":"system\/get_supported_media",
  "viewable":{
    "development":{
      "extensions":[
        "json","css","js","pl","sh","tcl","xhtml","xhtm","html","htm","h","cc","cxx","xml","cpp","php","c","php3","php4","php5","phps","ini",
        "bat","bsh","cob","hpp","java","jsp","mak","phtml","phtml","phtml","phtml","py","shtml","shtml","sql","vb","vbs","vbs","vbs","conf","inf"
      ]
    },"document":{
      "extensions":[
        "doc","pdf","rtf","odt","docm","docx","dotx","sxw","wps","txt","asc","text","rtf","rtf","doc","abw"
      ]
    },"spreadsheet":{
      "extensions":[
        "xls","ods","csv","tsv","xlsm","xlsx","xltx","wks","csv"
      ]
    },"presentation":{
      "extensions":[
        "ppt","odg","odp","ppsm","ppsx","sxi","pptx","pps"
      ]
    },"audio":{
      "extensions":[
        "ac3","wma","wav","mp3","ogg","aiff","zzz","ogg","mp3","wma","oga","wma","m4a","m4a","ogg","aac","ac3"
      ]
    },"image":{
      "extensions":[
        "gif","png","bmp","tga","jpg","jpeg","jpe","tiff","tif"
      ]
    },"video":{
      "extensions":[
        "ogv","webm","flv","wmv","avi","3gp","3gpp","3g2","3gpp2","mp4","mpg4","mpeg","mpg","mov","mod","m4v","vob","m4v","mp4","ogv","avi","mpg","ogv","flv","3gp","vob","wmv"
      ]
    }
  },
  "result":"Success",
  "current_api_version":"1.3"
}

Example 4 (group_by_filetype is set to 'no' JSON response):

Request
http://www.mediafire.com/api/system/get_supported_media.php?response_format=json
Response:
{
  "response": {
    "action": "system/get_supported_media",
    "viewable": {
      "extensions": [
        "bmp",
        "jpeg",
        "jpg",
        ...
      ]
    },
    "result": "Success",
    "current_api_version": "1.3"
  }
}

Get Version


GET http://www.mediafire.com/api/1.3/system/get_version.php
POST http://www.mediafire.com/api/1.3/system/get_version.php

Description: Returns the current API version.

Required Parameters:

  • none

Relative Parameters:

  • none

Optional Parameters:

  • response_format : 'xml' or 'json' (default 'xml')


Response Properties

Name Description Type Value
error The numerical error code integer
message The error description for error string
deprecated Indicates this API is deprecated and should no longer be used string yes
result Indicates if the API call was successful string Error/Success
current_api_version The latest stable API version number string

Error Codes

To view a list of possible error codes for this API, and their descriptions, click here.


Examples:


Example 1 (Success with JSON):

Request
http://www.mediafire.com/api/1.3/system/get_version.php?response_format=json


Response:
{
  "response": {
    "action": "system/get_version",
    "current_api_version": "1.3",
    "result": "Success"
  }
}