DigiLabs SocialFeed Pro API Documentation

Welcome to the DigiLabs SocialFeed Pro API documentation. This document provides details about the available API endpoints and how to use them effectively.

Authentication

All API requests require an Authorization Bearer token for authentication. You can find your token in the dashboard of the DigiLabs SocialFeed Pro application. The token must be sent in the Authorization header as follows:

Authorization: Bearer <base64_encoded(facebook_id:bearer_token)>

Ensure the token is correctly formatted and valid to authenticate your requests successfully.

Endpoints

1. Fetch Instagram Posts

Endpoint:
GET: https://socialfeed.digilabs.cz/api.php?action=instagram_posts&instagram_id={instagram_id}&limit={limit}&offset={offset}

Description:
Retrieve a list of posts from a connected Instagram account.

Parameters:

• instagram_id (string, required):
  The instagram user ID of the Instagram account you want to fetch posts from. The account must be connected in the application.

• limit (integer, optional):
  The number of posts to retrieve. Defaults to 10.

• offset (integer, optional):
  The number of posts to skip for pagination purposes. Defaults to 0.

Example Request:

GET https://socialfeed.digilabs.cz/api.php?action=instagram_posts&instagram_id=1000000000000000&limit=5&offset=2 HTTP/1.1
Authorization: Bearer <your_token>

Response:

• Success (200 OK):

{
    "status": "success",
    "data": [
        {
            "id": "1234567890",
            "caption": "Example caption",
            "media_type": "IMAGE",
            "media_url": "https://example.com/image.jpg",
            "thumbnail_url": null,
            "permalink": "https://www.instagram.com/p/example/",
            "timestamp": "2024-12-13T10:00:00+0000"
        }
    ]
}

• Error (4xx/5xx):

{
    "status": "error",
    "message": "Error message here"
}

Error Codes:

• 403: Unauthorized access. Check your Bearer token.
• 404: Instagram account not connected or not found.
• 500: Internal server error.

Notes

• Ensure that the Instagram account is connected and the authorization token is valid.
• The API supports pagination using the limit and offset parameters for finer control over the fetched data.

For questions or further assistance, please contact the DigiLabs SocialFeed Pro support team.