Getting Started

Billing

Contact

Device

Download

File

Folder

Notifications

System

Upload

User

System1.0

Get Editable Media


Description : Returns a list of all supported documents for editing.

Required Parameters

  • none

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


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

Example 1 (defaults to not being grouped by filetype):

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

Example 2 (group_by_file is set to yes):

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


Get Info


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

Required Parameters:

  • none

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

The Response Includes:
  • The server time zone and its current offset, in seconds, from UTC.
  • The supported image sizes and the associated thumbnail designation for a particular image size.
  • The lists of file extensions organized in the categories 'viewable' and 'editable'.
  • The most recent terms of service.
  • The maximum number of keys, the maximum number of objects, and the maximum image size.
    Description of the Limits:
    • max_keys The maximum number of quickkeys and folderkeys allowed to be passed to file/get_info, file/copy, file/delete, file/move, folder/get_info, folder/copy, folder/delete, and folder/move.
    • max_objects : The maximum number of items that can be returned by folder/get_siblings.
    • max_image_size : The maximum file size of an image to be uploaded.


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

      Example:

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

      Get Limits


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

      Required Parameters:

      • none

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

      Description of the limits :
      • max_objects : The maximum number of items that can be returned by folder/get_siblings.
      • max_keys : The maximum number of quick_keys and folderkeys allowed to be passed to file/get_info, file/copy, file/delete, file/move, folder/get_info, folder/copy, folder/delete, and folder/move.
      • max_image_size : The maximum filesize of an image to be uploaded.
      • zip_max_filesize : The maximum size of individual files that can be added to the zip file.
      • zip_max_total_filesize : The maximum total size of the zip file.
      • folder_content_chunk_size : The maximum number of items returned by folder/get_content.
      • folder_depth_limit : The maximum number of items in the depth chain returned by folder/get_depth.
      • limit_search_results : The maximum number of search results returned by folder/search.
      • daily_shares_limit : The maximum number of collaboration shares allowed per day. OBSOLETE
      • device_changes_list_limit : The grouping size of a device changes list returned by device/get_changes.


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

      Example:

      Request 
      http://www.mediafire.com/api/1.0/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>
    </limits>
    <result>Success</result>
    <current_api_version>1.0</current_api_version>
</response>

      Get Mime Types


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

      Required Parameters:

      • none

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


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

      Example:

      Request 
      http://www.mediafire.com/api/1.0/user/get_info.php?session_token=123456789012345678901234567890123456789012345678901234567890&version=1
      Response 
      <response>
    <action>system/get_mime_types</action>
    <mime_types>
        <mime_type>
            <extension>.3dm</extension>
            <category>other</category>
            <type>application/world</type>
        </mime_type>
        <mime_type>
                    <extension>.3dmf</extension>
                    <category>other</category>
                    <type>application/world</type>
            </mime_type>
            <mime_type>
                    <extension>.3g2</extension>
                    lt;category>video</category>
                    <type>video/3gp2</type>
            </mime_type>
            <mime_type>
                    <extension>.3gp</extension>
                    <category>video</category>
                    <type>video/3gpp</type>
            </mime_type>
            <mime_type>
                    <extension>.a</extension>
                    <category>other</category>
                    <type>application/octet-stream</type>
            </mime_type>
            <mime_type>
                    <extension>.aab</extension>
                    <category>other</category>
                    <type>application/authorware-bin</type>
            </mime_type>
            . . .
            <mime_type>
                    <extension>.zsh</extension>
                    <category>text</category>
                    <type>text/script.zsh</type>
            </mime_type>
    </mime_types>
    <result>Success</result>
    <current_api_version>1.0</current_api_version>
</response>

      Get Status


      Description: Returns the current state of the cloud infrastructure.

      Required Parameters:

      • none

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


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

      Example:

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

      1 = online, 0 = offline or slow to respond


      Get Supported Media


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

      Required Parameters:

      • none

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


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

      Example 1 (defaults to not being grouped by filetype):


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

      Example 2 (group_by_filetype is set to yes):

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

      Get Version


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

      Required Parameters:

      • none:

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


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

      Example:

      Request 
      http://www.mediafire.com/api/1.0/system/get_version.php
      Response 
      <response>
    <action>system/get_version</action>
    <current_api_version>1.0</current_api_version>
    <result>Success</result>
</response>