I use Mozenda all the time. When scraping crappy static html pages it is very difficult to find consistency with markup. So thats where Mozenda comes in. I create an agent to scrape a collection of data in a specific order. It can select data between html tags, select data thats supposed to be in one featured place on the page, or it can skip over it if the data you are looking for is not there. It is truely a lifesaving service for anyone that updates mass amounts of data on a regular basis. You cant beat the price of $49/month either (just think how much you would have to pay someone to scrape all of that data for you). I have created a CodeIgniter Library (regular php class compatible) to interact with this api in a easy way. Now lets get to it!

Download

Documentation

First off you need to set your api key and set what format you would like the results to be returned to you in. If you don’t have an api key then

1. Login to your account at http://Login.Mozenda.com

2. Click the ‘Account’ link located in the top right corner of the web page.

3. Look for the ‘API Web Service Key’ section under the ‘Account Details’ tab, then click ‘Generate a New Key’. You will be required to provide this key in all requests to the API.

If you already have your API key then all you need to worry about is setting your output format. The two options are array (php array) and json.

Configuring Your Library

[code language='php']
$config_array = array('output_format' => 'json', 'api_key' => 'MY-SUPER-SECRET-KEY');
$this->mozenda_api->config($config_array);
[/code]

Collection.GetList

Returns a list of collections for an account

[code language='php']

$data = $this->mozenda_api->collection_get_list();

[/code]

Collection.GetViews

Gets a list of views for a particular collection

[code language='php']

$data = $this->mozenda_api->collection_get_views($collection_id);

[/code]

Collection.GetFields

Returns a list of fields that are in that collection with their details

[code language='php']

$data = $this->mozenda_api->collection_get_fields($collection_id);

[/code]

Collection.AddItem

Adds an item to a collection with the values specified.

[code language='php']

$items = array('Username' => 'John', 'Phone_Number' => '555-0123');

$data = $this->mozenda_api->collection_add_item($collection_id, $items);

[/code]

Collection.UpdateItem

Updates an item in the collection.

[code language='php']

$items = array('Username' => 'Peter', 'Phone_Number' => '555-9876');

$data = $this->mozenda_api->collection_update_item($collection_id, $item_id, $items);

[/code]

Collection.DeleteItem

Deletes an item from a collection.

[code language='php']

$data = $this->mozenda_api->collection_delete_item($collection_id, $item_id);

[/code]

Collection.Clear

Clears the contents of a collection but leaves the collection intact.

[code language='php']

$data = $this->mozenda_api->collection_clear($collection_id);

[/code]

Collection.Delete

Deletes the collection and all data within it.

[code language='php']

$data = $this->mozenda_api->collection_delete($collection_id);

[/code]

View.GetItems

Returns items from a view.

[code language='php']

$data = $this->mozenda_api->view_get_items($view_id);

[/code]

Agent.GetList

Returns a list of your agents with their ID, Name, Settings, Description, and other important information.

[code language='php']

$data = $this->mozenda_api->agent_get_list();

[/code]

Agent.GetJobs

Returns a list of your agent’s jobs with detailed information.

[code language='php']

$data = $this->mozenda_api->agent_get_jobs($agent_id);

[/code]

Agent.Run

Starts or resumes the Agent.

[code language='php']

$data = $this->mozenda_api->agent_run($agent_id);

[/code]

Agent.Delete

Deletes an agent and all associated schedules for that agent.

[code language='php']

$data = $this->mozenda_api->agent_delete($agent_id)

[/code]

Job.Get

Gets the details of a job by the Job ID.

[code language='php']

$data = $this->mozenda_api->job_get($job_id);

[/code]

Job.Cancel

Cancels a Job in the system. Note, a job must be in a Paused or Error State to cancel a job.

[code language='php']

$data = $this->mozenda_api->job_cancel($job_id);

[/code]

Job.Pause

Issues the ‘Pause’ command for a job currently running in the system.

[code language='php']

$data = $this->mozenda_api->job_pause($job_id);

[/code]

Job.Resume

Resumes a job that is in a Paused or Error state.

[code language='php']

$data = $this->mozenda_api->job_resume($job_id);

[/code]

I would really recommend taking a look at the official documentation on the mozenda website show here.

That’s It!

That pretty much wraps it all up. If you have any questions or find a bug please use the comments and ill do my best to fix it.

NOTE: The descriptions of what the commands do was copied from the mozenda documentation to make it easier for the end user to understand. I do not take any credit in writing the descriptions.

So I created this library mostly out of boredom. It includes functions to interact with all of the options & functionality that the current version (“EDGE”) provides. It was designed to be a CodeIgniter library but it can easily be ported over to php in just a few steps. It allows you to output the data in json, array, or raw (the format that the request was [json, xml]). So lets get to it!

Download

[download id="1"]

Documentation

Configuration

There are several options you can set in the configuration that will make the library behave differently.

• username – obviously your username for the envato marketplaces
• api_key – your api key for the marketplaces ( you should never set this in view of the public, its sort of like a password ).
• api_format – the format you want the library to request, this can be altered with the next option (output format) – options incude : json, array, xml (default is json)
• output_format – the format you want the library to return to you. options: array (default), json, raw (unaltered/formatted data straight from the feed) note: to get xml format back you need to set this to raw and set api_format to xml

This is how you can set the config information with a simple function and array.
[code language='php']
$this->envato_api->config(array('api_format' => 'json', 'output_format' => 'array', 'username' => 'joesmith', 'api_key' => 'MYSUPERSECRETKEY'));
[/code]

Place the configuration code above the functions listed below.

Public Functions

These are functions that do not require a username and api key to access. They are mostly things such as the latest files on the marketplaces, the most popular threads, etc.

Blog Posts

A list of blog posts for a particular site. Requires a site parameter.

[code language='php']
$data = $this->envato_api->public_blog_posts('sitename');
$this->evanto_api->clear();
[/code]

Active Threads

Threads with the most recent messages activity. Requires a site parameter.

[code language='php']
$data = $this->envato_api->public_threads_active('sitename');
$this->evanto_api->clear();
[/code]

Number of Files in Categories

Shows the number of files in the major categories of a particular site. Requires a site paramater.

[code language='php']
$data = $this->envato_api->public_files_number('sitename');
$this->evanto_api->clear();
[/code]

Category New Files

New files, recently uploaded to a particular site. Requires site and category paramaters.

[code language='php']
$data = $this->envato_api->public_files_new('sitename', 'categoryname');
$this->evanto_api->clear();
[/code]

Popular Files

Returns the popular files for a particular site. Requires a site paramater.

[code language='php']
$data = $this->envato_api->public_files_popular('sitename');
$this->evanto_api->clear();
[/code]

New User Files

Shows the newest 10 files a user has uploaded to a particualr site. Requires username and site paramaters.

[code language='php']
$data = $this->envato_api->public_files_user_new('username', 'sitename');
$this->evanto_api->clear();
[/code]

Random New Files

Shows a random list of newly uploaded files from a particular site (i.e. like the homepage). Requires a site paramater.

[code language='php']
$data = $this->envato_api->public_files_new_random('sitename');
$this->evanto_api->clear();
[/code]

API Releases

Returns Release and Set information for the API (used to generate the documentation).

[code language='php']
$data = $this->envato_api->public_releases();
$this->evanto_api->clear();
[/code]

Private User Functions

These are functions that DO require a username and API key to access. They include things such as account information, billing statements, etc. Make sure to set your username & api key inside the script or with the config function above.

User Vitals

Return a users username and balance.

[code language='php']
$data = $this->envato_api->user_vitals();
$this->evanto_api->clear();
[/code]

User Account

Returns the first name, surname, total earnings, total deposits, balance (deposits + earnings), country and current commission rate for sales.

[code language='php']
$data = $this->envato_api->user_account();
$this->evanto_api->clear();
[/code]

User Earnings & Monthly Sales

Returns the monthly sales data, as displayed on the user’s earnings page.

[code language='php']
$data = $this->envato_api->user_earnings();
$this->evanto_api->clear();
[/code]

User Statement

Returns the last 100 events as seen on the user’s statement page.

[code language='php']
$data = $this->envato_api->user_statement();
$this->evanto_api->clear();
[/code]

User Recent Sales

Shows the 50 recent sales of the user’s items.

[code language='php']
$data = $this->envato_api->user_recent_sales();
$this->evanto_api->clear();
[/code]

User Multiple

This function will return multiple sets of data at once. if you dont supply anything in the parameters it will return all of the results by default. The options inside the array below are the only options you have. You can use as many or as little as you need.

[code language='php']
$data = $this->envato_api->user_multiple(array('account', 'vitals', 'earnings-adn-sales-by-month', 'statement', 'recent-sales'));
$this->evanto_api->clear();
[/code]

Done!

We are all done! If you have any questions, suggestions, bugs or just wanna say thanks then reply in the comments.