{ "item": [ { "name": "health", "description": "", "item": [ { "id": "164aac03-9c50-4aa5-963c-1537989eda14", "name": "Health check", "request": { "name": "Health check", "description": { "content": "Returns system health status including database connectivity, listener status, and WebSocket connections.", "type": "text/plain" }, "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "6db38f67-b69f-4d0f-8746-0c2827a9316a", "name": "System healthy", "originalRequest": { "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"db\": \"\",\n \"listeners\": \"\",\n \"ws_connections\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "v1", "description": "", "item": [ { "name": "ws", "description": "", "item": [ { "id": "40e50c19-6624-443a-82ff-d212d2f966f2", "name": "WebSocket streaming", "request": { "name": "WebSocket streaming", "description": { "content": "Real-time tweet streaming via WebSocket. Connect with your API key as a query parameter. Receives JSON messages for each detected tweet in real-time.", "type": "text/plain" }, "url": { "path": [ "v1", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your API key", "type": "text/plain" }, "key": "key", "value": "" } ], "variable": [] }, "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "022f65a7-3b20-4ba6-9c36-9aff94cf224b", "name": "WebSocket upgrade successful", "originalRequest": { "url": { "path": [ "v1", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your API key", "type": "text/plain" }, "key": "key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Switching Protocols", "code": 101, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ef1afa2b-1f7d-48ac-9a55-9cb2c7ec2686", "name": "Invalid API key or free tier", "originalRequest": { "url": { "path": [ "v1", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your API key", "type": "text/plain" }, "key": "key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "accounts", "description": "", "item": [ { "id": "010e4758-dd25-486f-9afe-acd4d8cec75a", "name": "List tracked accounts", "request": { "name": "List tracked accounts", "description": { "content": "Returns all Twitter accounts being monitored for the authenticated user.", "type": "text/plain" }, "url": { "path": [ "v1", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ef6fe35a-2d2a-4e72-aee8-c992955e9e8d", "name": "List of tracked accounts", "originalRequest": { "url": { "path": [ "v1", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"handle\": \"\",\n \"twitter_id\": \"\",\n \"listener_id\": \"\",\n \"muted\": \"\",\n \"keywords_include\": [\n \"\",\n \"\"\n ],\n \"keywords_exclude\": [\n \"\",\n \"\"\n ],\n \"added_at\": \"\"\n },\n {\n \"handle\": \"\",\n \"twitter_id\": \"\",\n \"listener_id\": \"\",\n \"muted\": \"\",\n \"keywords_include\": [\n \"\",\n \"\"\n ],\n \"keywords_exclude\": [\n \"\",\n \"\"\n ],\n \"added_at\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "35db07a7-3517-4d0b-97f0-7f5e217034b5", "name": "Add tracked accounts", "request": { "name": "Add tracked accounts", "description": { "content": "Add up to 25 Twitter handles per request to monitor. Handles are resolved and assigned to listener accounts automatically.", "type": "text/plain" }, "url": { "path": [ "v1", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handles\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "272116fc-dbae-4dc3-b3a3-1370540be445", "name": "Accounts added successfully", "originalRequest": { "url": { "path": [ "v1", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handles\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {},\n \"error\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "359a3954-2a0d-4c43-ac32-b361fda2e2dc", "name": "Invalid handles or limit exceeded", "originalRequest": { "url": { "path": [ "v1", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handles\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c2268819-fbce-4e33-8f7a-7e6d4842370e", "name": "Account limit reached for subscription tier", "originalRequest": { "url": { "path": [ "v1", "accounts" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handles\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{handle}", "description": "", "item": [ { "id": "79d07896-bd81-44b2-bd5d-d6dca18f3ed7", "name": "Get account details", "request": { "name": "Get account details", "description": { "content": "Returns details for a specific tracked Twitter account including keywords, mute status, and listener assignment.", "type": "text/plain" }, "url": { "path": [ "v1", "accounts", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) Twitter handle (without @)", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "987e9009-7e0d-4836-aa1a-5c1378537d0b", "name": "Account details", "originalRequest": { "url": { "path": [ "v1", "accounts", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Twitter handle (without @)", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"handle\": \"\",\n \"twitter_id\": \"\",\n \"listener_id\": \"\",\n \"muted\": \"\",\n \"keywords_include\": [\n \"\",\n \"\"\n ],\n \"keywords_exclude\": [\n \"\",\n \"\"\n ],\n \"added_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ce95a74e-b675-49dd-b663-64fbdef814f1", "name": "Account not tracked", "originalRequest": { "url": { "path": [ "v1", "accounts", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Twitter handle (without @)", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7f44a70d-3c40-4312-9393-2e67cd4545fc", "name": "Remove tracked account", "request": { "name": "Remove tracked account", "description": { "content": "Stop monitoring a Twitter account.", "type": "text/plain" }, "url": { "path": [ "v1", "accounts", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "52c2cc92-6b92-4ccd-a3f8-03b79fcaefac", "name": "Account removed", "originalRequest": { "url": { "path": [ "v1", "accounts", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "636b5f50-6187-425e-be5d-49034dfb2c85", "name": "Account not tracked", "originalRequest": { "url": { "path": [ "v1", "accounts", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "keywords", "description": "", "item": [ { "id": "7a45ef55-eb5e-4727-b527-77c9b16b1e4c", "name": "Set keyword filter", "request": { "name": "Set keyword filter", "description": { "content": "Set include/exclude keyword filters for a tracked account. Tweets are only delivered if they match include keywords (if set) and don't match exclude keywords.", "type": "text/plain" }, "url": { "path": [ "v1", "accounts", ":handle", "keywords" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"include\": [\n \"\",\n \"\"\n ],\n \"exclude\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ebccb352-ce47-4736-a57a-463048e077c6", "name": "Keywords updated", "originalRequest": { "url": { "path": [ "v1", "accounts", ":handle", "keywords" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"include\": [\n \"\",\n \"\"\n ],\n \"exclude\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "21b18464-ed4b-4436-8368-fbd20fc086ac", "name": "Clear keyword filter", "request": { "name": "Clear keyword filter", "description": { "content": "Remove all keyword filters for a tracked account. All tweets will be delivered.", "type": "text/plain" }, "url": { "path": [ "v1", "accounts", ":handle", "keywords" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "55b49586-5205-4f89-92e1-cff7a8feb592", "name": "Keywords cleared", "originalRequest": { "url": { "path": [ "v1", "accounts", ":handle", "keywords" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "mute", "description": "", "item": [ { "id": "69416ea7-e3d2-45e2-8670-71e698280775", "name": "Mute/unmute account", "request": { "name": "Mute/unmute account", "description": { "content": "Toggle mute status for a tracked account. Muted accounts are still monitored but notifications are suppressed.", "type": "text/plain" }, "url": { "path": [ "v1", "accounts", ":handle", "mute" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"muted\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "8c2e1161-c2b1-486b-8849-48c7a64a0b53", "name": "Mute status updated", "originalRequest": { "url": { "path": [ "v1", "accounts", ":handle", "mute" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"muted\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] }, { "name": "settings", "description": "", "item": [ { "id": "372ad064-53ae-450c-aa67-3ca48ec1771a", "name": "Get user settings", "request": { "name": "Get user settings", "description": { "content": "Returns current user settings including notification preferences and filter configuration.", "type": "text/plain" }, "url": { "path": [ "v1", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "2d163afb-dc72-40c6-817c-1f86b8c38ff3", "name": "User settings", "originalRequest": { "url": { "path": [ "v1", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {},\n \"error\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7fc55262-e0a7-4097-9fe5-be5562e57f0a", "name": "Update user settings", "request": { "name": "Update user settings", "description": { "content": "Update notification preferences including reply/quote filtering.", "type": "text/plain" }, "url": { "path": [ "v1", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"suppress_replies\": \"\",\n \"suppress_quotes\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "fed2ad6a-9a17-45bc-9345-6ab6f8a67bea", "name": "Settings updated", "originalRequest": { "url": { "path": [ "v1", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"suppress_replies\": \"\",\n \"suppress_quotes\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "subscription", "description": "", "item": [ { "id": "bb6257da-892d-4749-a097-10dabb783af0", "name": "Get subscription info", "request": { "name": "Get subscription info", "description": { "content": "Returns the user's active subscription tier, limits, usage, and expiration date.", "type": "text/plain" }, "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "2cc28722-0b3c-4d24-8006-6d8262a82b30", "name": "Subscription details", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {},\n \"error\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "plans", "description": "", "item": [ { "id": "22259cb1-b055-403e-b5ea-1664733ef00d", "name": "List subscription plans", "request": { "name": "List subscription plans", "description": { "content": "Returns all available subscription tiers with pricing and limits.", "type": "text/plain" }, "url": { "path": [ "v1", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "59292fea-ebb9-492e-9b68-0f321adcc447", "name": "Available plans", "originalRequest": { "url": { "path": [ "v1", "plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {},\n \"error\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "webhooks", "description": "", "item": [ { "id": "690ae711-b275-4e31-b7ea-3cb77974ca69", "name": "List webhooks", "request": { "name": "List webhooks", "description": { "content": "Returns all registered webhook URLs for the authenticated user. Secret field is omitted from response.", "type": "text/plain" }, "url": { "path": [ "v1", "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "65638ca2-5201-47bd-8c58-8e8b1934561d", "name": "List of webhooks", "originalRequest": { "url": { "path": [ "v1", "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {},\n \"error\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "df857922-0eed-4427-8cf8-25e888bcddc5", "name": "Register webhook", "request": { "name": "Register webhook", "description": { "content": "Register a callback URL to receive tweet notifications via HTTPS POST. Payloads are signed with HMAC-SHA256. Failed deliveries are retried with exponential backoff (3 attempts).", "type": "text/plain" }, "url": { "path": [ "v1", "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "902f8b89-c1c1-40be-be8c-c914b0210d7c", "name": "Webhook registered. Response includes the HMAC secret for signature verification.", "originalRequest": { "url": { "path": [ "v1", "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"id\": \"\",\n \"url\": \"\",\n \"secret\": \"\",\n \"created_at\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "419ca7ad-45df-44c2-85e8-857b3ca2b2d5", "name": "Webhook limit reached for subscription tier", "originalRequest": { "url": { "path": [ "v1", "webhooks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{id}", "description": "", "item": [ { "id": "f220c063-4412-428d-898c-eeb8d0508d80", "name": "Remove webhook", "request": { "name": "Remove webhook", "description": { "content": "Soft-deactivate a registered webhook.", "type": "text/plain" }, "url": { "path": [ "v1", "webhooks", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "9bcd5cb9-baed-43b8-885c-c7bb3f2a2079", "name": "Webhook deactivated", "originalRequest": { "url": { "path": [ "v1", "webhooks", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "13fbe51a-b983-49fc-9946-9978530d951f", "name": "Webhook not found", "originalRequest": { "url": { "path": [ "v1", "webhooks", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "feed", "description": "", "item": [ { "id": "b3dcee7a-2d3c-43c4-8012-91bfc7692e78", "name": "Get tweet feed", "request": { "name": "Get tweet feed", "description": { "content": "Returns recent tweets from all tracked accounts. Requires web dashboard authentication (JWT cookie).", "type": "text/plain" }, "url": { "path": [ "v1", "feed" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Max tweets to return", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Cursor for pagination", "type": "text/plain" }, "key": "before", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "xg_session" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "ae3c3bfa-5590-4dd2-b502-9247ec76af4f", "name": "Tweet feed", "originalRequest": { "url": { "path": [ "v1", "feed" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Max tweets to return", "type": "text/plain" }, "key": "limit", "value": "50" }, { "disabled": false, "description": { "content": "Cursor for pagination", "type": "text/plain" }, "key": "before", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "xg_session", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {},\n \"error\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "cw", "description": "", "item": [ { "name": "targets", "description": "", "item": [ { "id": "fceb48db-4150-43b7-863e-8eca9a14e5eb", "name": "List watched handles", "request": { "name": "List watched handles", "description": { "content": "Returns all Twitter handles being monitored for community gate activity.", "type": "text/plain" }, "url": { "path": [ "v1", "cw", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "aed82bb8-dd14-44dd-bca8-cd5574c64946", "name": "List of watched handles", "originalRequest": { "url": { "path": [ "v1", "cw", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {},\n \"error\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "35656433-477a-4831-baf4-bad53b8f87ef", "name": "Add watched handle", "request": { "name": "Add watched handle", "description": { "content": "Start monitoring a Twitter handle for community gate changes (join, create, rename, description change).", "type": "text/plain" }, "url": { "path": [ "v1", "cw", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handle\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "62eca5ad-e4c7-4867-b66d-4b96612747b4", "name": "Handle added to watch list", "originalRequest": { "url": { "path": [ "v1", "cw", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handle\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "3e0262fa-d0ad-4c57-a913-b828e47500d9", "name": "Target limit reached for subscription", "originalRequest": { "url": { "path": [ "v1", "cw", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handle\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{handle}", "description": "", "item": [ { "id": "ca44e6d5-4f8b-4dfb-9b49-e2aebe5a263c", "name": "Remove watched handle", "request": { "name": "Remove watched handle", "description": { "content": "Stop monitoring a Twitter handle for community gate activity.", "type": "text/plain" }, "url": { "path": [ "v1", "cw", "targets", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "4fba9288-8ec5-493d-b33d-069c84068aac", "name": "Handle removed", "originalRequest": { "url": { "path": [ "v1", "cw", "targets", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b6d0c3d9-1f38-4118-a112-68b543c50157", "name": "Handle not watched", "originalRequest": { "url": { "path": [ "v1", "cw", "targets", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "webhook", "description": "", "item": [ { "id": "e1c0f8f2-db44-40ca-996e-9b498416a897", "name": "Get CW webhook", "request": { "name": "Get CW webhook", "description": { "content": "Returns the currently configured webhook URL for Community Watch events.", "type": "text/plain" }, "url": { "path": [ "v1", "cw", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "40ab3116-8ee9-461b-ba75-9d5e1c75ed2f", "name": "Webhook configuration", "originalRequest": { "url": { "path": [ "v1", "cw", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4d47129c-0115-4052-8fa7-c367fc854f39", "name": "Set CW webhook", "request": { "name": "Set CW webhook", "description": { "content": "Configure a webhook URL to receive Community Watch events (community_joined, community_created, community_renamed, description_changed, followed, new_follower_digest).", "type": "text/plain" }, "url": { "path": [ "v1", "cw", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "a4d293e9-81c3-4e81-9066-d459a3ff7b52", "name": "Webhook set", "originalRequest": { "url": { "path": [ "v1", "cw", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "settings", "description": "", "item": [ { "id": "9d09911b-1cdf-430e-98cb-69bffaafcd2c", "name": "Get CW settings", "request": { "name": "Get CW settings", "description": { "content": "Returns Community Watch client settings including event type subscriptions.", "type": "text/plain" }, "url": { "path": [ "v1", "cw", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "b8c6115b-3306-4f55-88ce-cceb598af557", "name": "CW settings", "originalRequest": { "url": { "path": [ "v1", "cw", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e2d7b61f-63c6-4dcb-87f0-44849af4dc60", "name": "Update CW settings", "request": { "name": "Update CW settings", "description": { "content": "Update which event types to receive notifications for.", "type": "text/plain" }, "url": { "path": [ "v1", "cw", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"event_types\": [\n \"new_follower_digest\",\n \"community_renamed\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "361c11de-6913-4934-98fa-046e0db7041d", "name": "Settings updated", "originalRequest": { "url": { "path": [ "v1", "cw", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"event_types\": [\n \"new_follower_digest\",\n \"community_renamed\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "status", "description": "", "item": [ { "id": "aa2700b4-c2d8-4685-b7e3-194fcd5818d9", "name": "Get CW status", "request": { "name": "Get CW status", "description": { "content": "Returns Community Watch polling status including active accounts, last poll time, and error rates.", "type": "text/plain" }, "url": { "path": [ "v1", "cw", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "2d3282d4-a591-4607-b409-d516990f1636", "name": "CW status", "originalRequest": { "url": { "path": [ "v1", "cw", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "ws", "description": "", "item": [ { "id": "9b1a77e0-bc24-44f3-b338-cd53c51b935a", "name": "CW WebSocket streaming", "request": { "name": "CW WebSocket streaming", "description": { "content": "Real-time Community Watch events via WebSocket. Receives JSON messages for community gate changes as they are detected.", "type": "text/plain" }, "url": { "path": [ "v1", "cw", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your CW API key (cw_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5c73dcf1-46a0-4dd8-8580-2a1c76ca8e43", "name": "WebSocket upgrade successful", "originalRequest": { "url": { "path": [ "v1", "cw", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your CW API key (cw_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Switching Protocols", "code": 101, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d294958e-c54f-4d11-bb62-bdd44dbe2936", "name": "Invalid API key", "originalRequest": { "url": { "path": [ "v1", "cw", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your CW API key (cw_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "ct", "description": "", "item": [ { "name": "targets", "description": "", "item": [ { "id": "619eca71-84ac-4ba0-afdf-c382f085b399", "name": "List CT targets", "request": { "name": "List CT targets", "description": { "content": "Returns all Twitter handles being tracked for community convergence detection.", "type": "text/plain" }, "url": { "path": [ "v1", "ct", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6e3146e2-14f9-4861-8b19-efec6ca7b912", "name": "List of tracked handles", "originalRequest": { "url": { "path": [ "v1", "ct", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "23703669-a3c0-4988-999e-026cda69f42f", "name": "Add CT target", "request": { "name": "Add CT target", "description": { "content": "Add a Twitter handle for convergence tracking. The system monitors which communities this account joins and checks for overlap with other tracked accounts.", "type": "text/plain" }, "url": { "path": [ "v1", "ct", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handle\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "782dea5d-a64d-4190-9338-d88ae04e749f", "name": "Target added", "originalRequest": { "url": { "path": [ "v1", "ct", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handle\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "38e2e889-f674-4616-9141-445aa3ae35d6", "name": "Target limit reached", "originalRequest": { "url": { "path": [ "v1", "ct", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handle\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{handle}", "description": "", "item": [ { "id": "d0fbe39d-52e8-48f0-bdf5-fad6f7f981d5", "name": "Remove CT target", "request": { "name": "Remove CT target", "description": {}, "url": { "path": [ "v1", "ct", "targets", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "517982e0-b784-4fd8-92a3-dc07fa405bc0", "name": "Target removed", "originalRequest": { "url": { "path": [ "v1", "ct", "targets", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "convergence", "description": "", "item": [ { "id": "2b697d64-5369-4671-a28a-e97d749be378", "name": "Get convergence results", "request": { "name": "Get convergence results", "description": { "content": "Returns current convergence detections -- groups of tracked accounts that appear in the same Twitter community within the configured time window.", "type": "text/plain" }, "url": { "path": [ "v1", "ct", "convergence" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c20c89e8-cc95-45a8-bef4-5b643b2a8113", "name": "Convergence results", "originalRequest": { "url": { "path": [ "v1", "ct", "convergence" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {},\n \"error\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "history", "description": "", "item": [ { "id": "86abd933-1389-4492-80b2-e598652879c8", "name": "Get convergence history", "request": { "name": "Get convergence history", "description": { "content": "Returns historical convergence events.", "type": "text/plain" }, "url": { "path": [ "v1", "ct", "convergence", "history" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "d593c4c6-8d54-465d-9f15-85c816a2cdf8", "name": "Convergence history", "originalRequest": { "url": { "path": [ "v1", "ct", "convergence", "history" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "settings", "description": "", "item": [ { "id": "e77d1b01-dd31-409b-8bbd-8cc3259b80d1", "name": "Get CT settings", "request": { "name": "Get CT settings", "description": {}, "url": { "path": [ "v1", "ct", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "9b9abc70-3f27-495b-8400-2f82ed39c3c3", "name": "CT settings", "originalRequest": { "url": { "path": [ "v1", "ct", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e3d3245b-c5da-439e-8a68-32cb7586e334", "name": "Update CT settings", "request": { "name": "Update CT settings", "description": { "content": "Update convergence detection parameters.", "type": "text/plain" }, "url": { "path": [ "v1", "ct", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"min_convergence\": \"\",\n \"time_window_hours\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "0298f535-a31d-4e23-b479-388102385f67", "name": "Settings updated", "originalRequest": { "url": { "path": [ "v1", "ct", "settings" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"min_convergence\": \"\",\n \"time_window_hours\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "webhook", "description": "", "item": [ { "id": "978569bc-1f39-43c5-9c53-612a39825732", "name": "Get CT webhook", "request": { "name": "Get CT webhook", "description": {}, "url": { "path": [ "v1", "ct", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c3a73f75-3df1-43e5-b516-4d6115d738d0", "name": "Webhook configuration", "originalRequest": { "url": { "path": [ "v1", "ct", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3a8a1a12-bb6d-44f1-97fe-9cdf992e51f7", "name": "Set CT webhook", "request": { "name": "Set CT webhook", "description": {}, "url": { "path": [ "v1", "ct", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ec1c8def-dea7-4dcf-a041-88347e9e824f", "name": "Webhook set", "originalRequest": { "url": { "path": [ "v1", "ct", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "status", "description": "", "item": [ { "id": "2dfa1e63-1699-4be5-8518-fff00704148d", "name": "Get CT status", "request": { "name": "Get CT status", "description": {}, "url": { "path": [ "v1", "ct", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1d148bc1-e272-4631-bc30-96b4b620d653", "name": "CT status", "originalRequest": { "url": { "path": [ "v1", "ct", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "ws", "description": "", "item": [ { "id": "93b9f6f3-1453-4acd-90eb-b60dc3c9768f", "name": "CT WebSocket streaming", "request": { "name": "CT WebSocket streaming", "description": { "content": "Real-time convergence detection events via WebSocket.", "type": "text/plain" }, "url": { "path": [ "v1", "ct", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your CT API key (ct_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "a5120a8a-2277-45bf-8dcc-70a65122cac2", "name": "WebSocket upgrade successful", "originalRequest": { "url": { "path": [ "v1", "ct", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your CT API key (ct_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Switching Protocols", "code": 101, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d2f2c2d6-a467-48d6-81bb-e6dc345b88c7", "name": "Invalid API key", "originalRequest": { "url": { "path": [ "v1", "ct", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your CT API key (ct_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "dt", "description": "", "item": [ { "name": "targets", "description": "", "item": [ { "id": "3b485c02-07ff-41f3-bbe2-babb54d8368e", "name": "List DT targets", "request": { "name": "List DT targets", "description": { "content": "Returns all Twitter handles being scraped for the authenticated client.", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "4caf0870-15c3-48c4-8339-ebbb6c8944f3", "name": "List of scrape targets", "originalRequest": { "url": { "path": [ "v1", "dt", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7f0cd2af-c436-4e89-b288-31fc20dbee70", "name": "Add DT target", "request": { "name": "Add DT target", "description": { "content": "Add a Twitter handle for periodic scraping (profile, tweets, following, followers, communities, likes, media).", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handle\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "e6a27eb1-3236-441a-9cd8-e5177c3457fb", "name": "Target added", "originalRequest": { "url": { "path": [ "v1", "dt", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handle\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c2819804-6265-4d04-8fd8-e6455174d5a3", "name": "Target limit reached", "originalRequest": { "url": { "path": [ "v1", "dt", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"handle\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{handle}", "description": "", "item": [ { "id": "26948f95-d960-4055-b901-1b6434be76c2", "name": "Remove DT target", "request": { "name": "Remove DT target", "description": {}, "url": { "path": [ "v1", "dt", "targets", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "5ace9e01-2dbb-4f9c-b055-d5819286e549", "name": "Target removed", "originalRequest": { "url": { "path": [ "v1", "dt", "targets", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "profile", "description": "", "item": [ { "name": "{handle}", "description": "", "item": [ { "id": "16aa760b-bb1f-43b0-b65d-410c7a5b17f7", "name": "Get profile snapshot", "request": { "name": "Get profile snapshot", "description": { "content": "Returns the latest scraped profile data for a Twitter handle including bio, follower count, following count, and verified status.", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "profile", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "bc48bbae-6a2e-4fa9-978a-3868fa924494", "name": "Profile snapshot", "originalRequest": { "url": { "path": [ "v1", "dt", "profile", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d0ce6e5d-8ed7-491e-9ca9-05706650a351", "name": "Handle not in your watch list", "originalRequest": { "url": { "path": [ "v1", "dt", "profile", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "bcb0ea26-122f-478c-bb2c-7eb4ed14603f", "name": "No data scraped yet", "originalRequest": { "url": { "path": [ "v1", "dt", "profile", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "history", "description": "", "item": [ { "id": "24c1bc67-061f-4e8b-b015-7fd80ed500db", "name": "Get profile history", "request": { "name": "Get profile history", "description": { "content": "Returns historical profile snapshots showing how follower count, following count, and bio have changed over time.", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "profile", ":handle", "history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "9dd48a8b-64db-4ab2-8c2d-4f61f1e10a4e", "name": "Profile history", "originalRequest": { "url": { "path": [ "v1", "dt", "profile", ":handle", "history" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] }, { "name": "tweets", "description": "", "item": [ { "name": "{handle}", "description": "", "item": [ { "id": "da91f3bf-5b79-4083-b2ae-cd2afefdef55", "name": "Get tweets", "request": { "name": "Get tweets", "description": { "content": "Returns recent tweets from a tracked handle. Scraped every hour. Includes full text, media URLs, cashtags, and engagement metrics.", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "tweets", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "a1e9349d-2bab-4dfa-bb6e-1953a48707a3", "name": "Tweet list", "originalRequest": { "url": { "path": [ "v1", "dt", "tweets", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "50" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "following", "description": "", "item": [ { "name": "{handle}", "description": "", "item": [ { "id": "8849f30e-dcbf-4f34-9e55-8fe7a86e26ce", "name": "Get following list", "request": { "name": "Get following list", "description": { "content": "Returns the list of accounts a tracked handle follows. Scraped every 24 hours.", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "following", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "38e25020-5abe-4d2e-bc6b-b7d1c33f30ad", "name": "Following list", "originalRequest": { "url": { "path": [ "v1", "dt", "following", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "followers", "description": "", "item": [ { "name": "{handle}", "description": "", "item": [ { "id": "91a53153-8b63-4f59-86a8-eaff1aeae0c1", "name": "Get followers list", "request": { "name": "Get followers list", "description": { "content": "Returns the list of accounts following a tracked handle. Scraped every 24 hours.", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "followers", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "8df847ab-e5de-41ec-bed7-62c2f6c9b874", "name": "Followers list", "originalRequest": { "url": { "path": [ "v1", "dt", "followers", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "communities", "description": "", "item": [ { "name": "{handle}", "description": "", "item": [ { "id": "982db180-5b4c-4183-81f7-ec72e8ec40f5", "name": "Get communities", "request": { "name": "Get communities", "description": { "content": "Returns the Twitter communities a tracked handle has joined. Scraped every 6 hours.", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "communities", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "5f1ded39-11dc-46a8-8f2e-8639588db85f", "name": "Communities list", "originalRequest": { "url": { "path": [ "v1", "dt", "communities", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "social", "description": "", "item": [ { "name": "diff", "description": "", "item": [ { "name": "{handle}", "description": "", "item": [ { "id": "fd90bbaa-a618-4ba9-972e-e64191898553", "name": "Get social diff", "request": { "name": "Get social diff", "description": { "content": "Returns changes in social metrics (new/lost followers, new/lost following) between scrape cycles.", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "social", "diff", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "handle", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "86a1e551-5957-4a77-b846-8f586ee471b3", "name": "Social diff", "originalRequest": { "url": { "path": [ "v1", "dt", "social", "diff", ":handle" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "handle" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] }, { "name": "webhook", "description": "", "item": [ { "id": "7e0c7ac7-55c8-4f13-ab6c-f495305426f6", "name": "Get DT webhook", "request": { "name": "Get DT webhook", "description": {}, "url": { "path": [ "v1", "dt", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "99a704c6-f7bd-416e-a369-1d72953c7d9a", "name": "Webhook configuration", "originalRequest": { "url": { "path": [ "v1", "dt", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "400551bd-a1ec-4a56-ba21-d8b8e5684d17", "name": "Set DT webhook", "request": { "name": "Set DT webhook", "description": {}, "url": { "path": [ "v1", "dt", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c5761981-c752-4998-ad79-316394c3a05c", "name": "Webhook set", "originalRequest": { "url": { "path": [ "v1", "dt", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "status", "description": "", "item": [ { "id": "22eae3b9-2ef5-4e03-b5bb-b40248b41323", "name": "Get DT status", "request": { "name": "Get DT status", "description": { "content": "Returns Xanguard B2B service status and quota usage.", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "91bd611f-4705-4b2b-99c1-690b0efec91c", "name": "DT status", "originalRequest": { "url": { "path": [ "v1", "dt", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "ws", "description": "", "item": [ { "id": "a34c09a8-7225-417e-ae65-3c158093fcce", "name": "DT WebSocket streaming", "request": { "name": "DT WebSocket streaming", "description": { "content": "Real-time Xanguard B2B events via WebSocket. Receives tweets, follow/unfollow events, profile changes, and new follower detection for your monitored handles.", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your DT API key (dt_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "e8def1b8-abca-4699-8170-33fb924f457c", "name": "WebSocket upgrade successful", "originalRequest": { "url": { "path": [ "v1", "dt", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your DT API key (dt_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Switching Protocols", "code": 101, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "796dad16-b156-421d-ade1-3cc2bca3762d", "name": "Invalid API key", "originalRequest": { "url": { "path": [ "v1", "dt", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your DT API key (dt_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "realtime", "description": "", "item": [ { "name": "ws", "description": "", "item": [ { "id": "86d9015c-9e1e-410e-8d5a-e3aeaefb7343", "name": "B2B realtime WebSocket (opcode protocol)", "request": { "name": "B2B realtime WebSocket (opcode protocol)", "description": { "content": "TweetCatcher-compatible realtime stream. Connects via opcode-framed WebSocket protocol: server emits HELLO → client responds with LOGIN → server emits READY → server emits EVENT frames as they arrive. Heartbeat every 30s; client must ACK within 90s or be disconnected. Up to 5 concurrent connections per API key. Stale events (>30s old) are dropped.\n\nSupported event types: `tweet` (new tweets/replies/quotes/retweets), `follow_change` (follow/unfollow events on tracked handles), `profile_change` (bio/name/avatar/pinned tweet changes), `new_followers` (digest of new followers per handle).\n\n**Connect URL**: `wss://api.xanguard.tech/v1/dt/realtime/ws`", "type": "text/plain" }, "url": { "path": [ "v1", "dt", "realtime", "ws" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "fb1b10a4-e163-40df-9909-5946439ab068", "name": "WebSocket upgrade successful. Server immediately emits OP_HELLO (op=10).", "originalRequest": { "url": { "path": [ "v1", "dt", "realtime", "ws" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {} }, "status": "Switching Protocols", "code": 101, "header": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Upgrade", "value": "" } ], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c1d0ba65-a051-4f95-9c9f-4195c9729885", "name": "LOGIN frame missing api_key, or api_key not found / inactive / expired.", "originalRequest": { "url": { "path": [ "v1", "dt", "realtime", "ws" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9ad942dd-2ada-4ed1-ad5e-22237ea6fce0", "name": "Connection limit exceeded (max 5 concurrent per key).", "originalRequest": { "url": { "path": [ "v1", "dt", "realtime", "ws" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] }, { "name": "eca", "description": "", "item": [ { "name": "watchlist", "description": "", "item": [ { "id": "ab2b0318-2e06-424a-8691-ae53cfcce058", "name": "List watchlist entries", "request": { "name": "List watchlist entries", "description": { "content": "Returns all active ECA watchlist entries (not expired, not yet matched).", "type": "text/plain" }, "url": { "path": [ "v1", "eca", "watchlist" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "4ea15c17-0683-4f99-9789-d2225d7e3c38", "name": "Active watchlist entries", "originalRequest": { "url": { "path": [ "v1", "eca", "watchlist" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"id\": \"\",\n \"ticker\": \"\",\n \"token_name\": \"\",\n \"contract_address\": \"\",\n \"creator_address\": \"\",\n \"expires_at\": \"\"\n },\n {\n \"id\": \"\",\n \"ticker\": \"\",\n \"token_name\": \"\",\n \"contract_address\": \"\",\n \"creator_address\": \"\",\n \"expires_at\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bff7e8a3-0cc3-459d-bbff-c883b950fc3b", "name": "Add watchlist entry", "request": { "name": "Add watchlist entry", "description": { "content": "Add a token to the ECA watchlist. Entries expire after 4 hours. Maximum 1 active entry at a time. Provide at least one of: ticker, token_name, contract_address, or creator_address.", "type": "text/plain" }, "url": { "path": [ "v1", "eca", "watchlist" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ticker\": \"\",\n \"token_name\": \"\",\n \"contract_address\": \"\",\n \"creator_address\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c7b920f2-fde3-4a70-b65a-e4e8a586373c", "name": "Entry added", "originalRequest": { "url": { "path": [ "v1", "eca", "watchlist" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ticker\": \"\",\n \"token_name\": \"\",\n \"contract_address\": \"\",\n \"creator_address\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4ed1bea3-16ee-4360-892c-4946182f8fcc", "name": "No fields provided or limit reached", "originalRequest": { "url": { "path": [ "v1", "eca", "watchlist" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ticker\": \"\",\n \"token_name\": \"\",\n \"contract_address\": \"\",\n \"creator_address\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{id}", "description": "", "item": [ { "id": "b10c5e17-7cd5-4183-8a97-d084d0f53d91", "name": "Remove watchlist entry", "request": { "name": "Remove watchlist entry", "description": {}, "url": { "path": [ "v1", "eca", "watchlist", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "9c277120-bc7c-4e9a-aa10-b61927293118", "name": "Entry removed", "originalRequest": { "url": { "path": [ "v1", "eca", "watchlist", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "12daf8fd-e17f-43af-8d87-c33c4f9d7017", "name": "Entry not found", "originalRequest": { "url": { "path": [ "v1", "eca", "watchlist", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "matches", "description": "", "item": [ { "id": "0daefcc2-a1e4-4412-899a-8910616cf491", "name": "Get recent matches", "request": { "name": "Get recent matches", "description": { "content": "Returns token launch matches from the last 24 hours, including mint address, match type, and detection time.", "type": "text/plain" }, "url": { "path": [ "v1", "eca", "matches" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "358adcdc-4899-4cae-b5bc-aa1c9ea8b175", "name": "Recent matches", "originalRequest": { "url": { "path": [ "v1", "eca", "matches" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"id\": \"\",\n \"mint\": \"\",\n \"match_type\": \"\",\n \"matched_at\": \"\"\n },\n {\n \"id\": \"\",\n \"mint\": \"\",\n \"match_type\": \"\",\n \"matched_at\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "webhook", "description": "", "item": [ { "id": "694d1921-ea8c-4767-9a83-68c048e4c0bb", "name": "Get ECA webhook", "request": { "name": "Get ECA webhook", "description": {}, "url": { "path": [ "v1", "eca", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "79913183-5fd3-421f-a13f-46d12b557e06", "name": "Webhook configuration", "originalRequest": { "url": { "path": [ "v1", "eca", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "38135930-3fb8-44f1-a52c-57a2d27bc9d8", "name": "Set ECA webhook", "request": { "name": "Set ECA webhook", "description": { "content": "Configure a webhook URL to receive ECA match notifications. Returns a signing secret for HMAC-SHA256 verification.", "type": "text/plain" }, "url": { "path": [ "v1", "eca", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1d4b210c-7de3-47df-af6e-709bd0dd3244", "name": "Webhook set with signing secret", "originalRequest": { "url": { "path": [ "v1", "eca", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "status", "description": "", "item": [ { "id": "98115666-a97a-4fb8-bca8-a60931ad4f92", "name": "Get ECA status", "request": { "name": "Get ECA status", "description": { "content": "Returns ECA subscription status including active entry count, total matches, and max entries allowed.", "type": "text/plain" }, "url": { "path": [ "v1", "eca", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "24c28fbd-5237-495f-b2a2-0bdcea3e4ebc", "name": "ECA status", "originalRequest": { "url": { "path": [ "v1", "eca", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"active_entries\": \"\",\n \"total_matches\": \"\",\n \"max_entries\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "ws", "description": "", "item": [ { "id": "499eb5c2-73a2-411a-a39d-04fef832af80", "name": "ECA WebSocket streaming", "request": { "name": "ECA WebSocket streaming", "description": { "content": "Real-time ECA match events via WebSocket. Receives JSON messages when a token launch matches your watchlist criteria.", "type": "text/plain" }, "url": { "path": [ "v1", "eca", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your ECA API key (eca_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "dec56e07-bb04-4cd3-8fd4-26832187a242", "name": "WebSocket upgrade successful", "originalRequest": { "url": { "path": [ "v1", "eca", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your ECA API key (eca_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Switching Protocols", "code": 101, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5ebb013b-84f0-463b-b212-a02bad9101c0", "name": "Invalid API key", "originalRequest": { "url": { "path": [ "v1", "eca", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your ECA API key (eca_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "et", "description": "", "item": [ { "name": "targets", "description": "", "item": [ { "id": "3cb1101c-1112-4f77-8aef-fe851a4c6a3a", "name": "List watched tweets", "request": { "name": "List watched tweets", "description": { "content": "Returns all tweet IDs being monitored for engagement changes.", "type": "text/plain" }, "url": { "path": [ "v1", "et", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "8acbcd5b-c256-4633-876b-75c6e12619e4", "name": "List of watched tweets", "originalRequest": { "url": { "path": [ "v1", "et", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"id\": \"\",\n \"tweet_id\": \"\",\n \"label\": \"\",\n \"created_at\": \"\"\n },\n {\n \"id\": \"\",\n \"tweet_id\": \"\",\n \"label\": \"\",\n \"created_at\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a7169ce3-040c-444b-a23e-b88af97ae0e7", "name": "Add tweets to watch", "request": { "name": "Add tweets to watch", "description": { "content": "Add tweet IDs to monitor for engagement changes (likes, retweets, replies, quotes, bookmarks). Changes are delivered in real-time via SSE.", "type": "text/plain" }, "url": { "path": [ "v1", "et", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"tweet_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "fbe5f6c3-5688-4ef8-96ce-142d6964d5db", "name": "Tweets added to watchlist", "originalRequest": { "url": { "path": [ "v1", "et", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"tweet_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b8056370-7e91-47bd-963c-f46cafda1597", "name": "Tweet limit reached for subscription", "originalRequest": { "url": { "path": [ "v1", "et", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"tweet_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{tweet_id}", "description": "", "item": [ { "id": "9707087c-4457-40ed-9310-e9c70647bcdc", "name": "Remove watched tweet", "request": { "name": "Remove watched tweet", "description": {}, "url": { "path": [ "v1", "et", "targets", ":tweet_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "tweet_id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ec0f1aaf-dcce-46e4-9e2c-1cc90753806d", "name": "Tweet removed from watchlist", "originalRequest": { "url": { "path": [ "v1", "et", "targets", ":tweet_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "tweet_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "engagement", "description": "", "item": [ { "name": "{tweet_id}", "description": "", "item": [ { "id": "3226474f-8771-4c2c-b7ac-08b494d50dc7", "name": "Get tweet engagement", "request": { "name": "Get tweet engagement", "description": { "content": "Returns current engagement counts for a watched tweet (likes, retweets, replies, quotes, bookmarks).", "type": "text/plain" }, "url": { "path": [ "v1", "et", "engagement", ":tweet_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "tweet_id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "5ecd32a5-c903-4ccc-a2e5-5f12dd0351a6", "name": "Engagement counts", "originalRequest": { "url": { "path": [ "v1", "et", "engagement", ":tweet_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "tweet_id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"tweet_id\": \"\",\n \"favorite_count\": \"\",\n \"retweet_count\": \"\",\n \"reply_count\": \"\",\n \"quote_count\": \"\",\n \"bookmark_count\": \"\",\n \"last_updated\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "568443be-ea06-4251-84c3-78a055fbaaca", "name": "Tweet not in your watchlist", "originalRequest": { "url": { "path": [ "v1", "et", "engagement", ":tweet_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "tweet_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "af0eab8c-27a4-4c4d-9b04-9a69843c2e46", "name": "No engagement data yet", "originalRequest": { "url": { "path": [ "v1", "et", "engagement", ":tweet_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "tweet_id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "webhook", "description": "", "item": [ { "id": "f30e4cbd-1872-4c6d-8922-ff11be502d3c", "name": "Get ET webhook", "request": { "name": "Get ET webhook", "description": {}, "url": { "path": [ "v1", "et", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "08ae1e48-9b38-43d6-ab95-be29c97d0ff2", "name": "Webhook configuration", "originalRequest": { "url": { "path": [ "v1", "et", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4bf90ee1-dbd5-471a-bf96-c565aae8be8d", "name": "Set ET webhook", "request": { "name": "Set ET webhook", "description": { "content": "Configure a webhook URL to receive engagement change notifications.", "type": "text/plain" }, "url": { "path": [ "v1", "et", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "4ee7b853-5f57-4d4f-ba0d-dd1688f58fc3", "name": "Webhook set with signing secret", "originalRequest": { "url": { "path": [ "v1", "et", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "status", "description": "", "item": [ { "id": "a4bc6157-5168-4121-8bf0-314487cf366d", "name": "Get ET status", "request": { "name": "Get ET status", "description": { "content": "Returns subscription status including tweets watched, max tweet limit, and subscription expiry.", "type": "text/plain" }, "url": { "path": [ "v1", "et", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1773942b-c986-4b7e-97bf-7e919c33a7cc", "name": "ET status", "originalRequest": { "url": { "path": [ "v1", "et", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"is_subscribed\": \"\",\n \"tweets_watched\": \"\",\n \"max_tweets\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "ws", "description": "", "item": [ { "id": "27f5eb5c-6528-467c-a7e5-61910d792a99", "name": "ET WebSocket streaming", "request": { "name": "ET WebSocket streaming", "description": { "content": "Real-time engagement change events via WebSocket. Receives JSON messages when engagement counts change for any watched tweet.", "type": "text/plain" }, "url": { "path": [ "v1", "et", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your ET API key (et_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "3d8085c7-732d-44b4-a317-297f10f9d2ff", "name": "WebSocket upgrade successful", "originalRequest": { "url": { "path": [ "v1", "et", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your ET API key (et_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Switching Protocols", "code": 101, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "3bc85b59-ed31-44bd-80b3-21eb90952a14", "name": "Invalid API key", "originalRequest": { "url": { "path": [ "v1", "et", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your ET API key (et_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "trending", "description": "", "item": [ { "name": "categories", "description": "", "item": [ { "id": "50dfa8cf-b5ed-4fa0-8030-5ed0700f1ac9", "name": "List all categories", "request": { "name": "List all categories", "description": { "content": "Returns all 24 available trending categories with subscription status for each.", "type": "text/plain" }, "url": { "path": [ "v1", "trending", "categories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "b0701980-0eb7-4b1b-b087-07018f25b126", "name": "Category list", "originalRequest": { "url": { "path": [ "v1", "trending", "categories" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"slug\": \"\",\n \"name\": \"\",\n \"subscribed\": \"\"\n },\n {\n \"slug\": \"\",\n \"name\": \"\",\n \"subscribed\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "subscriptions", "description": "", "item": [ { "id": "44fb8a68-4b9b-4833-ba67-ba274235ee59", "name": "Get subscribed categories", "request": { "name": "Get subscribed categories", "description": { "content": "Returns the categories the client is currently subscribed to, along with max category limit.", "type": "text/plain" }, "url": { "path": [ "v1", "trending", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1bff5f5b-847e-47ac-bc57-91945e0cf374", "name": "Subscribed categories", "originalRequest": { "url": { "path": [ "v1", "trending", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"categories\": [\n \"\",\n \"\"\n ],\n \"max_categories\": \"\",\n \"is_subscribed\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ad8d1f58-c0f5-415f-918f-d8d923bb9341", "name": "Update subscribed categories", "request": { "name": "Update subscribed categories", "description": { "content": "Replace the list of subscribed trending categories. Free tier: 1 non-crypto category. Pro tier: all 24 categories.", "type": "text/plain" }, "url": { "path": [ "v1", "trending", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"categories\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "01caf91e-ff15-4aad-875d-6283f348cb37", "name": "Subscriptions updated", "originalRequest": { "url": { "path": [ "v1", "trending", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"categories\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "3f5089dd-82c0-4489-9e50-9e605dee3413", "name": "Invalid category slug or limit exceeded", "originalRequest": { "url": { "path": [ "v1", "trending", "subscriptions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"categories\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "webhook", "description": "", "item": [ { "id": "e1254007-09b9-4c01-b58b-9dd56a57b241", "name": "Get Trending webhook", "request": { "name": "Get Trending webhook", "description": {}, "url": { "path": [ "v1", "trending", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6f244d43-5078-4953-bd53-b22cebef41f1", "name": "Webhook configuration", "originalRequest": { "url": { "path": [ "v1", "trending", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aebcd114-9fbe-4631-a909-71bb59e55bd8", "name": "Set Trending webhook", "request": { "name": "Set Trending webhook", "description": { "content": "Configure a webhook URL to receive trending topic notifications.", "type": "text/plain" }, "url": { "path": [ "v1", "trending", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "55b8b91a-ec3e-4ecf-9483-823f6969accd", "name": "Webhook set with signing secret", "originalRequest": { "url": { "path": [ "v1", "trending", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "status", "description": "", "item": [ { "id": "ad038619-eef5-432c-b606-5b5964a2ff97", "name": "Get Trending status", "request": { "name": "Get Trending status", "description": { "content": "Returns subscription status including subscribed category count and max limit.", "type": "text/plain" }, "url": { "path": [ "v1", "trending", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "03ca5444-0bec-4100-b10a-3d713cd0ed35", "name": "Trending status", "originalRequest": { "url": { "path": [ "v1", "trending", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"is_subscribed\": \"\",\n \"categories_count\": \"\",\n \"max_categories\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "ws", "description": "", "item": [ { "id": "b8e57273-01d8-4b82-a98d-b0eb95e08e85", "name": "Trending WebSocket streaming", "request": { "name": "Trending WebSocket streaming", "description": { "content": "Real-time trending topic events via WebSocket. Receives JSON messages when new trending tweets are detected in your subscribed categories.", "type": "text/plain" }, "url": { "path": [ "v1", "trending", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your Trending API key (trend_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "bd8114ca-00cb-4876-b87d-518d384b193b", "name": "WebSocket upgrade successful", "originalRequest": { "url": { "path": [ "v1", "trending", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your Trending API key (trend_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Switching Protocols", "code": 101, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ed63404e-1135-4917-a834-6a23af3cf05a", "name": "Invalid API key", "originalRequest": { "url": { "path": [ "v1", "trending", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your Trending API key (trend_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "pf", "description": "", "item": [ { "name": "targets", "description": "", "item": [ { "id": "ae26d01c-395d-46e6-b976-7d4bd5d52a2a", "name": "List watched wallets", "request": { "name": "List watched wallets", "description": { "content": "Returns all wallet addresses being monitored for pump.fun livestream activity.", "type": "text/plain" }, "url": { "path": [ "v1", "pf", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "68e41c42-ed50-46d4-bc31-cac3dcede2e1", "name": "List of watched wallets", "originalRequest": { "url": { "path": [ "v1", "pf", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"wallet_address\": \"\",\n \"label\": \"\",\n \"created_at\": \"\"\n },\n {\n \"wallet_address\": \"\",\n \"label\": \"\",\n \"created_at\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2cd01e52-3ba6-45aa-b489-b88963c32b71", "name": "Add watched wallet", "request": { "name": "Add watched wallet", "description": { "content": "Start monitoring a Solana wallet address for pump.fun livestream starts and ends.", "type": "text/plain" }, "url": { "path": [ "v1", "pf", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"wallet_address\": \"\",\n \"label\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "f9845b7a-0970-4d44-993b-ddc80e7fb6f9", "name": "Wallet added to watchlist", "originalRequest": { "url": { "path": [ "v1", "pf", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"wallet_address\": \"\",\n \"label\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e500c4cc-4378-4fd6-8352-cef2c631c7fd", "name": "Wallet limit reached for subscription", "originalRequest": { "url": { "path": [ "v1", "pf", "targets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"wallet_address\": \"\",\n \"label\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{wallet}", "description": "", "item": [ { "id": "09367453-44eb-40e3-82a6-9ee4848e1a1c", "name": "Remove watched wallet", "request": { "name": "Remove watched wallet", "description": {}, "url": { "path": [ "v1", "pf", "targets", ":wallet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "wallet", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "beb850df-42ce-47a5-ab21-59f15a59adfb", "name": "Wallet removed", "originalRequest": { "url": { "path": [ "v1", "pf", "targets", ":wallet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "wallet" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "events", "description": "", "item": [ { "id": "9eaac3ab-4f64-4c8e-ab2f-926a8058cdea", "name": "Get recent events", "request": { "name": "Get recent events", "description": { "content": "Returns up to 50 most recent livestream events (starts and ends) for your watched wallets.", "type": "text/plain" }, "url": { "path": [ "v1", "pf", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "052847a8-44fd-4957-80e8-4eff51767aab", "name": "Recent events", "originalRequest": { "url": { "path": [ "v1", "pf", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"id\": \"\",\n \"wallet_address\": \"\",\n \"mint\": \"\",\n \"token_name\": \"\",\n \"token_symbol\": \"\",\n \"event_type\": \"livestream_ended\",\n \"detected_at\": \"\",\n \"delivery_latency_ms\": \"\"\n },\n {\n \"id\": \"\",\n \"wallet_address\": \"\",\n \"mint\": \"\",\n \"token_name\": \"\",\n \"token_symbol\": \"\",\n \"event_type\": \"livestream_ended\",\n \"detected_at\": \"\",\n \"delivery_latency_ms\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "webhook", "description": "", "item": [ { "id": "c4753895-c9f9-445d-8f05-04294815a98c", "name": "Get PF webhook", "request": { "name": "Get PF webhook", "description": {}, "url": { "path": [ "v1", "pf", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1ec3575a-e64c-4293-8399-f9eabecd5749", "name": "Webhook configuration", "originalRequest": { "url": { "path": [ "v1", "pf", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "49c1df35-479b-49b8-9da9-d8b02617ce55", "name": "Set PF webhook", "request": { "name": "Set PF webhook", "description": { "content": "Configure a webhook URL to receive livestream start/end notifications.", "type": "text/plain" }, "url": { "path": [ "v1", "pf", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "b3fa8df0-5f20-481a-abe6-6f74e3880f3a", "name": "Webhook set with signing secret", "originalRequest": { "url": { "path": [ "v1", "pf", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "status", "description": "", "item": [ { "id": "a24e5314-b978-4b45-b961-2fc8382d3e85", "name": "Get PF status", "request": { "name": "Get PF status", "description": { "content": "Returns subscription status including wallets watched, max wallet limit, and active add-ons.", "type": "text/plain" }, "url": { "path": [ "v1", "pf", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c98b0bc0-605e-4dc2-9e18-130eb3faaf2a", "name": "PF status", "originalRequest": { "url": { "path": [ "v1", "pf", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"is_subscribed\": \"\",\n \"wallets_watched\": \"\",\n \"max_wallets\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "ws", "description": "", "item": [ { "id": "574503e0-fe6b-4e55-ac68-b00ba4896791", "name": "PF WebSocket streaming", "request": { "name": "PF WebSocket streaming", "description": { "content": "Real-time pump.fun livestream events via WebSocket. Receives JSON messages when watched wallets start or stop livestreaming.", "type": "text/plain" }, "url": { "path": [ "v1", "pf", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your PF API key (pf_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5ef3abd0-3335-4de3-a2c8-212edfd9c475", "name": "WebSocket upgrade successful", "originalRequest": { "url": { "path": [ "v1", "pf", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your PF API key (pf_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Switching Protocols", "code": 101, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "83299862-8edd-458f-998d-c0a596845d67", "name": "Invalid API key", "originalRequest": { "url": { "path": [ "v1", "pf", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your PF API key (pf_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "sa", "description": "", "item": [ { "name": "queries", "description": "", "item": [ { "id": "d32e2d9d-7a2f-4050-a97d-570bafb1e181", "name": "List search queries", "request": { "name": "List search queries", "description": { "content": "Returns all active search keyword queries for the authenticated user.", "type": "text/plain" }, "url": { "path": [ "v1", "sa", "queries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "634e549e-ad53-4065-a309-6476b98b90ff", "name": "List of search queries", "originalRequest": { "url": { "path": [ "v1", "sa", "queries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": [\n {\n \"id\": \"\",\n \"query_text\": \"\",\n \"interval_mins\": \"\",\n \"created_at\": \"\"\n },\n {\n \"id\": \"\",\n \"query_text\": \"\",\n \"interval_mins\": \"\",\n \"created_at\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "49643b1e-914e-43d3-9b59-e5136fd49f02", "name": "Add search query", "request": { "name": "Add search query", "description": { "content": "Add a keyword search query to monitor across all of Twitter. Maximum 20 queries. Query text must be 1-200 characters.", "type": "text/plain" }, "url": { "path": [ "v1", "sa", "queries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"query_text\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "f082b5c2-d372-440c-9561-6cb814b4a8c7", "name": "Query added", "originalRequest": { "url": { "path": [ "v1", "sa", "queries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"query_text\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "1692afaa-78e3-4e6c-aad4-a7b00f3b6890", "name": "Invalid query text or max queries reached (20)", "originalRequest": { "url": { "path": [ "v1", "sa", "queries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"query_text\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{id}", "description": "", "item": [ { "id": "56fde785-2b16-4fc2-a229-02bc817001ee", "name": "Remove search query", "request": { "name": "Remove search query", "description": {}, "url": { "path": [ "v1", "sa", "queries", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "DELETE", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "677fbe75-c3a1-4ecc-bf5e-f2876d0a5c5f", "name": "Query removed", "originalRequest": { "url": { "path": [ "v1", "sa", "queries", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8663eefc-dc23-454d-bb34-95d34787d8b3", "name": "Query not found", "originalRequest": { "url": { "path": [ "v1", "sa", "queries", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "webhook", "description": "", "item": [ { "id": "949792f3-a377-4a8e-a4d7-3a2d5a5dd16c", "name": "Get SA webhook", "request": { "name": "Get SA webhook", "description": {}, "url": { "path": [ "v1", "sa", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "820a6883-9722-4601-ab0a-78028a1d3256", "name": "Webhook configuration", "originalRequest": { "url": { "path": [ "v1", "sa", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a42f04d5-7923-457d-948c-c172bea97cde", "name": "Set SA webhook", "request": { "name": "Set SA webhook", "description": { "content": "Configure a webhook URL to receive search alert match notifications.", "type": "text/plain" }, "url": { "path": [ "v1", "sa", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ffa48900-fd04-4b4a-9cd7-176870d00103", "name": "Webhook set with signing secret", "originalRequest": { "url": { "path": [ "v1", "sa", "webhook" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "status", "description": "", "item": [ { "id": "7b5b8533-5b51-409c-af4a-b674c5329c3e", "name": "Get SA status", "request": { "name": "Get SA status", "description": { "content": "Returns Search Alerts subscription status including active status, expiry, poll interval, query count, and max queries.", "type": "text/plain" }, "url": { "path": [ "v1", "sa", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "9958699f-7f3d-47c1-9a5d-9c0cca857db3", "name": "SA status", "originalRequest": { "url": { "path": [ "v1", "sa", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\",\n \"data\": {\n \"is_active\": \"\",\n \"expires_at\": \"\",\n \"interval_mins\": \"\",\n \"query_count\": \"\",\n \"max_queries\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "ws", "description": "", "item": [ { "id": "748fa2a5-941c-4c2d-b322-31b974a4a705", "name": "SA WebSocket streaming", "request": { "name": "SA WebSocket streaming", "description": { "content": "Real-time search alert match events via WebSocket. Receives JSON messages when new tweets match your keyword queries.", "type": "text/plain" }, "url": { "path": [ "v1", "sa", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your SA API key (sa_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "e8a60fbe-915a-46f8-92e4-b7442d327c5e", "name": "WebSocket upgrade successful", "originalRequest": { "url": { "path": [ "v1", "sa", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your SA API key (sa_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Switching Protocols", "code": 101, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9e3ebfcb-4336-4a4a-96a0-2e0801646a3b", "name": "Invalid API key", "originalRequest": { "url": { "path": [ "v1", "sa", "ws" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Your SA API key (sa_ prefix)", "type": "text/plain" }, "key": "api_key", "value": "" } ], "variable": [] }, "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] } ], "event": [], "variable": [ { "key": "baseUrl", "value": "https://api.xanguard.tech" } ], "info": { "_postman_id": "f5c9a78b-2442-4642-8b3d-41c5b0a1ec50", "name": "Xanguard API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "Real-time Twitter monitoring and alert platform. Sub-second tweet detection, community gate tracking, convergence detection, engagement monitoring, trending alerts, pump.fun livestream detection, keyword search alerts, and token launch alerts. Built for crypto traders, DeFi protocols, trading bots, and AI agents.\n\nContact Support:\n Name: Xanguard Support", "type": "text/plain" } } }