Social Media Data Repository - Acuity Lab API Documentation

Base URL: https://acuitylab.net/api/social-media

Authentication

All requests to the Social Media Data API require an API key. Include the API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Error Responses

200 OK: Request was successful.
400 Bad Request: The request was invalid.
401 Unauthorized: API key is missing or invalid.
403 Forbidden: The API key does not have permissions for the requested resource.
404 Not Found: The requested resource could not be found.
500 Internal Server Error: Something went wrong on the server side.

1.1 GET /social-media/metrics

Retrieve social media metrics data for a specific platform.

GET https://acuitylab.net/api/social-media/metrics?platform=twitter&date_range=2024-01-01to2024-01-31

{
    "platform": "twitter",
    "metrics": {
        "likes": 3000,
        "retweets": 800,
        "impressions": 100000
    }
}

1.2 GET /social-media/content

Retrieve social media posts based on keywords or topics.

GET https://acuitylab.net/api/social-media/content?keyword=AI&platform=instagram&language=en

{
    "platform": "instagram",
    "posts": [
        {
            "post_id": "12345",
            "content": "AI is transforming industries!",
            "author": "techinsider",
            "engagement": {
                "likes": 1200,
                "comments": 200,
                "shares": 50
            },
            "timestamp": "2024-01-15T08:45:00Z"
        },
        {
            "post_id": "67890",
            "content": "The future of AI is here.",
            "author": "futureai",
            "engagement": {
                "likes": 2300,
                "comments": 180,
                "shares": 75
            },
            "timestamp": "2024-01-14T10:30:00Z"
        }
    ]
}

1.3 GET /social-media/engagement

Retrieve social media engagement statistics by post or user.

GET https://acuitylab.net/api/social-media/engagement?post_id=12345

{
    "post_id": "12345",
    "engagement": {
        "likes": 3000,
        "shares": 800,
        "comments": 200
    }
}

1.4 GET /social-media/hashtags

Retrieve trending hashtags across platforms.

GET https://acuitylab.net/api/social-media/hashtags?platform=twitter&date_range=2024-01-01to2024-01-31

{
    "platform": "twitter",
    "hashtags": [
        "#AI",
        "#machinelearning",
        "#futureoftech"
    ]
}

1.5 GET /social-media/user-insights

Retrieve insights on a user's social media activity and engagement.

GET https://acuitylab.net/api/social-media/user-insights?user_id=12345&platform=instagram

{
    "user_id": "12345",
    "platform": "instagram",
    "insights": {
        "total_posts": 150,
        "average_engagement_rate": "5.5%",
        "followers": 12000,
        "top_post": {
            "post_id": "67890",
            "likes": 2300,
            "shares": 75
        }
    }
}

1.6 GET /social-media/trending-content

Retrieve currently trending content across platforms.

GET https://acuitylab.net/api/social-media/trending-content?platform=twitter

{
    "platform": "twitter",
    "trending_content": [
        {
            "post_id": "23456",
            "content": "AI is changing the tech world!",
            "author": "techleader",
            "engagement": {
                "likes": 3500,
                "retweets": 1500,
                "comments": 300
            }
        }
    ]
}

1.7 GET /social-media/ad-performance

Retrieve performance data on social media ads.

GET https://acuitylab.net/api/social-media/ad-performance?ad_id=98765

{
    "ad_id": "98765",
    "platform": "facebook",
    "performance": {
        "clicks": 1500,
        "impressions": 100000,
        "ctr": "1.5%",
        "cost_per_click": "0.25 USD"
    }
}