API to access a Walls.io wall

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 become https://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.

We are rate limiting our API, but have very reasonable limits. Calling our API 1-2 times per second is fine.

• 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

• 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

• POST /media_upload Upload an image or video which can then be used in POST /posts

• 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

• 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

• GET /ads Get a list of ads (Sponsored Posts) for a wall