# Fetch mentions from Social networks and the internet

#### 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":

```sh
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:

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

This is an example on Reddit: 

```json
{
    "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:

```json
{
    "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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.buska.io/fetch-mentions-from-social-networks-and-the-internet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.