{ "openapi": "3.1.0", "info": { "title": "Social Media Cross-Platform Search API (V1)", "version": "v0", "description": "Searches recent content across news, Weibo, WeChat, Zhihu, Douyin, Xiaohongshu, Bilibili, and Kuaishou with source and time filters. Use it to monitor a topic across multiple platforms." }, "servers": [ { "url": "https://api.justoneapi.com", "description": "Global production API (default)" } ], "tags": [ { "name": "Social Media", "description": "Cross-platform social media discovery, monitoring, and trend research across supported content platforms.", "x-platform-id": "social-media", "x-platform-aliases": [ "social media", "社交媒体", "跨平台搜索" ], "x-platform-detection-aliases": [ "social media", "社交媒体", "跨平台搜索" ] } ], "paths": { "/api/search/v1": { "get": { "tags": [ "Social Media" ], "summary": "Cross-Platform Search", "description": "Searches recent content across news, Weibo, WeChat, Zhihu, Douyin, Xiaohongshu, Bilibili, and Kuaishou with source and time filters. Use it to monitor a topic across multiple platforms.", "operationId": "getApiSearchV1", "parameters": [ { "name": "token", "in": "query", "description": "Access token for this API service.", "required": true, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "description": "Search query string. Supports these five syntax forms:\n- AND (&&): A && B matches content containing both A and B.\n- OR (||): A || B matches content containing A or B.\n- Exclusion (-): -A matches content that does not contain A.\n- Parentheses (): (A && B) || C matches content containing C, or both A and B.\n- English double quotes (\"\"): \"A\" disables tokenization and requires an exact match for A.\n", "required": false, "schema": { "type": "string" } }, { "name": "source", "in": "query", "description": "Target social media platform for search filtering.\n\nAvailable Values:\n- `ALL`: All platforms\n- `NEWS`: News\n- `WEIBO`: Sina Weibo\n- `WEIXIN`: Weixin (WeChat)\n- `ZHIHU`: Zhihu\n- `DOUYIN`: Douyin (TikTok China)\n- `XIAOHONGSHU`: Xiaohongshu (Little Red Book)\n- `BILIBILI`: Bilibili\n- `KUAISHOU`: Kuaishou", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Platform types for social media search.", "enum": [ "ALL", "NEWS", "WEIBO", "WEIXIN", "ZHIHU", "DOUYIN", "XIAOHONGSHU", "BILIBILI", "KUAISHOU" ] } }, { "name": "start", "in": "query", "description": "Start time of the search period (yyyy-MM-dd HH:mm:ss). Required for initial request.", "required": false, "schema": { "type": "string" } }, { "name": "end", "in": "query", "description": "End time of the search period (yyyy-MM-dd HH:mm:ss). Required for initial request.", "required": false, "schema": { "type": "string" } }, { "name": "nextCursor", "in": "query", "description": "Pagination cursor provided by the 'nextCursor' field in the previous response.", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "400": { "description": "Invalid request parameters or body", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "401": { "description": "Invalid or inactive access token", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "429": { "description": "Request rate or daily quota limit exceeded", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "503": { "description": "Service temporarily unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "x-order": "10001000", "x-api-version": "v1", "x-search-aliases": [ "cross-platform social media search", "multi-platform content search", "social media time range search", "跨平台社交媒体搜索", "全网内容关键词查询", "多平台舆情搜索" ], "x-highlights": [ { "type": "info", "kind": "GUIDANCE", "content": "This endpoint returns cached data." }, { "type": "warning", "kind": "GUIDANCE", "content": "This endpoint does not return all available data. Results for less common keywords may be incomplete." } ], "x-endpoint-family": "search" } } } }