RankCrew API <small><sup><font color=red>BETA</font></sup></small>

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

  1. Submit a RankCrew service order
  2. Get a price quote for a service order
  3. Retrieve the status of a service order (including output data if complete)
  4. Retrieve the current user balance

The API url is:

http://rankcrew.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:

 


 

submit_order

Submits a RankCrew service order.

VariableValue
actionsubmit_order
apikey(your API key)
service(the service being ordered--highlighted in red in the list below)

In addition, all of the fields required for the specified service must be passed (shown below).

NOTICE: The cost is shown as a range rather than a fixed per-item cost. The reason for this is that the cost per item goes down for larger orders. For instance, if you order the maximum qty available for a service, you get the lowest price. If you order 50% of the maximum, you get a price equal to the minimum price plus 50% of the difference between the minimum and maximum price.

social_bookmark_submit - Social Bookmarking Submissions

COST: $0.06 - $0.13 per

VariableReq'dDescription
qtyyesQuantity (from 1 - 100)
urlsyesURLs to Promote ( Max. __maxcnt1__ URL(s), 1 Item per line)
keywordsyesKeywords ( Max. __maxcnt2__ Keyword(s), 1 Item per line)
descriptionyesShort description, explaining why you like and endorse (bookmark) the site
 

rss_submit - RSS Feed Directory Submissions

COST: $0.08 - $0.10 per

VariableReq'dDescription
qtyyesQuantity (from 1 - 50)
nofeednoMy site does not have an RSS feed
feedurlyesRSS Feed URL
urlyesPage URL
titleyesTitle [multiple titles are highly recommended and can be entered via spintax or separated by commas]
descriptionyesDescription
keywordsyesKeywords
 

high_pr_dir_submit - High PR Web Directory Submissions

COST: $0.10 - $0.20 per

VariableReq'dDescription
qtyyesQuantity (from 1 - 100)
urlyesPage URL
titleyesTitle [multiple titles are highly recommended and can be entered via spintax or separated by commas]
descriptionyesDescription
keywordsyesKeywords
fullnameyesName
emailnoEmail (we'll use an EmailClicker.com address if blank)
 

article_dir_submit - Article Directory Submissions

COST: $0.14 - $0.27 per

VariableReq'dDescription
qtyyesQuantity (from 1 - 100)
urlyesPage URL
keywordsyesKeywords
atitlenoArticle Title
articlenoArticle Body [we will pull an article from ArticleBuilder.net if blank]
(Note: ArticleBuilder only covers specific topics. Visit articlebuilder.net for the list of covered topics.)
abcategorynoSelect the Article Builder category to use for this article
resourceyesResource Box / About The Author
Your HTML link(s) should be included in this box.
 

blog_comment - Blog commenting

COST: $1.00 - $1.00 per

VariableReq'dDescription
qtyyesQuantity (from 1 - 40)
urlyesPage URL
keywordsyesKeywords
 

high_pr_forum_profile - High PR Forum Profile Links (PR 4+)

COST: $0.35 - $0.67 per

VariableReq'dDescription
qtyyesQuantity (from 1 - 100)
urlyesPage URL
keywordsyesKeywords
bionoBiography
 

high_pr_web20_link - High PR Authority Web 2.0 Site Links

COST: $0.40 - $0.83 per

VariableReq'dDescription
qtyyesQuantity (from 1 - 100)
urlsyesURLs to Promote ( Max. __maxcnt1__ URL(s), 1 Item per line)
keywordsyesKeywords ( Max. __maxcnt2__ Keyword(s), 1 Item per line)
descriptionyesShort description
 

press_release_submit - Press Release Site Submissions

COST: $0.33 - $0.33 per

VariableReq'dDescription
qtyyesQuantity (from 1 - 30)
section0

Press Release Content

headlineyesHeadLine
contentyesContent (300~1000 words)
summaryyesSummary (Max. 45 words)
featureimgyesFeatured Image(Maximum of 2MB)
section1

Press Release Info

categoryyesCategory
publish_date_timeyesPublish Time
cityyesCity of Origin
countryyesCountry of Origin
website_urlyesWebsite URL
section2

Contact Info

nameyesName
emailyesEmail
phoneyesPhone Number
companyyesCompany Name
addressnoCompany Address
 

blog_create - Blog creation from free blog hosting sites

COST: $1.50 - $1.50 per

VariableReq'dDescription
qtyyesQuantity (from 1 - 30)
categorynoArticleBuilder.net Category
[if your site is not covered by AB, you can provide your own articles. We will publish them as-is]
articlesfilenoZIP file with plain-text articles
[Only required if you do not choose an Article Builder category]
blogcategoriesnoSuggested Blog Categories For Posts
[If not provided, we will come up with categories]
blogaddressyesBlog Address
[We suggest checking availability at wordpress.com's signup page. You can provide up to 10 blog addresses (We will rotate through them if less than 10 are provided).]
 

If successful, output will contain the following information:

VariableValue
order_id(The order_id of the request, passed to the order_detail command.)

 


 

price_order

Gets a price quote for the stated service and quantity.

VariableValue
actionprice_order
apikey(your API key)
servicethe service to get a quote for (from the list shown under the submit_order command)
url(the URL to perform the service for)
qtythe quantity desired (must be within the ranges shown under the submit_order command)

If successful, output will contain the following information:

VariableValue
order_cost(The price of the service as of the time of the request--subject to change.)

 


 

order_detail

Gets a price quote for the stated service and quantity.

VariableValue
actionorder_detail
apikey(your API key)
order_id(the order_id returned from the submit_order command)

If successful, output will contain the following information:

VariableValue
order_id(the order_id)
cost(the price paid for the order)
created(the php time() value at the time the order was created)
started(the php time() value at the time work on the order began)
finished(the php time() value at the time the order was completed)
status(queued or in progress or complete)
tasks(a json-encoded array with all of the tasks for an order and their details--see below)

task array values

NOTICE: You must decode the json string for each task individually in order to get the task array and its values.

VariableValue
service(the task service)
qty(the quantity ordered)
url(the url given)
created(the php time() value at the time the task was created)
started(the php time() value at the time work on the task began)
finished(the php time() value at the time the task was completed)
status(queued or in progress or complete)
resultdata(if complete, the list of link locations or other result data for the task)

 


 

balance

The remaining balance for the account associated with the passed API key.

VariableValue
actionbalance
apikey(your API key)

If successful, output will contain the following information:

VariableValue
balance(Remaining account balance)