Walls.io API Documentation
API to access a Walls.io wall
General
This is Walls.io API version v1
.
It's available to Walls.io Premium and Large Event Pass users.
All endpoints are prefixed with https://api.walls.io/v1
.
Example:
/posts
would becomehttps://api.walls.io/v1/posts
All endpoints require a valid API access token. Learn how to obtain an access token here. The Walls.io API currently does not support CORS. To avoid exposure of your access token, we don't recommend to use our API client-side / in the browser. Instead, use our API server-side or consider using a proxy.
The API generally returns JSON result, but all endpoints also support the .xml
extension.
The API will not include data from social networks that prohibit redistribution of API data via their terms of service.
Rate limit
We are rate limiting our API, but have very reasonable limits. Calling our API 1-2 times per second is fine.
Endpoints
Posts
- GET
/posts
Get a list of posts - GET
/posts/changed
Get a list of posts, ordered by the time they were updated - GET
/posts/{postId}
Get a single post - POST
/posts
Add a new Native Post - PUT
/posts/{postId}
Change a single post's visibility status, pinned, language, or spam status
Post as RSS
- GET
/posts.rss
Get an RSS feed with the wall's posts - GET
/posts/changed.rss
Get an RSS feed with the wall's posts, ordered by the time they were updated
Media Upload
- POST
/posts/media_upload
Upload an image or video which can then be used in POST/posts
Blacklist or whitelist users
- POST
/user_blacklist
Add a user to this wall's blacklist - DELETE
/user_blacklist
Remove a user from this wall's blacklist - POST
/user_whitelist
Add a user to this wall's whitelist - DELETE
/user_whitelist
Remove a user from this wall's whitelist
Analytics
- GET
/analytics/posts
Get the number of posts per social network on a wall - GET
/analytics/users
Get the number of unique users that have posted on a wall
Ads / Sponsored Posts
- GET
/ads
Get a list of ads (Sponsored Posts) for a wall