WordClerks

Services, Trades and Job Listings - Build an API URL

The WordClerks API makes custom URLs to help make your life easier.

Components

Service Ads API : Use the options below to select and build an API select string. All inputs are optional.


Enter a specific term to search for. This will cause the API to search service titles for this term only
Select which area you would like to search. * Selecting WTB or WTT will disable API search features not available in those sections
Your affiliate ID
(Enter a specific seller username, only services by this seller will be selected)
(The minimum price a service can be listed for, must be a whole number)
(The maximum price a service can be listed for, must be a whole number)
(Select a specific category if you want services from one specific category only)
Select the minimum User Level a seller must have in order to be selected
Choose the amount of services to select Max: 40
Only select services that are Instant
Only select services that are guaranteed
Only select services that are subscription services
Only select services that are currently on sale
Select services that have a custom affiliate amount (more than or equal to)
How this data is ordered
Ascending or Descending
How you would like the data presented to you

Output and URL


API URL

Where the data you specified above resides

Example Output

Example of the output you specified above when calling the API URL

The Data You'll Get Back

Field Description
[id]

The service ID number

[prefix]

The prefix of the service. Valid values are: will, can, could, have, would, want, am, wish

[title]

The service title

[affiliatepercent]

The custom affiliate percentage if more than 10%

[service_url]

The service URL with affiliate link if provided

[order_url]

Direct order URL for the service with affiliate link if provided

[display_title]

Truncated title with prefix, the same as used in listings

[description]

Truncated to 170s, all formatting removed (same as the marketplace listing)

[price]

The price of the service

[tags]

The tags of the service separated by spaces

[views]

The amount of views this service has had

[image]

The service image, original size (not resized)

[image_med]

A 380x265 sized version of the service image

[image_small]

A 102x72 sized version of the service image

[subscription]

This indicates if the service is a subscription service

0 = no

1 = yes

[subscription_period]

This indicates the renewal period for the subscription (only available if subscription is 1)

D = Daily

W = Weekly

M = Monthly

Y = Yearly

[instant_download]

This indicates if the service is an instant download

0 = no

1 = yes

[featured]

This indicates if the service is featured

0 = no

1 = yes

[highlight]

This indicates if the service is highlighted

0 = no

1 = yes

[guarantee]

This indicates if the service is guaranteed

0 = no

1 = yes

[guarantee_text]

The guarantee (text) offered by the seller (only available if guarantee is 1)

[guarantee_percent]

The guarantee percentage offered by the seller (only available if guarantee is 1)

[on_sale]

This indicates if the service is currently on sale

0 = no

1 = yes

[on_sale_price]

The on sale price offered by the seller (only available if on_sale is 1)

[on_sale_expire]

A Unix timestamp of when the sale ends (only available if on_sale is 1)

[staff_certified]

This indicates if the service has been staff certified (proven to work)

0 = no

1 = yes

[staff_comment]

The comment a staff member left for staff certification status (only available if staff_certified is 1)

[total_orders]

The total amount of sales this service has made

[total_bookmarks]

The total amount of bookmarks this service has

[last_update]

The last time this service was updated (Unix timestamp)

[create_date]

The date this service was created (Unix timestamp)

[combined_ratings]

The number of positive ratings minus negative ratings left by buyers for this service

[positive_ratings]

The number of positive ratings left by buyers for this service

[negative_ratings]

The number of negative ratings left by buyers for this service

[seller_username]

The username of the seller

[seller_userid]

The ID of the seller

[seller_userlevel]

The user level of the seller

[seller_country]

The 2 character country code of the user

[seller_bio]

The bio (from settings) of the seller

[seller_avatar]

The URL of the image/avatar the seller has provided in their profile, original image

[seller_avatar_thumb]

A thumbnail of the image/avatar the seller has provided in their profile

[seller_profile]

The URL to the sellers profile

[use_affiliateid]

The affiliate ID which should be used for this API call. Only provided if affiliate ID is provided for the API call.

Single Ad HTML

The single ad html will present an HTML based ad that is pre-formatted. If selected, it will reduce the amount of services to 1 automatically. You can use Javascript, jQuery, cURL, wget or anything else to fetch and display this link quickly. These type of links convert very well and are used on our network of sites.


Example Fetch with an iFrame (The easiest method)

<iframe src="https://wordclerks.com/api?type=inlinead&s=&aff=1&by=&c=0&ul=1&am=1&g=0&sub=0&os=0&sp=0&oby=&oh=&f=singlehtml" style="border: 0; height: 30px;"></iframe>

Demo:

Site Using: Cheap Seo Services just $1

Example Fetch with PHP+cURL

/*
* curl fetch example
*/
$url = 'https://wordclerks.com/api?type=inlinead&s=&aff=1&by=&c=0&ul=1&am=1&g=0&sub=0&os=0&sp=0&oby=&oh=&f=singlehtml';
$ch  = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$results = curl_exec($ch);
echo $results

Demo: Article Translation Service from English to Indonesia... for $10

Replace $url with the API URL you generate from above.

Example Fetch with PHP+file_get_contents()

$url = 'https://wordclerks.com/api?type=inlinead&s=&aff=1&by=&c=0&ul=1&am=1&g=0&sub=0&os=0&sp=0&oby=&oh=&f=singlehtml';
	echo file_get_contents($url);

Demo: Write/Rewrite Product Descriptions (150 words) for $2

Replace $url with the API URL you generate from above.

Example Fetch with jQuery

<span id="ad1"></span>
<script type="application/javascript">
var api_url = 'https://wordclerks.com/api?type=inlinead&s=&aff=1&by=&c=0&ul=1&am=1&g=0&sub=0&os=0&sp=0&oby=&oh=&f=singlehtml';
$.get(api_url, function(data) {
$('#ad1').html(data);
});
</script>

Demo:

Replace api_url with the API URL you generate from above.

Example Fetch with JavaScript

<span id="example-ad2"></span>
<script type="application/javascript">
function loadXMLDoc()
{
	var xmlhttp;
	var api_url = 'https://wordclerks.com/api?type=inlinead&s=&aff=1&by=&c=0&ul=1&am=1&g=0&sub=0&os=0&sp=0&oby=&oh=&f=singlehtml';
	if (window.XMLHttpRequest)
	{// code for IE7+, Firefox, Chrome, Opera, Safari
		xmlhttp=new XMLHttpRequest();
	}
	else
	{// code for IE6, IE5
	xmlhttp=new ActiveXObject("Microsoft.XMLHTTP");
	}
		xmlhttp.onreadystatechange=function()
	{
	if (xmlhttp.readyState==4 && xmlhttp.status==200)
		{
			document.getElementById("example-ad2").innerHTML=xmlhttp.responseText;
		}
	}
	xmlhttp.open("GET",api_url,true);
	xmlhttp.send();
}

loadXMLDoc();
</script>

Demo:

Using these will likely result in an "Origin http://YOURSITE.COM is not allowed by Access-Control-Allow-Origin". It is recommended that you use a server side method to fetch the data first, such as cURL. You can then adjust the JavaScript above to fetch from your local server-side script.