Read first

This API is based on REST principles, it means that you just need an HTTP library to use it. So, you can develop with the language of your choice.

Authentication

You need an API Key findable in your account page which must be present in every requests via the parameter name api_key. See examples below.

cURL

curl http://heyspread.com/api2/video/540?api_key=API_KEY
curl -X POST -d "param1=value1&...&api_key=API_KEY" "http://heyspread.com/api2/..."

Ruby

HeySpread::Account.api_key = "API_KEY"

PHP

define("HEYSPREAD_API_KEY", "API_KEY");

Ping notification

When a video is successfully uploaded, you can receive a POST HTTP notification. See this page.

API methods

Use this endpoint to access the Hey!Spread API: http://heyspread.com/api2/.

Sites

Supported video sites.

• GET /sites

  Retrieve the list of supported video sites

Video

Upload a video to the most popular video sites.

• GET /video

  Retrieve information about an upload

• POST /video

  Upload to the video sites

• POST /video/ID/restart

  Restart the failed uploads

• PUT /video

  Enable statistics

• DELETE /video

  Delete the video from all the sites

Credentials

Check your credentials to know if they're valid and save them.

• POST /credentials

  Save credentials

• POST /credentials/check

  Check if the credentials are valid

• DELETE /credentials

  Delete credentials

Libraries

• PHP
• Ruby

Support

If you have questions, you can ask by email at heyspread at particle-s.com.