Track analytics with the Content Tag API

Use the Content Tag API to group posts by campaign, product, or theme across multiple brands—then track performance by tag.

Use case

You’re launching a lipstick campaign across four brands. Create a “Lipstick” tag, apply it via automation, and report on engagement across all related posts.

Implementation

Before you start

You’ll need:

API Key
Brand IDs
Organization ID

If you don’t have your organization ID, call GET https://auth.dashsocial.com/api/self using your API key:

curl 'https://auth.dashsocial.com/api/self' \
  -H 'Authorization: Bearer {token}'

Sample response:

{
    "accessible_brands": [144],
    "brands": {
        "your-brand": {
            "id": 144,
            "name": "Your Brand",
            "organization": {
                "id": 1,
                "name": "Your Organization"
            },
            "organization_id": 1
        }
    },
    "organization": {
        "id": 1,
        "name": "Your Organization"
    },
    "organization_id": 1
}

Look for organization_id at the top level of the response. Get started with the API →

Step 1: Creating a content tag

Already have a Content Tag? Skip this step and jump to Step 2.

Start by creating a tag to group your campaign content. This lets you later filter and report on posts that share the same theme, product, or time frame.

POST https://library-backend.dashsocial.com/organizations/{organization_id}/content_tags
body = {
    "name": "Lipstick",
    "brand_ids": [
        1000,
        1001,
        1002,
        1003
    ]
}

Key query parameters

organization_id: Your org’s unique ID (ask your account manager if unsure)
name: Name of the tag (e.g., “Lipstick”)
brand_ids: Array of brand IDs to apply this tag to

Sample response:

{
    "brand_ids": [
        1000,
        1001,
        1002,
        1003
    ],
    "created_at": "2025-03-07T15:48:45+00:00",
    "id": 3817,
    "name": "Lipstick",
    "organization_id": 1,
    "updated_at": "2025-03-07T15:48:45+00:00"
}

Step 2: Retrieving content tags

Use this endpoint to list all your content tags. Useful for confirming tag names or getting tag IDs for reporting:

GET https://library-backend.dashsocial.com/organizations/{organization_id}/content_tags

Key query parameters

organization_id: Your organization’s unique ID.

Sample response:

[
    {
        "brand_ids": [
       	 		1000,
        		1001,
        		1002,
        		1003
    		],
        "created_at": "2025-01-26T08:20:44+00:00",
        "id": 3816,
        "name": "2025",
        "organization_id": 1,
        "updated_at": "2025-01-26T08:20:44+00:00"
    }
    {
        "brand_ids": [
       	 		1000,
        		1001,
        		1002,
        		1003
    		],
        "created_at": "2025-03-07T15:48:45+00:00",
        "id": 3817,
        "name": "Lipstick",
        "organization_id": 1,
        "updated_at": "2025-03-07T15:48:45+00:00"
    }
 ]

Step 3: Auto-tag posts

Use Content Automation to apply tags based on rules (e.g., hashtags, captions).

Step 4: Get post level metrics

Use this query to get a list of posts that have specific tags, along with metrics like impressions, likes, or comments. Ideal for reviewing individual post performance:

PUT https://library-backend.dashsocial.com/brands/{brand_id}/media/v2
body = {
    "filters": {
        "content_tags": ["Lipstick", "2025"]
    },
    "limit": 99,
    "offset":0
}

Key query parameters

brand_id: Brand ID you’re querying
content_tags: Tags to filter by (e.g., ["Lipstick", "2025"])
limit: Max results per page (default 99)
offset: Pagination offset.

Sample response:

{
    "data": [
        {
            "brand_id": 1000,
            "brand_media_id": 796350589,
            "caption_question": {
                "is_question": false,
                "user_overridden": false
            },
            "caption_sentiment": {
                "is_negative": false,
                "is_neutral": true,
                "is_positive": false,
                "user_overridden": false
            },
            "comment_sentiment": null,
            "community_engagement": null,
            "content_tags": [
                "A test content tag"
            ],
            "created_at": "2025-02-27T17:16:56",
            "custom_metrics": [
                {
                    "id": 78,
                    "value": null
                }
            ],
            "facebook": null,
            "id": 506593868,
            "image": {
                "sizes": {
                    "medium_square": {
                        "height": 640,
                        "url": "https://images.dashsocial.com/aHR0cHM6Ly9jZG4uZGFzaHNvY2lhbC5jb20vbWVkaWEvZnVsbC8xNzQwNjc2NjE0LjgzODM2MTU5MTE5MC5qcGVn.jpg?w=640&h=640&fit=cover",
                        "width": 640
                    },
                    "original": {
                        "height": 1024,
                        "size": 213914,
                        "url": "https://cdn.dashsocial.com/media/original/1740676614.732703492652.jpg",
                        "width": 1024
                    },
                    "original_converted": {
                        "height": 1024,
                        "size": 209493,
                        "url": "https://cdn.dashsocial.com/media/full/1740676614.838361591190.jpeg",
                        "width": 1024
                    },
                    "small": {
                        "height": 400,
                        "url": "https://images.dashsocial.com/aHR0cHM6Ly9jZG4uZGFzaHNvY2lhbC5jb20vbWVkaWEvZnVsbC8xNzQwNjc2NjE0LjgzODM2MTU5MTE5MC5qcGVn.jpg?w=400&h=400",
                        "width": 400
                    },
                    "small_square": {
                        "height": 400,
                        "url": "https://images.dashsocial.com/aHR0cHM6Ly9jZG4uZGFzaHNvY2lhbC5jb20vbWVkaWEvZnVsbC8xNzQwNjc2NjE0LjgzODM2MTU5MTE5MC5qcGVn.jpg?w=400&h=400&fit=cover",
                        "width": 400
                    }
                }
            },
            "instagram": {
                "ad_ids": null,
                "adset_ids": null,
                "amount_spent": null,
                "avg_time_viewed_sec": null,
                "campaign_ids": null,
                "caption": "",
                "clicks": null,
                "comments_count": 0,
                "cost_per_thruplay": null,
                "cpc": null,
                "cpm": null,
                "ctr": null,
                "effectiveness": 0.0,
                "emv": 300.32,
                "engagement": 0.0,
                "engagement_rate_impressions": 0.0,
                "engagement_rate_public": 0.0,
                "entertainment_score": null,
                "followers_gained": null,
                "follows": null,
                "hashtags": [],
                "impressions": 0,
                "is_boosted": false,
                "is_carousel": true,
                "is_commented": false,
                "is_mentioned": false,
                "is_riq": false,
                "is_tagged": false,
                "like_count": 0,
                "paid_and_organic_reach": 0,
                "paid_and_organic_saved": 0,
                "paid_and_organic_shares": 0,
                "paid_comments": 0,
                "paid_engagement_rate": 0.0,
                "paid_impressions": 0,
                "paid_likes": 0,
                "paid_reach": null,
                "paid_reactions": null,
                "paid_saved": 0,
                "paid_shares": null,
                "paid_total_engagement": 0,
                "paid_total_engagements": 0,
                "paid_video_views": null,
                "photo_tags": [],
                "post_type": "carousel",
                "profile_activity": {
                    "bio_link_clicked": 0,
                    "direction": 0,
                    "email": 0,
                    "other": 0,
                    "text": 0,
                    "total": 0
                },
                "profile_visits": null,
                "reach": 0,
                "replays": null,
                "saved": 0,
                "shares": 0,
                "sum_total_engagement": 0,
                "sum_total_engagements": 0,
                "thruplays": null,
                "timestamp": "2025-02-27T17:15:54+00:00",
                "total_comments": 0,
                "total_engagement": 0,
                "total_impressions": 0,
                "total_likes": 0,
                "total_plays": null,
                "total_time_viewed_sec": null,
                "total_video_views": null,
                "url": "https://www.instagram.com/p/DGlV4j3z_K7/",
                "video_plays_100": null,
                "video_plays_25": null,
                "video_plays_50": null,
                "video_plays_75": null,
                "video_views": null,
                "views": 1
            },
            "instagram_ads": null,
            "instagram_story_frame": null,
            "likeshop": {
                "clicks": 0,
                "links": null,
                "tiktok_clicks": null
            },
            "linkedin": null,
            "meta": {},
            "pinterest": null,
            "predictions": {
                "engagement": 0.0272196
            },
            "source": "INSTAGRAM",
            "source_created_at": "2025-02-27T17:15:54",
            "source_id": "17875851276184969",
            "source_type": "OWNED",
            "threads": null,
            "tiktok": null,
            "twitter": null,
            "type": "CAROUSEL",
            "youtube": null
        }
    ],
    "paging": {
        "count": 1,
        "next": null,
        "previous": null
    }
}

Step 5: Get aggregated metrics

Use this endpoint to pull total engagement data for all posts with a given tag—across brands and platforms. Great for high-level campaign reporting.

GET
https://dashboard.dashsocial.com/reports/data?
		brand_ids=1000,1001,1002
    &start_date=2025-01-01
    &end_date=2025-03-07
    &context_start_date=2025-01-01
    &context_end_date=2025-03-07
    &channels=FACEBOOK
    &metrics=TOTAL_ENGAGEMENTS
    &content_tag_ids=3817,3818

Key query parameters

brand_ids: Comma-separated brand IDs (e.g., 1000,1001)
start_date,end_date: Reporting period.
context_start_date,context_end_date: Comparison period (optional)
channels: Social media channel (e.g., “FACEBOOK”)
metrics: Metric types (e.g., TOTAL_ENGAGEMENTS)
content_tag_ids: Filter by tag IDs. This can be retrieved from Step 2: Retrieving all content tags

Get Started

Reporting

Campaigns

Scheduler

Social Commerce

Social Listening

Community

Integration

MCP Server

Track analytics with the Content Tag API

Use case

Implementation

Before you start

Step 1: Creating a content tag

Key query parameters

Step 2: Retrieving content tags

Key query parameters

Step 3: Auto-tag posts

Step 4: Get post level metrics

Key query parameters

Step 5: Get aggregated metrics

Key query parameters

​Use case

​Implementation

​Before you start

​Step 1: Creating a content tag

​Key query parameters

​Step 2: Retrieving content tags

​Key query parameters

​Step 3: Auto-tag posts

​Step 4: Get post level metrics

​Key query parameters

​Step 5: Get aggregated metrics

​Key query parameters

Use case

Implementation

Before you start

Step 1: Creating a content tag

Key query parameters

Step 2: Retrieving content tags

Key query parameters

Step 3: Auto-tag posts

Step 4: Get post level metrics

Key query parameters

Step 5: Get aggregated metrics

Key query parameters