Text Art Cowsay API

Generate an ASCII art of cow and other things saying things.

To access the web version of this service click here.

API End Points

The end point for connecting : If you subscribe directly from us use this endpoint.
	http://api.textart.io/cowsay
	

Ratelimiting

Our Text Art Cowsay API is public. To maintain our service level we ratelimit the number of API calls. For public API calls this is 60 API calls a day with distribution of 5 calls an hour. For paid plans this limit is increased according to the service level described in the plan.

Authentication

For public calls you don't need to pass any API key. Just invoke the endpoint (see examples below). For paid subscriptions you need to pass the API key.

Currently we support API Key based authentication. Please set a request header 'X-Textart-Api-Secret' with value of your API key. Alternatively you can also pass api_key= as a request parameter, though we strongly discourage this mode of passing the key.

Listing available cowsay styles public ratelimited

List all the available cowsay styles

POST  /cowsay/list_styles

List all the available cowsay styles

Parameters
Parameter NameParameter TypeDescription
output
The result is a json object with list of available cowsay styles

Here is an example using curl.

curl -v -i -X GET -H 'X-Textart-Api-Secret: <api_key>' http://api.textart.io/cowsay/list_styles.json
{
    "success": {
        "total": 48
    },
    "contents": {
        "cowstyles": [
            "beavis.zen",
            "bong",
            "bud-frogs",
            "bunny",
            "cheese",
            "cower",
            "daemon",
            "default",
            "dragon-and-cow",
            "dragon",
            "elephant-in-snake",
            "elephant",
            ...
        ]
    }
}
        

Convert the given text into cowsay (text art) with the chosen cowsay style public ratelimited

Convert a text to one of the cowsay styles

POST  /cowsay

Convert a text to one of the cowsay styles

Parameters
Parameter NameParameter TypeDescription
textstringText to translate.
stylestringCowsay style to use.
encodeboolShould Base64 encode the result or not.
output
The result is a json object with the cowsay as (encoded) text.

Here is an example using your browser to convert the given text. Click on the below link to get the json response for the text.

http://api.textart.io/cowsay.json?text=ThisIsAwesome&style=vader

Here is an example using CURL to convert the given text.

curl -v -i -X POST -H 'X-Textart-Api-Secret: <api_key>' http://api.textartio/cowsay.json -d text=ThisIsAwesome -d style=turkey
	

The above call if successful will return a json response something like this.

{
    "success": {
        "total": "1"
    },
    "contents": {
        "style": "turkey",
        "cowsay": "..."
    }
}
	

Subscribe

Text Art Cowsay API Basic

$4.99/mo

No contracts. Anytime cancellation.
1 API Key
2000 API Calls / day
Best in class backend tools
Easy to use REST API
Immediate provisioning

Text Art Cowsay API Premium

$9.99/mo

No contracts. Anytime cancellation.
1 API Key
5000 API Calls / day
Best in class backend tools
Easy to use REST API
Immediate provisioning

Text Art Cowsay API Ultra

$24.99/mo

No contracts. Anytime cancellation.
1 API Key
15000 API Calls / day
Best in class backend tools
Easy to use REST API
Immediate provisioning