Talkwalker Streaming API

The Streaming API API from Talkwalker — 4 operation(s) for streaming api.

Operations 8

GET /api/v3/stream/info List of streams and collectors
GET /api/v3/stream/p/{project_id}/results Listen on a specific project
POST /api/v3/stream/p/{project_id}/results Listen on a specific project - POST method
DELETE /api/v3/stream/s/{stream_id} Delete a stream
GET /api/v3/stream/s/{stream_id} Get stream definition
PUT /api/v3/stream/s/{stream_id} Create or replace a stream
GET /api/v3/stream/s/{stream_id}/results Listen a stream
POST /api/v3/stream/s/{stream_id}/results Listen a stream - POST method

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/talkwalker-streaming-api-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

talkwalker-streaming-api-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Talkwalker Streaming Streaming API
  description: Talkwalker Advanced API
  version: 0.0.1
  contact:
    email: client-api@talkwalker.com
    name: Client-API
servers:
- description: Production environment server
  url: https://api.talkwalker.com
security:
- apikeyAuth: []
tags:
- name: Streaming API
paths:
  /api/v3/stream/info:
    get:
      description: Get the list of streams and collectors in your API subscription
      responses:
        '200':
          content:
            application/json:
              example:
                request: GET /api/v3/stream/info?access_token=abcd_1234_abcd
                request_id: '#r8ubtbnbrcz7#'
                result_stream:
                  collectors:
                  - collector_id: collector_1
                    state: ACTIVE
                  streams:
                  - enabled: true
                    stream_id: stream_1
                status_code: '0'
                status_message: OK
              schema:
                type: object
          description: OK
      summary: List of streams and collectors
      tags:
      - Streaming API
  /api/v3/stream/p/{project_id}/results:
    get:
      parameters:
      - description: The query to search for
        example: electric AND car
        in: query
        name: q
        schema:
          type: string
      - description: 'Stops the stream after the given number of hits.

          If not set, it never stops.'
        example: '3'
        in: query
        name: max_hits
        schema:
          type: integer
      - description: One or more topics or panels that are defined in the Talkwalker project.
        in: query
        name: topic
        schema:
          type: string
      - description: One or more datasets that are defined in the Talkwalker Customer Intelligence project.
        in: query
        name: dataset
        schema:
          type: string
      - description: One or more custom filters that are defined in the Talkwalker project. The combination logic is the operator `AND` between the IDs if they are from different groups.
        in: query
        name: filter
        schema:
          type: string
      - description: One or more source panels that are defined in the Talkwalker project.
        in: query
        name: panel
        schema:
          type: string
      - example: a1ab1abc-a123-123a-123a-abcd12ab1a12
        in: path
        name: project_id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            text/plain:
              example: "{\n    \"chunk_type\": \"CT_CONTROL\",\n    \"chunk_control\": {\n        \"stream\": [\n            {\n                \"id\": \"\",\n                \"status\": \"active\"\n            }\n        ],\n        \"connection_id\": \"#r8vsbc480czh#\"\n    }\n}\n\n\n{\n    \"chunk_type\": \"CT_RESULT\",\n    \"chunk_result\": {\n        \"data\": {\n            \"data\": {\n                \"url\": \"https://www.carstuff.com.tw/car-news/item/35897-2022-world-car-of-the-year.html\",\n                \"matched_profile\": [\n                    \"kpnzh6u5_5imm9mo4kozc\"\n                ],\n                \"indexed\": 1647506787864,\n                \"search_indexed\": 1647506802583,\n                \"published\": 1647501074000,\n                \"title\": \"2022 World Car Of The Year 世界年度風雲車前三強出爐、首次全由電動車爭奪大獎! - CarStuff 人車事\",\n                \"content\": \"2022 年World Car of The Year 世界年度風雲車決選即將到來,最終獲獎者將在今年 4 月紐約車展之前公佈,不過在此之前最終決選六大項目車款已經公佈,其中 World Car of The Year 最大獎全部都是電動車,這也是 2005 年首次推出此項目以來頭一次! 今年的競爭者是 Ford Mustang Mach-E、KIA EV6和 Hyundai IONIQ 5。當然有人可能會說 EV6 和 IONIQ 5...\",\n                \"title_snippet\": \"2022 World <b>Car</b> Of The Year 世界年度風雲車前三強出爐、首次全由電動車爭奪大獎! - CarStuff 人車事\",\n                \"content_snippet\": \"...<b>Car</b> Opel Mokka Toyota Yaris Cross Volkswagen Taigun World Luxury <b>Car</b> <b>BMW</b> iX Genesis GV70 Mercedes-Benz EQS World Performance <b>Car</b> Audi E-Tron GT <b>BMW</b> M3/M4 Toyota GR 86 / Subaru BRZ World <b>Car</b> Design Audi E-Tron GT Hyundai Ioniq 5 Kia EV6 要獲得 World <b>Car</b>...\",\n                \"root_url\": \"https://www.carstuff.com.tw/\",\n                \"domain_url\": \"http://carstuff.com.tw/\",\n                \"host_url\": \"http://www.carstuff.com.tw/\",\n                \"parent_url\": \"https://www.carstuff.com.tw/car-news/item/35897-2022-world-car-of-the-year.html\",\n                \"lang\": \"zh_tw\",\n                \"porn_level\": 0,\n                \"fluency_level\": 0,\n                \"sentiment\": 0,\n                \"source_type\": [\n                    \"ONLINENEWS\",\n                    \"ONLINENEWS_OTHER\"\n                ],\n                \"post_type\": [\n                    \"TEXT\"\n                ],\n                \"noise_level\": 80,\n                \"noise_category\": \"promotions\",\n                \"tokens_title\": [\n                    \"全由\",\n                    \"carstuff\",\n                    \"year\",\n                    \"三強\",\n                    \"風\",\n                    \"電動\",\n                    \"2022\",\n                    \"車\",\n                    \"車\",\n                    \"車\"\n                ],\n                \"tokens_content\": [\n                    \"會\",\n                    \"year\",\n                    \"year\",\n                    \"year\",\n                    \"者\",\n                    \"者\",\n                    \"項\",\n                    \"項\",\n                    \"項\",\n                    \"將\"\n                ],\n                \"images\": [\n                    {\n                        \"url\": \"https://www.carstuff.com.tw/media/k2/items/cache/003e564f1501d1f6fce2b3069590d0c7_XL.jpg\",\n                        \"width\": 1024,\n                        \"height\": 683\n                    }\n                ],\n                \"tags_internal\": [\n                    \"hasImage\",\n                    \"containsImage\"\n                ],\n                \"source_extended_attributes\": {\n                    \"alexa_pageviews\": 820000,\n                    \"alexa_unique_visitors\": 341666\n                },\n                \"extra_author_attributes\": {\n                    \"id\": \"ex:www.carstuff.com.tw-653980078\",\n                    \"name\": \"jason hu\",\n                    \"gender\": \"MALE\"\n                },\n                \"extra_source_attributes\": {\n                    \"world_data\": {\n                        \"continent\": \"Asia\",\n                        \"country\": \"Taiwan\",\n                        \"region\": \"Taipei City\",\n                        \"city\": \"Taipei\",\n                        \"longitude\": 121.5692138671875,\n                        \"latitude\": 25.03509521484375,\n                        \"country_code\": \"tw\",\n                        \"resolution\": \"COUNTRY\"\n                    },\n                    \"id\": \"ex:www.carstuff.com.tw\",\n                    \"name\": \"www.carstuff.com.tw\"\n                },\n                \"matched\": {\n                    \"appearance\": \"NEW\"\n                },\n                \"word_count\": 480,\n                \"docscore\": {\n                    \"test_score\": 1.0\n                }\n            }\n        }\n    }\n}\n\n\n\n{\n    \"chunk_type\": \"CT_RESULT\",\n    \"chunk_result\": {\n        \"data\": {\n            \"data\": {\n                \"url\": \"https://www.carstuff.com.tw/car-news/item/35897-2022-world-car-of-the-year.html\",\n                \"matched_profile\": [\n                    \"kpnzh6u5_5imm9mo4kozc\"\n                ],\n                \"indexed\": 1647506787864,\n                \"search_indexed\": 1647506798692,\n                \"published\": 1647501074000,\n                \"title\": \"2022 World Car Of The Year 世界年度風雲車前三強出爐、首次全由電動車爭奪大獎! - CarStuff 人車事\",\n                \"content\": \"2022 年World Car of The Year 世界年度風雲車決選即將到來,最終獲獎者將在今年 4 月紐約車展之前公佈,不過在此之前最終決選六大項目車款已經公佈,其中 World Car of The Year 最大獎全部都是電動車,這也是 2005 年首次推出此項目以來頭一次! 今年的競爭者是 Ford Mustang Mach-E、KIA EV6和 Hyundai IONIQ 5。當然有人可能會說 EV6 和 IONIQ 5...\",\n                \"title_snippet\": \"2022 World <b>Car</b> Of The Year 世界年度風雲車前三強出爐、首次全由電動車爭奪大獎! - CarStuff 人車事\",\n                \"content_snippet\": \"...<b>Car</b> Opel Mokka Toyota Yaris Cross Volkswagen Taigun World Luxury <b>Car</b> <b>BMW</b> iX Genesis GV70 Mercedes-Benz EQS World Performance <b>Car</b> Audi E-Tron GT <b>BMW</b> M3/M4 Toyota GR 86 / Subaru BRZ World <b>Car</b> Design Audi E-Tron GT Hyundai Ioniq 5 Kia EV6 要獲得 World <b>Car</b>...\",\n                \"root_url\": \"https://www.carstuff.com.tw/\",\n                \"domain_url\": \"http://carstuff.com.tw/\",\n                \"host_url\": \"http://www.carstuff.com.tw/\",\n                \"parent_url\": \"https://www.carstuff.com.tw/car-news/item/35897-2022-world-car-of-the-year.html\",\n                \"lang\": \"zh_tw\",\n                \"porn_level\": 0,\n                \"fluency_level\": 0,\n                \"DEPRECATED_spam_level\": 0,\n                \"sentiment\": 0,\n                \"source_type\": [\n                    \"ONLINENEWS\",\n                    \"ONLINENEWS_OTHER\"\n                ],\n                \"post_type\": [\n                    \"TEXT\"\n                ],\n                \"noise_level\": 80,\n                \"noise_category\": \"promotions\",\n                \"tokens_title\": [\n                    \"全由\",\n                    \"carstuff\",\n                    \"year\",\n                    \"三強\",\n                    \"風\",\n                    \"電動\",\n                    \"2022\",\n                    \"車\",\n                    \"車\",\n                    \"車\"\n                ],\n                \"tokens_content\": [\n                    \"會\",\n                    \"year\",\n                    \"year\",\n                    \"year\",\n                    \"者\",\n                    \"者\",\n                    \"項\",\n                    \"項\",\n                    \"項\",\n                    \"將\"\n                ],\n                \"images\": [\n                    {\n                        \"url\": \"https://www.carstuff.com.tw/media/k2/items/cache/003e564f1501d1f6fce2b3069590d0c7_XL.jpg\"\n                    }\n                ],\n                \"tags_internal\": [\n                    \"containsImage\",\n                    \"hasImage\"\n                ],\n                \"source_extended_attributes\": {\n                    \"alexa_pageviews\": 820000,\n                    \"alexa_unique_visitors\": 341666\n                },\n                \"extra_author_attributes\": {\n                    \"id\": \"ex:www.carstuff.com.tw-653980078\",\n                    \"name\": \"jason hu\",\n                    \"gender\": \"MALE\"\n                },\n                \"extra_source_attributes\": {\n                    \"world_data\": {\n                        \"continent\": \"Asia\",\n                        \"country\": \"Taiwan\",\n                        \"region\": \"Taipei City\",\n                        \"city\": \"Taipei\",\n                        \"longitude\": 121.5692138671875,\n                        \"latitude\": 25.03509521484375,\n                        \"country_code\": \"tw\",\n                        \"resolution\": \"COUNTRY\"\n                    },\n                    \"id\": \"ex:www.carstuff.com.tw\",\n                    \"name\": \"www.carstuff.com.tw\"\n                },\n                \"engagement\": 0,\n                \"reach\": 341666,\n                \"matched\": {\n                    \"appearance\": \"UPDATED\"\n                },\n                \"word_count\": 480,\n                \"docscore\": {\n                    \"test_score\": 1.0\n                }\n            }\n        }\n    }\n}\n\n\n\n\n\n\n\n{\n    \"chunk_type\": \"CT_RESULT\",\n    \"chunk_result\": {\n        \"data\": {\n            \"data\": {\n                \"url\": \"https://hr.economictimes.indiatimes.com/news/workplace-4-0/workplace-ikigai/why-tesla-fired-an-employee-over-youtube-review/90286601\",\n                \"matched_profile\": [\n                    \"kpnutesu_5imm9mo4lbsj\"\n                ],\n                \"indexed\": 1647506889521,\n                \"search_indexed\": 1647506922562,\n                \"published\": 1647502562990,\n                \"title\": \"Why Tesla fired an employee over YouTube review\",\n                \"content\": \"San Francisco: Elon Musk-run Tesla has fired an employee who reviewed the electric car-maker's full self-driving (FSD) beta software on his YouTube channel.\\n\\nJohn Bernal posted the video that showed his Tesla hitting a b...\",\n                \"title_snippet\": \"Why <b>Tesla</b> fired an employee over YouTube review\",\n                \"content_snippet\": \"...Francisco: Elon Musk-run <b>Tesla</b> has fired an employee who reviewed the <b>electric</b> <b>car</b>-maker's full self-driving (FSD) beta ... investigations into <b>Tesla</b>'s autopilot system.\\n\\n<b>Tesla</b> FSD beta aims to enable <b>Tesla</b> vehicles to virtually drive themselves...\",\n                \"root_url\": \"https://hr.economictimes.indiatimes.com/\",\n                \"domain_url\": \"http://indiatimes.com/\",\n                \"host_url\": \"http://hr.economictimes.indiatimes.com/\",\n                \"parent_url\": \"https://hr.economictimes.indiatimes.com/news/workplace-4-0/workplace-ikigai/why-tesla-fired-an-employee-over-youtube-review/90286601\",\n                \"lang\": \"en\",\n                \"porn_level\": 0,\n                \"fluency_level\": 100,\n                \"sentiment\": -5,\n                \"source_type\": [\n                    \"ONLINENEWS\",\n                    \"ONLINENEWS_NEWSPAPER\"\n                ],\n                \"post_type\": [\n                    \"TEXT\"\n                ],\n                \"tokens_title\": [\n                    \"Why Tesla fired\",\n                    \"over YouTube review\",\n                    \"Why Tesla\",\n                    \"Why Tesla\",\n                    \"over YouTube\",\n                    \"Tesla fired\",\n                    \"YouTube review\",\n                    \"Tesla\",\n                    \"Tesla\",\n                    \"YouTube\"\n                ],\n                \"tokens_content\": [\n                    \"Elon Musk-run Tesla\",\n                    \"Elon Musk-run Tesla\",\n                    \"National Highway Traffic\",\n                    \"Highway Traffic Safety\",\n                    \"Traffic Safety Administration\",\n                    \"Senators Richard Blumenthal\",\n                    \"Musk-run Tesla\",\n                    \"Musk-run Tesla\",\n                    \"Elon Musk-run\",\n                    \"Elon Musk-run\"\n                ],\n                \"source_extended_attributes\": {\n                    \"alexa_pageviews\": 0,\n                    \"alexa_unique_visitors\": 0\n                },\n                \"extra_author_attributes\": {\n                    \"id\": \"ex:hr.economictimes.indiatimes.com-2094486706\",\n                    \"name\": \"workplace ikigai\",\n                    \"gender\": \"UNKNOWN\"\n                },\n                \"extra_source_attributes\": {\n                    \"world_data\": {\n                        \"continent\": \"Asia\",\n                        \"country\": \"India\",\n                        \"region\": \"Delhi\",\n                        \"city\": \"New Delhi\",\n                        \"longitude\": 77.1954345703125,\n                        \"latitude\": 28.60015869140625,\n                        \"country_code\": \"in\",\n                        \"resolution\": \"COUNTRY\"\n                    },\n                    \"id\": \"ex:hr.economictimes.indiatimes.com\",\n                    \"name\": \"hr.economictimes.indiatimes.com\"\n                },\n                \"entity_url\": [\n                    {\n                        \"url\": \"https://hr.economictimes.indiatimes.com/tag/tesla\"\n                    },\n                    {\n                        \"url\": \"https://hr.economictimes.indiatimes.com/tag/john\"\n                    },\n                    {\n                        \"url\": \"https://hr.economictimes.indiatimes.com/tag/employees\"\n                    },\n                    {\n                        \"url\": \"https://img.etb2bimg.com/files/cp/upload-1626354070-ethr-default-thumb-image.jpg\"\n                    }\n                ],\n                \"matched\": {\n                    \"appearance\": \"NEW\"\n                },\n                \"word_count\": 456,\n                \"docscore\": {\n                    \"test_score\": 1.0\n                }\n            }\n        }\n    }\n}\n\n\n\n\n\n\n{\n    \"chunk_type\": \"CT_RESULT\",\n    \"chunk_result\": {\n        \"data\": {\n            \"data\": {\n                \"url\": \"https://capitalstreetfx.in/markets-news/market-outlook-bonds/tesla-delays-over-1-billion-bond-sale-backed-by-auto-leases/\",\n                \"indexed\": 1647506950948,\n                \"search_indexed\": 1647506952191,\n                \"published\": 1647502640000,\n                \"title\": \"Tesla delays over $1 billion bond sale backed by auto leases\",\n                \"content\": \"Electric-car maker Tesla Inc delayed a more than $1 billion offering of bonds backed by leases on its electric vehicles, Bloomberg News reported on Wednesday.\\n\\nThe move follows “buy now, pay later” lender Affirm Holdings Inc’s announcement earlier this week to delay its bond offering.\\n\\nBond sales in the United States have ground to a halt after Russia’s invasion of Ukraine, adding to challenges the funding market is already facing as global central banks tighten monetary policies due to surging inflation.\\n\\nBankers for Tesla had already placed a significant portion of the bonds with fund managers before marketing was halted, the report said, citing people familiar with matter.\\n\\nTesla did not immediately respond to a Reuters’ request for comment.\\n\\nThe post Tesla delays over $1 billion bond sale backed by auto leases appeared first on Capital Street Fx - Online Stock/Share Market Trading & Low Brokerage.\",\n                \"title_snippet\": \"<b>Tesla</b> delays over $1 billion bond sale backed by auto leases\",\n                \"content_snippet\": \"<b>Electric</b>-<b>car</b> maker <b>Tesla</b> Inc delayed a more than $1 billion offering of bonds backed by leases on its <b>electric</b> vehicles ... with matter.\\n\\n<b>Tesla</b> did not immediately respond to a Reuters’ request for comment.\\n\\nThe post <b>Tesla</b> delays over $1 billion...\",\n                \"root_url\": \"https://capitalstreetfx.in/\",\n                \"domain_url\": \"http://capitalstreetfx.in/\",\n                \"host_url\": \"http://capitalstreetfx.in/\",\n                \"parent_url\": \"https://capitalstreetfx.in/markets-news/market-outlook-bonds/tesla-delays-over-1-billion-bond-sale-backed-by-auto-leases/\",\n                \"lang\": \"en\",\n                \"porn_level\": 0,\n                \"fluency_level\": 100,\n                \"DEPRECATED_spam_level\": 0,\n                \"sentiment\": 0,\n                \"source_type\": [\n                    \"BLOG\",\n                    \"BLOG_OTHER\"\n                ],\n                \"post_type\": [\n                    \"TEXT\"\n                ],\n                \"noise_level\": 98,\n                \"noise_category\": \"financial_news\",\n                \"tokens_title\": [\n                    \"sale backed\",\n                    \"auto leases\",\n                    \"Tesla delays\",\n                    \"billion bond\",\n                    \"Tesla\",\n                    \"Tesla\",\n                    \"leases\",\n                    \"auto\",\n                    \"billion\",\n                    \"delays\"\n                ],\n                \"tokens_content\": [\n                    \"Share Market Trading\",\n                    \"Share Market\",\n                    \"Online Stock\",\n                    \"Market Trading\",\n                    \"Capital Street\",\n                    \"Low Brokerage\",\n                    \"Affirm Holdings\",\n                    \"Bloomberg News\",\n                    \"Tesla\",\n                    \"Tesla\"\n                ],\n                \"images\": [\n                    {\n                        \"url\": \"https://capitalstreetfx.in/wp-content/uploads/2022/03/tesla-delays-over-1-billion-bond-sale-backed-by-auto-leases.jpg\"\n                    }\n                ],\n                \"tags_internal\": [\n                    \"containsImage\",\n                    \"hasImage\"\n                ],\n                \"source_extended_attributes\": {\n                    \"alexa_pageviews\": 500000,\n                    \"alexa_unique_visitors\": 79365\n                },\n                \"extra_author_attributes\": {\n                    \"id\": \"ex:capitalstreetfx.in-3063106\",\n                    \"name\": \"CSFX\",\n                    \"gender\": \"UNKNOWN\"\n                },\n                \"extra_source_attributes\": {\n                    \"world_data\": {\n                        \"continent\": \"Asia\",\n                        \"country\": \"India\",\n                        \"region\": \"Delhi\",\n                        \"city\": \"New Delhi\",\n                        \"longitude\": 77.1954345703125,\n                        \"latitude\": 28.60015869140625,\n                        \"country_code\": \"in\",\n                        \"resolution\": \"COUNTRY\"\n                    },\n                    \"id\": \"ex:capitalstreetfx.in\",\n                    \"name\": \"capitalstreetfx.in\"\n                },\n                \"engagement\": 0,\n                \"reach\": 79365,\n                \"entity_url\": [\n                    {\n                        \"url\": \"https://img.etimg.com/thumb/msid-90286764\"\n                    },\n                    {\n                        \"url\": \"https://economictimes.indiatimes.com/topic/tesla\"\n                    },\n                    {\n                        \"url\": \"https://capitalstreetfx.in/wp-content/uploads/2022/03/tesla-delays-over-1-billion-bond-sale-backed-by-auto-leases-150x150.jpg\"\n                    },\n                    {\n                        \"url\": \"https://capitalstreetfx.in/wp-content/uploads/2022/03/tesla-delays-over-1-billion-bond-sale-backed-by-auto-leases-500x500.jpg\"\n                    },\n                    {\n                        \"url\": \"https://economictimes.indiatimes.com/topic/bloomberg\"\n                    },\n                    {\n                        \"url\": \"https://capitalstreetfx.in/wp-content/uploads/2022/03/tesla-delays-over-1-billion-bond-sale-backed-by-auto-leases-100x100.jpg\"\n                    },\n                    {\n                        \"url\": \"https://capitalstreetfx.in/markets-news/market-outlook-bonds/tesla-delays-over-1-billion-bond-sale-backed-by-auto-leases/\"\n                    },\n                    {\n                        \"url\": \"https://economictimes.indiatimes.com/topic/bond-sales\"\n                    },\n                    {\n                        \"url\": \"https://capitalstreetfx.in\"\n                    }\n                ],\n                \"matched\": {\n                    \"appearance\": \"NEW\"\n                },\n                \"word_count\": 146,\n                \"docscore\": {\n                    \"test_score\": 1.0\n                }\n            }\n        }\n    }\n}\n{\n    \"chunk_type\": \"CT_CONTROL\",\n    \"chunk_control\": {\n        \"stream\": [\n            {\n                \"id\": \"\",\n                \"status\": \"active\"\n            }\n        ],\n        \"connection_id\": \"#r8vsbc480czh#\"\n    }\n}"
              schema:
                type: string
          description: OK
      summary: Listen on a specific project
      tags:
      - Streaming API
    post:
      parameters:
      - example: '3'
        in: query
        name: max_hits
        schema:
          type: integer
      - description: One or more topics or panels that are defined in the Talkwalker project.
        in: query
        name: topic
        schema:
          type: string
      - description: One or more datasets that are defined in the Talkwalker Customer Intelligence project.
        in: query
        name: dataset
        schema:
          type: string
      - description: One or more custom filters that are defined in the Talkwalker project. The combination logic is the operator `AND` between the IDs if they are from different groups.
        in: query
        name: filter
        schema:
          type: string
      - description: One or more source panels that are defined in the Talkwalker project.
        in: query
        name: panel
        schema:
          type: string
      - example: a1ab1abc-a123-123a-123a-abcd12ab1a12
        in: path
        name: project_id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              example:
                q: electric AND car
              type: object
      responses:
        '200':
          content:
            text/plain:
              example: "{\n    \"chunk_type\": \"CT_CONTROL\",\n    \"chunk_control\": {\n        \"stream\": [\n            {\n                \"id\": \"\",\n                \"status\": \"active\"\n            }\n        ],\n        \"connection_id\": \"#r8vsbc480czh#\"\n    }\n}\n\n\n{\n    \"chunk_type\": \"CT_RESULT\",\n    \"chunk_result\": {\n        \"data\": {\n            \"data\": {\n                \"url\": \"https://www.carstuff.com.tw/car-news/item/35897-2022-world-car-of-the-year.html\",\n                \"matched_profile\": [\n                    \"kpnzh6u5_5imm9mo4kozc\"\n                ],\n                \"indexed\": 1647506787864,\n                \"search_indexed\": 1647506802583,\n                \"published\": 1647501074000,\n                \"title\": \"2022 World Car Of The Year 世界年度風雲車前三強出爐、首次全由電動車爭奪大獎! - CarStuff 人車事\",\n                \"content\": \"2022 年World Car of The Year 世界年度風雲車決選即將到來,最終獲獎者將在今年 4 月紐約車展之前公佈,不過在此之前最終決選六大項目車款已經公佈,其中 World Car of The Year 最大獎全部都是電動車,這也是 2005 年首次推出此項目以來頭一次! 今年的競爭者是 Ford Mustang Mach-E、KIA EV6和 Hyundai IONIQ 5。當然有人可能會說 EV6 和 IONIQ 5...\",\n                \"title_snippet\": \"2022 World <b>Car</b> Of The Year 世界年度風雲車前三強出爐、首次全由電動車爭奪大獎! - CarStuff 人車事\",\n                \"content_snippet\": \"...<b>Car</b> Opel Mokka Toyota Yaris Cross Volkswagen Taigun World Luxury <b>Car</b> <b>BMW</b> iX Genesis GV70 Mercedes-Benz EQS World Performance <b>Car</b> Audi E-Tron GT <b>BMW</b> M3/M4 Toyota GR 86 / Subaru BRZ World <b>Car</b> Design Audi E-Tron GT Hyundai Ioniq 5 Kia EV6 要獲得 World <b>Car</b>...\",\n                \"root_url\": \"https://www.carstuff.com.tw/\",\n                \"domain_url\": \"http://carstuff.com.tw/\",\n                \"host_url\": \"http://www.carstuff.com.tw/\",\n                \"parent_url\": \"https://www.carstuff.com.tw/car-news/item/35897-2022-world-car-of-the-year.html\",\n                \"lang\": \"zh_tw\",\n                \"porn_level\": 0,\n                \"fluency_level\": 0,\n                \"sentiment\": 0,\n                \"source_type\": [\n                    \"ONLINENEWS\",\n                    \"ONLINENEWS_OTHER\"\n                ],\n                \"post_type\": [\n                    \"TEXT\"\n                ],\n                \"noise_level\": 80,\n                \"noise_category\": \"promotions\",\n                \"tokens_title\": [\n                    \"全由\",\n                    \"carstuff\",\n                    \"year\",\n                    \"三強\",\n                    \"風\",\n                    \"電動\",\n                    \"2022\",\n                    \"車\",\n                    \"車\",\n                    \"車\"\n                ],\n                \"tokens_content\": [\n                    \"會\",\n                    \"year\",\n                    \"year\",\n                    \"year\",\n                    \"者\",\n                    \"者\",\n                    \"項\",\n                    \"項\",\n                    \"項\",\n                    \"將\"\n                ],\n                \"images\": [\n                    {\n                        \"url\": \"https://www.carstuff.com.tw/media/k2/items/cache/003e564f1501d1f6fce2b3069590d0c7_XL.jpg\",\n                        \"width\": 1024,\n                        \"height\": 683\n                    }\n                ],\n                \"tags_internal\": [\n                    \"hasImage\",\n                    \"containsImage\"\n                ],\n                \"source_extended_attributes\": {\n                    \"alexa_pageviews\": 820000,\n                    \"alexa_unique_visitors\": 341666\n                },\n                \"extra_author_attributes\": {\n                    \"id\": \"ex:www.carstuff.com.tw-653980078\",\n                    \"name\": \"jason hu\",\n                    \"gender\": \"MALE\"\n                },\n                \"extra_source_attributes\": {\n                    \"world_data\": {\n                        \"continent\": \"Asia\",\n                        \"country\": \"Taiwan\",\n                        \"region\": \"Taipei City\",\n                        \"city\": \"Taipei\",\n                        \"longitude\": 121.5692138671875,\n                        \"latitude\": 25.03509521484375,\n                        \"country_code\": \"tw\",\n                        \"resolution\": \"COUNTRY\"\n                    },\n                    \"id\": \"ex:www.carstuff.com.tw\",\n                    \"name\": \"www.carstuff.com.tw\"\n                },\n                \"matched\": {\n                    \"appearance\": \"NEW\"\n                },\n                \"word_count\": 480,\n                \"docscore\": {\n                    \"test_score\": 1.0\n                }\n            }\n        }\n    }\n}\n\n\n\n{\n    \"chunk_type\": \"CT_RESULT\",\n    \"chunk_result\": {\n        \"data\": {\n            \"data\": {\n                \"url\": \"https://www.carstuff.com.tw/car-news/item/35897-2022-world-car-of-the-year.html\",\n                \"matched_profile\": [\n                    \"kpnzh6u5_5imm9mo4kozc\"\n                ],\n                \"indexed\": 1647506787864,\n                \"search_indexed\": 1647506798692,\n                \"published\": 1647501074000,\n                \"title\": \"2022 World Car Of The Year 世界年度風雲車前三強出爐、首次全由電動車爭奪大獎! - CarStuff 人車事\",\n                \"content\": \"2022 年World Car of The Year 世界年度風雲車決選即將到來,最終獲獎者將在今年 4 月紐約車展之前公佈,不過在此之前最終決選六大項目車款已經公佈,其中 World Car of The Year 最大獎全部都是電動車,這也是 2005 年首次推出此項目以來頭一次! 今年的競爭者是 Ford Mustang Mach-E、KIA EV6和 Hyundai IONIQ 5。當然有人可能會說 EV6 和 IONIQ 5...\",\n                \"title_snippet\": \"2022 World <b>Ca

# --- truncated at 32 KB (157 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/talkwalker/refs/heads/main/openapi/talkwalker-streaming-api-api-openapi.yml