Magento 1.9 rest api developer documentation

Magento 1.9 rest api developer documentation

July 16, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 1.9 rest api developer documentation

Building REST APIs for Magento 1.9: A Comprehensive Guide

As an experienced e-commerce developer, I often receive queries about creating REST APIs for Magento 1.9. While the platform’s official documentation is extensive, finding specific information on building APIs can be challenging. In this post, we’ll walk through the process of setting up a simple REST API for your Magento 1.9 store and discuss some best practices.

Getting Started with Magento 1.9 REST APIs

To begin, ensure you have a stable installation of Magento 1.9 running on your server. For development purposes, I recommend using a local setup or a staging environment that mirrors your production site.

Enabling the API in Magento Admin

Before we dive into the code, let’s enable the API in the Magento admin panel:

  1. Log in to your Magento admin dashboard.
  2. Navigate to System > Web Services > REST API.
  3. Click on Add new service and fill out the necessary details (e.g., name, consumer key, shared secret).
  4. Save the settings by clicking Save Service.

Creating a Simple Product API

Now that we have enabled the service in the admin panel, let’s create a basic REST API endpoint for retrieving product information.

Step 1: Create an API Controller

Navigate to your Magento root directory via SSH or FTP and locate the app/code/core/Mage folder. Inside this folder, you’ll find the core modules. For our example, we’ll use the catalog module:

cd app/code/core/Mage/Catalog/controllers

Create a new file named ApiController.php:

<?php

class Catalog_ApiController extends Mage_Core_Controller_Front_Action
{
    public function indexAction()
    {
        $product = Mage::getModel('catalog/product')->load(1);
        echo $product->getName();
    }
}

This controller will load the first product (ID 1) and display its name when accessed.

Step 2: Define the API Route

To make our new controller accessible via a RESTful URL, we need to define an API route. Open the app/code/core/Mage/Api/etc/config.xml file:

<config>
    <modules>
        <Mage_Api>
            <version>1.9.0</version>
        </Mage_Api>
    </modules>
    <api>
        <!-- Add the following section -->
        <resources>
            <catalog_api>
                <label>Catalog API</label>
                <model>catalog/api_resource_catalog</model>
                <routes>
                    <list translate="true">catalog_api/list</translate>
                </routes>
            </catalog_api>
        </resources>
    </api>
</config>

Replace the catalog_api section with the content above. This configuration tells Magento to use a custom resource model and route for our API.

Step 3: Enable the API Route

Finally, enable the new API route in your Magento admin panel:

  1. Go to System > Configuration > Advanced > Advanced.
  2. Expand the Mage_Api section.
  3. Set API Configuration -> Allowed IPs to *.
  4. Click Save Config.

Testing Your New REST API

With these steps completed, you should now have a functional REST API endpoint for your Magento 1.9 store. To test it:

  1. Access the following URL in your web browser:

    http://your-magento-url.com/api/catalog_api/index
    
  2. You should see the name of the first product (ID 1) displayed on the page.

Best Practices for Magento REST APIs

Use Oauth Authentication

For production environments, always implement OAuth authentication to secure your API endpoints. This ensures that only authorized applications can access your store’s data.

Optimize API Performance

As your catalog grows, optimize your API performance by implementing pagination and filters in your controllers. This prevents large queries from impacting your server’s load times.

Regularly Update Your Magento Version

While this post focuses on Magento 1.9, I recommend migrating to the latest version (or preferably, Magento 2) as soon as possible. The newer versions offer improved performance, security features, and better API support.

Conclusion: Building REST APIs for Magento 1.9

Creating a REST API for your Magento 1.9 store is a powerful way to integrate your e-commerce platform with external applications or third-party services. By following the steps outlined in this post, you can set up simple yet effective APIs that can enhance your store’s functionality.

Remember, while Magento 1.9 has reached its end-of-life status, you can still find valuable resources and support from the developer community and agencies like Laravel Company. If you need further assistance or want to discuss advanced API implementations, don’t hesitate to reach out to our team of Magento experts.

Happy coding!

Magento 1 Catalog Database API

Our network