You are on page 1of 3

Home

iPaper
Documentation
Resources
FAQ
Login

Documentation
Overview
Scribd API
Overview
Authentication
Signing
API Methods
docs.upload
docs.uploadFromUrl
docs.getList
docs.getConversionStatus
docs.getSettings
docs.changeSettings
docs.delete
docs.search
user.login
user.signup
QuickSwitch
iPaper Javascript API
Slurp

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 what the
"doc", extension *would* be for this file.
"txt",
"ppt",
etc]
["public", access (optional) Default: "public".
"private"]
int rev_id (optional) The doc_id to save uploaded file as a revision to.
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 security
documentation page. 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
int 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

Terms
Copyright
© 2007

About
FAQ
Platform
Contact
Blog
Store
Jobs