Scribd

Explore
Community

Upload a Document
Search Books, Presentations, Business, Academics...

Bekki Hui Jam

My Home
View Public Profile
My Documents
My Collections
Messages
Settings
Help
Log Out

Developers Tools and APIs

Overview
Tutorials
Client Libraries
User Authentication
Usage Limits
Javascript API
Mobile/SOPED
Enterprise SDK
Signing
Help
FAQ
Methods
collections.addDoc
collections.getList
collections.removeDoc
collections.listDocs
docs.upload
docs.uploadFromUrl
docs.getList
docs.getConversionStatus
docs.getSettings
docs.changeSettings
docs.getDownloadUrl
docs.getStats
docs.delete
docs.search
docs.getCategories
docs.featured
docs.browse
 docs.uploadThumb
thumbnail.get
user.login
user.signup
user.getAutoSigninUrl
security.setAccess
security.getDocumentAccessList
security.getUserAccessList

docs.uploadFromUrl
This method retrieves the document file from the specified URL.

Parameters
string url (required)
["pdf", doc_type (optional) Identify the document type with the extension for this file.
"doc", "txt", Note, images (.jpg, etc.) are not allowed. Complete list.
"ppt", etc]
["public", access (optional) Default: "public".
"private"]
integer rev_id (optional) The doc_id to save uploaded file as a revision to.
{0, 1} paid_content (optional) If paid_content is set to 1, the document will become a paid
content document with protected access and encryption enabled by
default. This must be set on initial upload - documents cannot be
converted to paid content after the fact. The default is 0.
{0, 1} secure (optional) Make this document an iPaper Secure document. iPaper
Secure documents need a special embed code - for more information,
see the iPaper Secure documentation. The default is 0.
["download- download_and_drm (optional) Default: "download-pdf". Make a document downloadable
drm", in addition to viewable. This must be set on initial upload -
"download- documents cannot be converted after the fact. DRM download option
pdf", applies ONLY when paid_content is set to 1, and downloading is
"download- NOT supported at all when using iPaper Secure.
pdf-orig",
"view-
only"]
string api_key (required) API key assigned to your account.
string api_sig (optional) MD5 hash of the active request and your secret key. This is
an optional security measure. See the signing documentation for more
info.
string session_key (optional) A session key for a signed in user. If this parameter is
provided, your application will carry out actions on behalf of the
signed in user corresponding to the session key. Otherwise, your
application will carry out actions on behalf of the user account
associated with the API account. See the authentication
 documentation for more information
string my_user_id (optional) This parameter is intended for sites with their own user
authentication system. You can create phantom Scribd accounts that
correspond to your users by simply passing the unique identifier you
use to identify your own user accounts to my_user_id. If you pass this
parameter to an API method, the API will act as if it were executed by
the phantom user corresponding to my_user_id. See the authentication
documentation for more information.

Sample return XML

<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok">
<doc_id>123456</doc_id>
<access_key>key-rvfa2c82sq5bf9q8t6v</access_key>
<secret_password>2jzwhplozu43cyqfky1m</secret_password>
</rsp>

Result explanation
integer doc_id Every document on Scribd is referenced by a unique ID. You can use the ID of
a document to request more information about it or to link to it on Scribd
string access_key Every document on Scribd has a unique, secure access key. You must know
the access key of a document to embed it.
string secret_password Private documents on Scribd have a secret password. You use the secret
password of a private document to link to the private page of the document on
Scribd. This parameter will only be present if the document is private.

Error codes
401 Unauthorized
500 Internal Server Error. Scribd has been notified about this problem.
601 Required parameter missing
602 Unrecognized or blank file extension
603 No file data was sent
606 Problem downloading file
631 Document was not paid document
637 Invalid upload URL - cannot be localhost, scribd.com, or an internal IP.
Upload a Document
Search Books, Presentations, Business, Academics...

Scribd

About
Press
Jobs
 Contact
Blog
Scribd Store

Legal

Terms - General
Terms - API
Terms - Privacy
Copyright

Help & Tools

Getting Started
Community Guidelines
Support & FAQ
Web Stuff

Partners

Partners
Branded Reader
Developers / API

Subscribe to Us

On Scribd
On Twitter
On Facebook

What's New

We have updated our Terms of Service

Branded Reader
Desktop Uploader