These docs are for v1.0. Click to read the latest docs for v2.0.

Creating Author Lists

Creating a list of Authors in Brandwatch Analytics.

The below call will create a Author List called "Media Handles" in the Project with ID 1998159493. This Author List will be shared with this project only (sharedProjectIds), but can be edited by anyone (shared):

curl -X POST \
  'https://api.brandwatch.com/projects/1998159493/group/author/' \
  -H 'content-type: application/json' \
  -d '{"sharedProjectIds":[1998159493],"name":"Media Handles","authors":["mashable","espn","wsj","reuters","techcrunch","bbcbreaking","huffingtonpost","nytimes","washingtonpost","mediapost","abcnews","skynews","washpost","socialmedia2day","ap","gma","huffpost","cnbc","nprnews","financialtimes","bbcworld","latimes","abcnewslive","wntonight","nbcnews","ft","telegraph","bostonglobe","foxnews","guardian","grist","cnn","abc","recode","afp","usatoday","digiday","ibtimes","npr","bbcnews","thenextweb","theeconomist","buzzfeed","newsweek","associatedpress","cbs","rollingstone","forbes","time","msnbc"],"shared":"public"}'

The response will be similar to the following:

{
    "id": 192667484,
    "name": "Media Handles",
    "shared": "public",
    "sharedProjectIds": [
        1998159493
    ],
    "authors": [
        "mashable",
        "espn",
        "wsj",
        "reuters",
        "techcrunch",
        "bbcbreaking",
        "huffingtonpost",
        "nytimes",
        "washingtonpost",
        "mediapost",
        "abcnews",
        "skynews",
        "washpost",
        "socialmedia2day",
        "ap",
        "gma",
        "huffpost",
        "cnbc",
        "nprnews",
        "financialtimes",
        "bbcworld",
        "latimes",
        "abcnewslive",
        "wntonight",
        "nbcnews",
        "ft",
        "telegraph",
        "bostonglobe",
        "foxnews",
        "guardian",
        "grist",
        "cnn",
        "abc",
        "recode",
        "afp",
        "usatoday",
        "digiday",
        "ibtimes",
        "npr",
        "bbcnews",
        "thenextweb",
        "theeconomist",
        "buzzfeed",
        "newsweek",
        "associatedpress",
        "cbs",
        "rollingstone",
        "forbes",
        "time",
        "msnbc"
    ],
    "userId": 117025679,
    "userName": "[email protected]"
}