# 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.