🤩Fetch mentions from Social networks and the internet

This functionality enables you to monitor your brand's presence, track discussions about specific topics, or analyze sentiment across networks.

Making a Request to the /search Endpoint

To request mentions from a specific network, you'll use the /search endpoint. This endpoint expects a POST request with a JSON body containing the network you're interested in and the keyword you're tracking.

Required Parameters

• network: A string indicating the social media network from which to fetch mentions. Valid options are "twitter", "indiehacker", "medium", "pinterest", "internet", "news", "youtube" and "reddit".

• keyword: The keyword or phrase you want to track mentions for.

Example Request

Below is an example of how to make a request using curl to fetch mentions from Twitter for the keyword "Buska":

codecurl -X POST https://api.buska.io/api/routes/search \
     -H "Content-Type: application/json" \
     -H "x-api-key: YOUR_API_KEY_HERE" \
     -d '{"network": "twitter", "keyword": "Buska"}'

Replace YOUR_API_KEY_HERE with your actual API key and adjust the network and keyword as needed for your search.

Response Format

The response will be a JSON object containing the success status, the network queried, and the results:

results {
  "success": true,
  "network": "twitter",
  "results": [
    // Array of mention objects specific to the requested network
  ]
}

This is an example on Reddit:

{
    "success": true,
    "network": "reddit",
    "results": {
        "count": 3,
        "posts": [
            {
                "id": "915616e3-1be7-4eaa-806d-85cb90bdf67f",
                "date": "2024-02-20",
                "content": "How To Monitor Keywords on Reddit?",
                "name": null,
                "link": "https://www.reddit.com/r/SaaS/comments/1avl4b8/how_to_monitor_keywords_on_reddit/",
                "read": false,
                "evaluate": "",
                "sentiment": "neutrale",
                "note": "",
                "language": "en"
            },
            {
                "id": "4edd1470-16b3-409f-ae38-06c4c4a09f76",
                "date": "2023-11-16",
                "content": "I curated a list of 70+ Black Friday deals for startups and indiehackers",
                "name": null,
                "link": "https://www.reddit.com/r/EntrepreneurRideAlong/comments/17whnzg/i_curated_a_list_of_70_black_friday_deals_for/",
                "read": false,
                "evaluate": "",
                "sentiment": "neutrale",
                "note": "",
                "language": "en"
            },
            {
                "id": "f91a43df-9e77-4481-a311-896e1aa3df69",
                "date": "2024-01-10",
                "content": "I lunched today but nobody is visiting",
                "name": null,
                "link": "https://www.reddit.com/r/SaaS/comments/193d9um/i_lunched_today_but_nobody_is_visiting/",
                "read": false,
                "evaluate": "",
                "sentiment": "neutrale",
                "note": "",
                "language": "en"
            }
        ]
    }
}

This is an example on Twitter:

{
    "success": true,
    "network": "twitter",
    "results": {
        "count": 2,
        "posts": [
            {
                "id": "ebb76774-6f4a-41f1-b056-e49b87464ae6",
                "name": "Buska_io",
                "date": "2024-03-19T11:13:50.000Z",
                "content": "A.P. I love it ! ",
                "link": "https://twitter.com/Buska_io/status/1770046013367108093",
                "read": false,
                "evaluate": "",
                "sentiment": "good",
                "note": "",
                "language": "sl"
            },
            {
                "id": "43a5937e-d80a-4feb-ac6b-7a82327d2871",
                "name": "TBerguer",
                "date": "2024-03-19T11:03:39.000Z",
                "content": "I'm currently working on adding an API to \n@Buska_io\n so that you can generate leads directly from your favorite tools, including buska. \n\n#buildinpublic",
                "link": "https://twitter.com/TBerguer/status/1770043450362060983",
                "read": false,
                "evaluate": "",
                "sentiment": "good",
                "note": "",
                "language": "en"
            }
        ]
    }
}

Notes and Restrictions

• Keyword Restrictions: Your request must use a keyword that is included in your team's keyword list unless your team is on a "Custom Plan", which allows for unrestricted keyword searches.

• Rate Limiting: Be mindful of any rate limits that apply to your account to avoid disruptions in service.

• Handling Errors: If the network is unsupported, the keyword is missing, or another error occurs, the API will return an error message detailing the issue.