Creating a Custom Data Source

Create a new custom data source

In order to start using custom data sources in Brandwatch Consumer Research, you must first create a new custom data source. The following call creates a new custom data source named my_data_source:

curl -X POST 'https://api.brandwatch.com/content/sources' \
-H 'authorization: bearer xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxx' \
-H 'Content-Type: application/json' \
-d '{"name": "my_data_source","description":""}'

You can use alphanumeric characters and _ in the name of your new custom data source.

🚧

Project-scoped data sources

By default, a custom data source will be available for use in all of a client's projects. If instead you want a custom data source to be available for only one (or more) project(s), you can provide a projectIds attribute with a list of relevant Project IDs as seen below:

curl -X POST 'https://api.brandwatch.com/content/sources' \
-H 'authorization: bearer xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxx' \
-H 'Content-Type: application/json' \
-d '{"name": "my_data_source","description":"","projectIds": [<projectId>]}'

Here is the JSON response:

{
"name": "my_data_source",
"id": DATA_SOURCE_NUMERIC_ID,
"description": null
}

What’s Next

Retrieve a list of all of your custom data sources: