Use-case guide · Social Media

Monitor brand mentions on X, Reddit, TikTok and Instagram

Search X and TikTok for your brand, watch the subreddits where your customers talk, and pull comments from posts that matter. Get every mention as structured JSON you can store, review and report on.

Brand mentions

“Example Brand” · last 24 hours

37 new
  • X · @example_user

    Just switched to Example Brand trail shoes and my knees thank me already

    186 4

  • Reddit · r/running

    Anyone tried the new Example Brand trail runners? Thinking of getting a pair

    1.2k 212

  • TikTok · @trail.weekends

    Testing Example Brand on a muddy 20k #trailrunning

    48k 930

The challenge

Why this is hard to do yourself

Building it in-house

  • Official social APIs are expensive, rate-limited or closed to new developers.
  • Every platform returns a different format, so combining them takes a lot of glue code.
  • Social sites aggressively block scrapers and change their markup often.
  • Listening tools charge per seat and lock your data inside their dashboards.

With DataGuru

  • One API key covers search, posts, comments and profiles across X, Reddit, TikTok and Instagram.
  • Every response is structured JSON with named fields for text, author and engagement.
  • Blocking, rendering and retries are handled on our side.
  • The data is yours to store, analyse or feed into your own tools.

How it works

Set it up in 4 steps

  1. 1

    Choose what to track

    List your brand names, product names, competitors and the subreddits where your customers talk.

  2. 2

    Collect mentions

    Search X and TikTok and pull new subreddit posts on a schedule.

  3. 3

    Go deeper

    For posts that matter, fetch the Reddit or Instagram comments to see the full conversation.

  4. 4

    Review and report

    Store mentions, remove duplicates by ID and send the important ones to your team.

Example

Collect brand mentions from X and Reddit in Python

This script searches X for each brand term and reads the latest posts from a subreddit, then keeps the ones that mention you. Store the IDs you have seen so each mention is only handled once.

import requests

BASE = "https://api.dataguru.cc/api/v1"
HEADERS = {"Authorization": "Api-Key YOUR_API_KEY"}

BRAND_TERMS = ["example brand", "@examplebrand"]
SUBREDDIT = "https://www.reddit.com/r/running/"


def call(path, payload):
    res = requests.post(f"{BASE}/{path}", headers=HEADERS, json=payload, timeout=60)
    res.raise_for_status()
    return res.json()


mentions = []

for term in BRAND_TERMS:
    data = call("x/search", {"query": term, "limit": "20"})
    for post in data["x_search"]["results"]:
        mentions.append(("x", post["post_url"], post["text"], post["like_count"]))

posts = call("reddit/post", {"url": SUBREDDIT, "limit": "25"})["posts_and_subreddits"]
for post in posts if isinstance(posts, list) else [posts]:
    text = f"{post['title']} {post.get('self_text_markdown') or ''}".lower()
    if any(term.lower() in text for term in BRAND_TERMS):
        mentions.append(("reddit", post["post_url"], post["title"], post["upvote_score"]))

for platform, url, text, score in mentions:
    print(platform, score, url, text[:80])
Response · 200 OK
{
  "x_search": {
    "query": "example brand",
    "total_results": 20,
    "results": [
      {
        "post_id": "1849200000000000001",
        "post_url": "https://x.com/example_user/status/1849200000000000001",
        "author_username": "example_user",
        "text": "Just switched to Example Brand trail shoes and my knees thank me already #running",
        "embedded_hashtags": [
          "running"
        ],
        "create_time": "2026-10-26T09:14:00Z",
        "reply_count": 4,
        "retweet_count": 12,
        "like_count": 186,
        "view_count": 9420
      }
    ]
  }
}

Example response trimmed to the fields used above. Values are illustrative.

What you get

What you can do with the data

Brand mention alerts

Send new posts that mention you to Slack or email so your team can reply quickly.

Competitor tracking

Run the same searches for competitor names and compare how often and where they come up.

Customer feedback

Read Reddit threads and comments to find complaints, questions and feature requests in customers' own words.

Campaign reporting

Track like_count, view_count and comment counts on campaign hashtags over time.

Creator discovery

Find TikTok videos about your category and the creators getting the most engagement.

Your own analytics

Store every mention in your warehouse and analyse it with your own tools or models.

What it costs

Searching X for 10 brand terms twice a day:

$0.60 / month

600 requests × $0.001 / req on the X (Twitter) Search API. No subscription or minimum; you only pay for successful requests.

See all pricing

Who it's for

Built for teams like yours

  • Brand and social teams
  • Marketing agencies
  • Product managers
  • Customer support teams
  • PR teams
  • Market researchers

FAQ

Frequently asked questions

X (search, profiles and trends), Reddit (posts and comments), TikTok (search, posts, profiles and shop) and Instagram (profiles, posts and comments). Each has its own API.

Start building today

Create an account and get $1.00 of free balance to try every API in this guide. No credit card required.