Quality Custom Articles At Affordable Prices

iNeedArticles API

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

  1. Submit an article request
  2. Retrieve the status of all articles in a request
  3. Retrieve the individual articles in a request

The API url is:

http://ineedarticles.com/api.php

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:

 


 

requestArticles

Submits an article request to the system.

VariableValue
actionrequestArticles
apikey(your API key)
keywords(article keywords, separated by a newline character)
exactkeys(1 = must use exact keywords in the article, 0 = exact keywords not required [default])
instructions(OPTIONAL Describe the angle or slant you want the article to have and give any additional article style and format requirements. Requires the style fee.)
wordcount(the minimum number of words for the article: 100,200,300..2000)
count(number of articles to create for each keyword)
expedite(1 = 24 hour guranatee, 0 = no time guarantee [default])
bestwriters(1 = 4/5 star writers only, 0 = open to all writers [default])
extraresearch(1 = add additional research fee, 0 = no additional research [default])
stylefee(1 = add if making article style requests, 0 = no specific style requests [default])
postbackurl(OPTIONAL URL to post article data to upon article completion. Data will be in POST variables rather than a JSON encoded object. All variables from a batchArticle call will be posted, as shown below. Your API key will be posted to the apikey variable as well, for verification purposes.)

If successful, output will contain the following information:

VariableValue
batch(The batch id of the request. You must store this value for use in batch related calls.)

 


 

batchArticles

Returns information on all of the articles in a request.

VariableValue
actionbatchArticles
apikey(your API key)
batch(the batch id returned by the requestArticles command)

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

VariableValue
article(the article id)
keywords(the article keywords)
instructions(the article instructions)
status(the article status: 0 = unassigned, 1.5 = being written, 2 = completed)

 


 

batchArticle

Returns an individual article from a batch.

VariableValue
actionbatchArticle
apikey(your API key)
article(the article id returned by the batchArticles command)

If successful, output will contain an array with the following information:

VariableValue
article(the article id)
batch(the batch id of the request)
keywords(the article keywords)
instructions(the article instructions)
status(the article status: 0 = unassigned, 1.5 = being written, 2 = completed)
title(if status = 2, the article title, otherwise blank)
body(if status = 2, the article body, otherwise blank)
spunarticle(if status = 2, the spun version of the article)

Questions? Comments? Need Support? https://thunderhawkllc.freshdesk.com/support/tickets/new