API documentation
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
Statistics
Get the stats of your videos in XML, CSV and update them when you want.
- GET /video/ID/stats
Retrieve statistics in many formats
- POST /video/ID/stats
Update the stats manually
Track
Track the videos already uploaded.
- POST /track
Track the given videos
YouClone
Migrate YouTube users to your video service.
- POST /youclone
Export all YouTube videos from an account to any other video sites
Libraries
Support
If you have questions, you can ask on the forum or by email at heyspread at particle-s.com.
