System1.2

Get Editable Media


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

Description : Returns a list of all supported documents 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
extensions The types of files which can be edited on MediaFire. list of strings
result Indicates if the API call was successful. 'Error' or "Success' string
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 (group_by_filetype = 'no' XML response)

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

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

Request
http://www.mediafire.com/api/1.2/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.2</current_api_version>
</response>


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

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

Response:
{
  "response": {
    "action": "system/get_editable_media",
    "editable": {
      "extensions": [
        "doc",
        "docx",
        "rtf",
        "odt",
        "sxw",
        "html",
        "txt",
        "xls",
        "xlsx",
        "sxc",
        "ods",
        "csv",
        "tsv",
        "ppt",
        "pps",
        "odp",
        "sxi"
      ]
    },
    "result": "Success",
    "current_api_version": "1.2"
  }
}

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

Request
http://www.mediafire.com/api/system/get_editable_media.php?group_by_filetype=yes&response_format=json


Response:
{
  "response": {
    "action": "system/get_editable_media",
    "editable": {
      "document": {
        "extensions": [
          "doc",
          "docx",
          "rtf",
          "odt",
          "sxw",
          "html",
          "txt"
        ]
      },
      "spreadsheet": {
        "extensions": [
          "xls",
          "xlsx",
          "sxc",
          "ods",
          "csv",
          "tsv"
        ]
      },
      "presentation": {
        "extensions": [
          "ppt",
          "pps",
          "odp",
          "sxi"
        ]
      }
    },
    "result": "Success",
    "current_api_version": "1.2"
  }
}

Get Info


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

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
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
result Indicates if the API call was successful. 'Error' or "Success' string
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.2/system/get_info.php
Response
<response>
    <action>system/get_info</action>
    <timezone>America/Chicago</timezone>
    <timezone_offset>-21600</timezone_offset>
    <image_sizes>
        <image_size>
            <width>32</width>
            <height>32</height>
            <thumbnail>0</thumbnail>
        </image_size>
        <image_size>
            <width>107</width>
            <height>80</height>
            <thumbnail>1</thumbnail>
        </image_size>
        ...
    </image_sizes>     <viewable>         <extensions>             <extension>json</extension>             <extension>doc</extension>             <extension>pdf</extension>             ...
        </extensions>     </viewable>     <editable>         <extensions>             <extension>json</extension>             <extension>doc</extension>             <extension>rtf</extension>             ...
        </extensions>     </editable>     <terms_of_service>         <revision>3.2</revision>         <terms>...</terms>         <date>2013-11-01 17:09:06</date>     </terms_of_service>     <max_keys>500</max_keys>     <max_objects>6000</max_objects>     <max_image_size>26214400</max_image_size>     <result>Success</result>     <current_api_version>1.2</current_api_version> </response>

Example 2 (Success with JSON):

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

Response
{
  "response": {
    "action": "system/get_info",
    "timezone": "America/Chicago",
    "timezone_offset": "-21600",
    "image_sizes": [
      {
        "width": "32",
        "height": "32",
        "thumbnail": "0"
      },
      {
        "width": "107",
        "height": "80",
        "thumbnail": "1"
      },
      ...
    ],
    "viewable": {
      "extensions": [
        "json",
        "doc",
        "pdf",
        ...
      ]
    },
    "editable": {
      "extension": [
        "json",
        "doc",
        "rtf",
        ...
      ]
    },
    "terms_of_service": {
      "revision": "3.2",
      "terms": ...,
      "date": "2013-11-01 17:09:06"
    },
    "max_keys": "500",
    "max_objects": "6000",
    "max_image_size": "26214400",
    "result": "Success",
    "current_api_version": "1.2"
  }
}

Get Limits


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

Notes: Response property total_folder_items_limit is deprecated in preference to the more aptly named new response property max_synchronous_items.
Obsolete response property daily_shares_limit removed.

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
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
total_folder_items_limit The maximum number of items the system will process synchronously. DEPRECATED (Use max_synchronous_items.) integer
max_synchronous_items The maximum number of items the system will process synchronously. integer
result Indicates if the API call was successful. 'Error' or 'Success' string
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.2/system/get_limits.php?session_token=d3d60e59f2cc54457c724677eb73d4588d5f7dafdc7c9e34eb21ab67bf2b707f1d73b91e08347c9fb05193454f2ed5d304d0642d730f8e404e5781e0f1c69f17dda9fd40b9dc814d
Response
<response>
  <action>system/get_limits</action>
  <limits>
    <max_objects>6000</max_objects>
    <max_keys>500</max_keys>
    <max_image_size>26214400</max_image_size>
    <zip_max_filesize>314572800</zip_max_filesize>
    <zip_max_total_filesize>2147483647</zip_max_total_filesize>
    <folder_content_chunk_size>100</folder_content_chunk_size>
    <folder_depth_limit>20</folder_depth_limit>
    <limit_search_results>100</limit_search_results>
    <daily_shares_limit>100</daily_shares_limit>
    <device_changes_list_limit>500</device_changes_list_limit>
    <total_folder_items_limit>100</total_folder_items_limit>
  </limits>
  <result>Success</result>
  <current_api_version>1.2</current_api_version>
</response>

Example 2 (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",
      "daily_shares_limit": "100",
      "device_changes_list_limit": "500",
      "total_folder_items_limit": "100"
    },
    "result": "Success",
    "current_api_version": "1.2"
  }
}

Get Mime Types


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

Description: Returns a list of file extensions, their document type, and their mime types.

Required Parameters:

  • none

Relative Parameters:

  • none

Optional Parameters:

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


Response Properties

Name Description Type
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 broad type/category of the file. unknown, image, video, audio, document, application, archive, data, development, spreadsheet, presentation. string
view Specifies if this file is viewable via MediaFire and, if so, by what system. 0 [not-viewable], 1 [PDF Viewer], 2 [PDF Viewer], 3 [deprecated]. integer
edit Specifies if this file can be edited via MediaFire and, if so, by what system. 0 [not-editable], 1 [Text Editor], 2 [deprecated]. integer
result Indicates if the API call was successful. 'Error' or 'Success' string
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/system/get_mime_types.php
Response
<response>
    <action>system/get_mime_types</action>
    <mime_types>
      <mime_type>
        <mimetype>application/json</mimetype>
        <extension>json</extension>
        <type>development</type>
        <view>1</view>
        <edit>1</edit>
      </mime_type>
    </mime_types>
    <result>Success</result>
    <current_api_version>1.2</current_api_version>
  </response>

Example 2 (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.2"
}

Get Status


GET http://www.mediafire.com/api/1.2/system/get_status.php
POST http://www.mediafire.com/api/1.2/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
database Flag indicating whether the database is 1 [Online] or 2 [Offline or slow]. integer
memcache Flag indicating whether the memory cache servers are 1 [Online] or 2 [Offline or slow]. integer
result Indicates if the API call was successful. 'Error' or 'Success' string
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.2/system/get_status.php
Response
<response>
    <action>system/get_status</action>
    <database>1</database>
    <memcache>1</memcache>
    <result>Success</result>
    <current_api_version>1.2</current_api_version>
</response>

1 = online, 0 = offline or slow to respond


Example 2 (Success with JSON):

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

Response:
{
  "response": {
    "action": "system/get_status",
    "database": "1",
    "memcache": "1",
    "result": "Success",
    "current_api_version": "1.2"
  }
}

Get Supported Media


GET http://www.mediafire.com/api/1.2/system/get_supported_media.php
POST http://www.mediafire.com/api/1.2/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
extensions The types of files which are supported on MediaFire. list of strings
result Indicates if the API call was successful. 'Error' or 'Success' string
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 (group_by_filetype is set to 'yes' XML response)

Request
http://www.mediafire.com/api/1.2/system/get_supported_media.php
Response
<response>
    <action>system/get_supported_media</action>
    <viewable>
        <extensions>
            <extension>bmp</extension>
            <extension>jpeg</extension>
            <extension>jpg</extension>
                  ...
                  ...
            </extensions>
    </viewable>
    <result>Success</result>
    <current_api_version>1.2</current_api_version>
</response>

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

Request
http://www.mediafire.com/api/1.2/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.2</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.2"
}

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.2"
  }
}

Get Version


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

Description : Returns the current API version (major.minor).

Required Parameters:

  • none:

Relative Parameters:

  • none:

Optional Parameters:

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


Response Properties

Name Description Type
result Indicates if the API call was successful. 'Error' or 'Success' string
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.2/system/get_version.php
Response
<response>
    <action>system/get_version</action>
    <current_api_version>1.2</current_api_version>
    <result>Success</result>
</response>

Example 2 (Success with JSON):

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


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