BetaBetaInitialize IaSession object with config.
A config dict used for initializing the object.
Set debug behaviour
Optional Readonly BetaaccessOptional Readonly BetaauthProtected Readonly BetacatalogProtected Readonly BetaconfigProtected Readonly BetacookiesProtected BetadebugSet debug behaviour
BetaheadersHTTP Headers
Readonly BetahostReadonly BetaprotocolOptional Readonly BetasecretProtected Readonly BetasecureReadonly BetaurlOptional BetauserBetaCheck identifier availability
Identifier
TODO
identifier if identifier is available, otherwise a generated available identifier based on the input
BetaCheck S3 limits
Optionalidentifier: stringOptional identifier
OptionalaccessKey: stringOptional access key
API Limits response
BetaCreate a new Item with the supplied metadata and files
Unique identifier for this item
ProtectedfetchBetaSends a GET Request
URL to get
BetaGet latest announcements from the archive.org blog (usually 3)
Array of announcement items
BetaA method for retrieving IaItem and IaCollection objects.
Optional restrictive Metadata type
Optional restrictive file Metadata type
A globally unique Archive.org identifier.
BetaSends a GET request to the URL and expects a JSON response in return. If the response has a non-200 status OR the response has an "error" field, an error gets thrown
Expected return type from a successful response
Promise that resolved with the JSON body
IaApiError - IaApiError If response has a non-200 status or an "error" field.
BetaGet list of detailed view counts for the supplied list of identifiers
If an identifier does not exist, this function will not fail, but the
have_data attribute of the corresponding item will be set to false.
This API call provides data suitable for making item sparclines, and very general summary reporting.
Identifiers to get view counts for
Detailed View counts object
BetaGet media counts for all item categories except account
Object containing category name as keys, and counts as values
BetaGet an Item's metadata from the Metadata API
Globally unique Archive.org identifier.
IaApiItemNotFoundError If the item does not exist
BetaGet all queued or running tasks.
Query parameters, refer to Tasks API for available parameters.
Optionalargs?: stringArgument list (see below; may be wildcarded)
Optionalcatalog?: 0 | 1A list of all active tasks (queued, running, error, or paused) matching the supplied criteria
Optionalcmd?: stringTask command (e.g., archive.php, modify_xml.php, etc.; may be wildcarded)
Optionalcursor?: stringCursor for pagination
Optionalhistory?: 0 | 1A list of all completed tasks matching the supplied criteria
Optionalidentifier?: stringThe item identifier, if provided will return tasks for only this item filtered by other criteria provided in params.
Optionallimit?: numberThe current default is 50 tasks per request, but the caller may request more with the limit parameter The current maximum limit is 500 tasks. Values outside this range are clamped to the server maximum. If the caller wishes to receive all tasks in a single round-trip, they may set limit=0 in the request query.
Optionalpriority?: numberGenerally from 10 to -10
Optionalserver?: stringIA node task will or was executed upon (may be wildcarded)
Optionalsubmitter?: stringUser submitting task (may be wildcarded)
Optionalsubmittime<?: stringFilter by submit time lower than supplied time. Time must be formatted as "YYYY-MM-DD"
Optionalsubmittime<=?: stringFilter by submit time lower or equal to supplied time. Time must be formatted as "YYYY-MM-DD"
Optionalsubmittime>?: stringFilter by submit time greater than supplied time. Time must be formatted as "YYYY-MM-DD"
Optionalsubmittime>=?: stringFilter by submit time greater or equal to supplied time. Time must be formatted as "YYYY-MM-DD"
Optionalsummary?: 0 | 1Total counts of catalog tasks meeting all criteria organized by run status (queued, running, error, and paused). Historical totals are currently unavailable.
Optionaltask_id?: numberTask identifier
Optionalwait_admin?: numberTask run state (see below)
An array of all queued or running tasks.
BetaReturns requestable fields from the endpoint /services/search/v1/fields.
This endpoint requires no authorization.
list of fields that can be requested
BetaGet list of short view counts for the supplied list of identifiers
If an identifier does not exist, this function will not fail, but the
have_data attribute of the corresponding item will be set to false.
Identifiers to get view counts for
View counts object
BetaGet a task log.
The task id for the task log you'd like to fetch.
The task log as a string.
BetaGet a list of all tasks meeting all criteria. The list is ordered by submission time.
params
Optionalargs?: stringArgument list (see below; may be wildcarded)
Optionalcatalog?: 0 | 1A list of all active tasks (queued, running, error, or paused) matching the supplied criteria
Optionalcmd?: stringTask command (e.g., archive.php, modify_xml.php, etc.; may be wildcarded)
Optionalcursor?: stringCursor for pagination
Optionalhistory?: 0 | 1A list of all completed tasks matching the supplied criteria
Optionalidentifier?: stringThe item identifier, if provided will return tasks for only this item filtered by other criteria provided in params.
Optionalpriority?: numberGenerally from 10 to -10
Optionalserver?: stringIA node task will or was executed upon (may be wildcarded)
Optionalsubmitter?: stringUser submitting task (may be wildcarded)
Optionalsubmittime<?: stringFilter by submit time lower than supplied time. Time must be formatted as "YYYY-MM-DD"
Optionalsubmittime<=?: stringFilter by submit time lower or equal to supplied time. Time must be formatted as "YYYY-MM-DD"
Optionalsubmittime>?: stringFilter by submit time greater than supplied time. Time must be formatted as "YYYY-MM-DD"
Optionalsubmittime>=?: stringFilter by submit time greater or equal to supplied time. Time must be formatted as "YYYY-MM-DD"
Optionaltask_id?: numberTask identifier
Optionalwait_admin?: numberTask run state (see below)
A set of all tasks meeting all criteria.
BetaReturns rate limit for specified task type
Task type
Rate limit object
BetaGet the total counts of catalog tasks meeting all criteria,
Item identifier.
Optionalparams: IaGetTasksBasicParamsQuery parameters, refer to Tasks API for available parameters.
Counts of catalog tasks meeting all criteria.
BetaGet top collections from the collections endpoint of the home page API
number of top collections to return
Page number
Array of up to count items of collection info
BetaOptionalidentifier: stringItem identifier.
Query parameters, refer to Tasks API for available parameters.
An iterable of queued or running CatalogTasks.
BetaA generator that returns completed tasks.
Item identifier.
Query parameters, refer to Tasks API for available parameters.
An iterable of completed CatalogTasks.
BetaOptionalidentifier: stringOptionalaccessKey: stringBetaSearch for items on Archive.org using the search API
The Archive.org search query to yield results for. Refer to https://archive.org/advancedsearch.php#raw for help formatting your query.
Params
Optionalfields?: FFields to include in the results. If not supplied, a standard set of fields will be returned.
Regardless of which fields are supplied, the "identifier" field will always be included.
Optionallimit?: numberMaximum number of retries for each API call (default: 5)
OptionalmaxRetries?: numberOptionalrows?: numberOptionalscope?: IaScopeThe scope of the query.
Possible values are 'standard' or 'all'.
The 'all' scope requires authorization
Optionalsorts?: Up to 3 sort options
A Search object, yielding search results.
BetaSend a HTTP request. This method does not perform any error handling currently.
Request to send
Response
BetaSubmit a task
Item identifier.
Task command to submit, see supported task commands
The IaSession is the main class for interacting with Internet Archive API endpoints. (WaybackMachine endpoints are in the WaybackMachine class)
It is recommended to use an instance of this class to access Internet Archive API endpoints.
Example