Retrieving Projects

Listing the Projects that contain your work.

Projects are where your Queries, categorization and configurations are stored. In order to access your data, you'll need to be able to provide the Project that it is stored in.

The following call will list your Projects:

curl -X GET https://api.brandwatch.com/projects/summary

The result will be a list of the Projects that you have access to with the user that you are logged in as:

{
  "resultsTotal": 2,
  "resultsPage": -1,
  "resultsPageSize": -1,
  "results": [
    {
      "id": 398748937,
      "name": "Telecoms research",
      "description": "Mobile phones",
      "billableClientId": 127732,
      "billableClientName": "My company",
      "timezone": "Africa/Abidjan",
      "billableClientIsPitch": false
    },
    {
      "id": 32092327,
      "name": "GPS research",
      "description": "In-car navigation systems",
      "billableClientId": 127732,
      "billableClientName": "My company",
      "timezone": "America/Glace_Bay",
      "billableClientIsPitch": false
    }
  ]
}

As you will see in later calls, you will need to know the id of the Projects that data is stored in so that you can access them.

For more detailed information on your Projects, including links to the Queries within them and their default language, then you can call the following endpoint.

curl -X GET https://api.brandwatch.com/projects

Additionally, if you would like to get information on a specific project, then you can pass the Project id.

curl -X GET https://api.brandwatch.com/projects/32092327