System1.5

Get Editable Media

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

POST http://www.mediafire.com/api/1.5/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.5,
}

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

Request

http://www.mediafire.com/api/1.5/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.5</current_api_version>
</response>

Get Info

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

POST http://www.mediafire.com/api/1.5/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	Value
timezone	The server's timezone.	string
timezone_offset	The server timezone offset, in seconds, from UTC.	integer
image_sizes	An array of image size objects and the associated thumbnail designation for a particular image size.	object []
image_sizes->width	The wide of the image	integer
image_sizes->height	The image height	integer
image_sizes->thumbnail	The thumnail designation	string
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
privacy_policy	MediaFire's Privacy Policy .	string
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.5/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: 
   }
   privacy_policy:{
      revision: 1.6,
      terms: 
   }
   max_keys: 500,
   max_objects: 6000,
   max_image_size: 26214400,
   result: Success,
   current_api_version: 1.5,
}

Get Limits

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

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

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_chunk_filesize	The maximum file size, in bytes, of any single chunk in a resumable upload	integer
max_total_filesize	The maximum file size, in bytes, of any single file in the system	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:

{
   action: system/get_limits,
   limits:{
      max_objects: 6000,
      max_keys: 500,
      max_image_size: 26214400,
      max_chunk_filesize: 21474836580,
      max_total_filesize: 53687091300,
      zip_max_filesize: 314572800,
      zip_max_total_filesize: 2147483647,
      folder_content_chunk_size: 100,
      folder_depth_limit: 130,
      limit_search_results: 100,
      device_changes_list_limit: 500,
      total_folder_items_limit: 100,
      max_synchronous_items: 100,
   }
   result: Success,
   current_api_version: 1.5,
}

Get Mime Types

GET www.mediafire.com/api/1.5/system/get_mime_types.php

POST www.mediafire.com/api/1.5/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(Text Editor)
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.5"
}

Get Status

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

POST http://www.mediafire.com/api/1.5/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.5/system/get_status.php

Response

<response>
    <action>system/get_status</action>
    <database>1</database>
    <memcache>1</memcache>
    <result>Success</result>
    <current_api_version>1.5</current_api_version>
</response>

Get Supported Media

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

POST http://www.mediafire.com/api/1.5/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.5,
}

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

Request

http://www.mediafire.com/api/1.5/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.5</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.5"
}

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

Get Version

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

POST http://www.mediafire.com/api/1.5/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.5/system/get_version.php?response_format=json

Response:

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