Brandwatch Project API

The Project API from Brandwatch — 1 operation(s) for project.

Operations 1

POST /project/{projectId}/group/location Create Location Lists #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/brandwatch-project-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

brandwatch-project-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Consumer Research Project API
  version: '2.0'
servers:
- url: https://api.brandwatch.com
security:
- sec0: []
tags:
- name: Project
paths:
  /project/{projectId}/group/location:
    post:
      summary: Create Location Lists
      description: ''
      operationId: creating-location-lists-1
      parameters:
      - name: projectId
        in: path
        description: your project id
        schema:
          type: integer
          format: int32
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - locations
              properties:
                name:
                  type: string
                  description: name of your location list
                locations:
                  type: array
                  description: an array of locations to add to the list
                  items:
                    type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"id\": 192667493,\n    \"name\": \"Northeastern Cities\",\n    \"shared\": \"public\",\n    \"sharedProjectIds\": [\n        1998159493\n    ],\n    \"locations\": [\n        {\n            \"id\": \"wdc0\",\n            \"name\": \"Washington\",\n            \"type\": \"city\",\n            \"fullName\": \"Washington, District of Columbia, District of Columbia, United States, North America\"\n        },\n        {\n            \"id\": \"phig\",\n            \"name\": \"Philadelphia\",\n            \"type\": \"city\",\n            \"fullName\": \"Philadelphia, Philadelphia County, Pennsylvania, United States, North America\"\n        },\n        {\n            \"id\": \"bos1\",\n            \"name\": \"Boston\",\n            \"type\": \"city\",\n            \"fullName\": \"Boston, Suffolk County, Massachusetts, United States, North America\"\n        },\n        {\n            \"id\": \"bali\",\n            \"name\": \"Baltimore\",\n            \"type\": \"city\",\n            \"fullName\": \"Baltimore, Baltimore County, Maryland, United States, North America\"\n        },\n        {\n            \"id\": \"new8\",\n            \"name\": \"New York City\",\n            \"type\": \"city\",\n            \"fullName\": \"New York City, New York County, New York, United States, North America\"\n        }\n    ],\n    \"userName\": \"example@brandwatch.com\",\n    \"userId\": 117025679\n}"
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    example: 192667493
                    default: 0
                  name:
                    type: string
                    example: Northeastern Cities
                  shared:
                    type: string
                    example: public
                  sharedProjectIds:
                    type: array
                    items:
                      type: integer
                      example: 1998159493
                      default: 0
                  locations:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: wdc0
                        name:
                          type: string
                          example: Washington
                        type:
                          type: string
                          example: city
                        fullName:
                          type: string
                          example: Washington, District of Columbia, District of Columbia, United States, North America
                  userName:
                    type: string
                    example: example@brandwatch.com
                  userId:
                    type: integer
                    example: 117025679
                    default: 0
      deprecated: false
      x-readme:
        code-samples:
        - language: curl
          code: "curl -X POST \\\n  'https://api.brandwatch.com/projects/1998159493/group/location/' \\\n  -H 'content-type: application/json' \\\n  -d '{\"name\":\"Northeastern Cities\",\"locations\":[{\"id\":\"new8\"},{\"id\":\"bos1\"},{\"id\":\"phig\"},{\"id\":\"bali\"},{\"id\":\"wdc0\"}],\"sharedProjectIds\":[1998159493],\"shared\":\"public\"}'"
        samples-languages:
        - curl
      tags:
      - Project
components:
  securitySchemes:
    sec0:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://example.com/oauth2/token
          scopes: {}
x-readme:
  headers: []
  explorer-enabled: true
  proxy-enabled: true
x-readme-fauxas: true