listpublinks

Name

listpublinks

Auth

yes

Description

Return a list of current user's public links

Takes no parameters

URL

https://api.pcloud.com/listpublinks

Output

Returns all user's public links in array publinks. For each link the following fields are provided:

Field	Description
linkid	int this id can be used to delete or modify the link
code	string see getfilepublink
link	string see getfilepublink
created	datetime date of the link creation
modified	datetime date of last link modification
metadata	metadata of the object the link points to (directories will not have contents)
downloads	int number of downloads
traffic	int traffic consumed so far by this link (bytes)

If the link has a short link:

Field	Description
shortcode	string see getfilepublink
shortlink	string see getfilepublink

If the link has a short link:

Field	Description
expires	datetime date/time the link will expire (or has expired)

If the link has download limit:

Field	Description
maxdownloads	int maximum number of downloads for this link

If the link has traffic limit:

Field	Description
maxtraffic	int maximum traffic for this link

It is up to the implementations to detect and properly display links that have expired or reached the download or traffic limit.

Example

{
    result: 0,
    publinks: [
        {
            downloads: 0,
            created: "Thu, 03 Oct 2013 13:06:04 +0000",
            link: "https://my.pcloud.com/#page=publink&code=fileCode",
            modified: "Thu, 03 Oct 2013 13:06:04 +0000",
            code: "fileCode",
            traffic: 2027520,
            linkid: linkid,
            metadata: {
                parentfolderid: 21721,
                created: "Wed, 18 Sep 2013 10:18:15 +0000",
                icon: "audio",
                size: 17675824,
                album: "Simple Album",
                artist: "pCloud",
                trackno: 1,
                isfolder: false,
                contenttype: "audio/mpeg",
                genre: "Audio",
                isshared: false,
                thumb: true,
                ismine: true,
                modified: "Wed, 18 Sep 2013 10:19:05 +0000",
                title: "Simple Audio",
                category: 3,
                hash: 6343095883282229000,
                name: "Simple Audio.mp3",
                fileid: 618279,
                id: "f618279"
            }
        },
        {
            downloads: 0,
            created: "Thu, 03 Oct 2013 13:11:44 +0000",
            link: "https://my.pcloud.com/#page=publink&code=folderCode",
            modified: "Thu, 03 Oct 2013 13:11:44 +0000",
            code: "folderCode",
            traffic: 0,
            linkid: linkid,
            metadata: {
                isfolder: true,
                folderid: 21721,
                isshared: true,
                thumb: false,
                modified: "Wed, 18 Sep 2013 10:25:57 +0000",
                parentfolderid: 0,
                created: "Wed, 18 Sep 2013 10:18:14 +0000",
                ismine: true,
                icon: "folder",
                name: "Simple Folder",
                id: "d21721"
            }
        }
    ]
}

Errors