Walls.io API Documentation

API to access a Walls.io wall.

Please check our pricing and plans at walls.io/pricing for API availability.

General

This is Walls.io API version v1.

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.

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 /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