iNeedArticles API

The API webservice allows you to access the primary features of the system via a script or desktop application:

1. Create an order (submit an article request)
2. Retrieve the status of all articles in a request
3. Retrieve the individual articles in a request
4. Retrive current balance

The API url is: https://portal.ineedarticles.com/api.php

Accessing the API

To access the API, you perform an HTTP POST to the above url. All calls to the API require you to pass your API key, which can be found on your account details page.

The API returns JSON encoded objects for all commands. All text fields are UTF8 encoded and must be decoded using a function similar to PHP's utf8_decode().

The object will have two keys: success and output. If success is 0 (false), output will contain an array of errors encountered. If success is 1 (true), output will vary based on the command.

The API supports the following commands:

Request Articles (requestArticles)

Submits an article request to the system. Note: an * indicates required parameter.

If successful, output will contain the following information:

Request Rewrites (requestRewrites)

Submits an article rewrite request to the system. Note: an * indicates required parameter.

If successful, output will contain the following information:

Request Product Reviews (requestProductReviews)

Submits a product reviews request to the system.

If successful, output will contain the following information:

Get Batch Articles (batchArticles)

Returns information on all of the articles in a request.

If successful, output will contain an array of objects, each containing the following information:

$data = array(
    "action" => "batchArticles",
    "apikey" => "00000000-0000-0000-0000-000000000000", # Replace with your API key
    "batch" => "0"
);
$post_options = array(
    "http" => array(
        "method" => "POST",
        "header" => array("Accept: application/json",
        "Content-Type: application/x-www-form-urlencoded"),
        "content" => http_build_query($data)
    )
);

$url = "' . INA_BASE . 'api.php";
$context = stream_context_create($post_options);
$post_result = file_get_contents($url, false, $context);

echo "<pre>";
print_r(json_decode($post_result));
echo "</pre>";

{
  "success": 1,
  "output": [
    {
      "article": "0",
      "keywords": "test",
      "instructions": "Should be written using: <b>US English</b>. <br /><br />",
      "status": "2"
    },
    {
      "article": "1",
      "keywords": "testing",
      "instructions": "Should be written using: <b>US English</b>. <br /><br />",
      "status": "0"
    }
  ]
}