CUQU

CUQU Activities API

活动查询

GitHub OpenAPI

Operations 1

0 of 1 operations are conformant: apis.io called them with no credentials and the responses matched this contract; 1 more answered but could not be checked against a schema. Checked 2026-11-12. how this works · status file

GET /api/activity 拉取全量活动列表（实时） observed #

Documentation

📖
Documentation
https://cuqu.net/ai-agent/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/cuqu-net/openapi/cuqu-net-activities-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/cuqu-net/json-schema/cuqu-net-irl-activity-schema.json

Other Resources

🔗
DeveloperPortal
https://agent.cuqu.net/

Work with this as data

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

MCP server

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

https://apis.io/mcp

Tools for apis

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

Call it yourself

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

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

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

GitHub Google LinkedIn

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

OpenAPI Specification

cuqu-net-activities-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: CUQU (找搭子) — 线下活动公开接口 Activities API
  version: 1.0.0
  description: '深圳等 10+ 城市的线下兴趣组局查询（桌游/飞盘/徒步/羽毛球/二次元/钓鱼等 100+ 品类）


    CUQU找搭子（原名粗趣）平台的公开实时活动接口，用于让 AI 助手或任意应用查询线下兴趣社交活动。


    【能力边界·重要】

    1. 本接口为只读，返回全量活动列表；接口侧不支持过滤与分页参数，请在调用侧按 preference（品类）、location（城市/地点）、start_time（毫秒时间戳）自行筛选。

    2. 报名 / 支付 / 签到 / 发布活动属于写操作，不走本接口，需使用 MCP 端点 https://agent.cuqu.net/mcp（cq-sk- 个人密钥，申领见 https://cuqu.net/llms.txt）。

    3. 数据为平台实时公开数据，无需鉴权。'
  contact:
    name: CUQU / 光天科技（深圳）有限公司
    url: https://cuqu.net
  license:
    name: 接口数据版权归平台所有；本描述文件与客户端实现为 MIT
    url: https://github.com/cuqu-net/cuqu-skill/blob/main/LICENSE
servers:
- url: https://cuqu.net
  description: 生产（实时数据）
tags:
- name: Activities
  description: 活动查询
paths:
  /api/activity:
    get:
      tags:
      - Activities
      operationId: listActivities
      summary: 拉取全量活动列表（实时）
      description: 返回平台当前全部可查活动。无查询参数；如需按品类/城市/日期筛选，请在调用方自行过滤字段。
      responses:
        '200':
          description: 成功返回活动列表
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActivityResponse'
              example:
                code: 0
                data:
                  list:
                  - _id: ff4bc2646ab3757000bb2bde22c140b0
                    title: 周五夜桌游局
                    preference: 桌游
                    fee_type: free
                    price: 0
                    location: 深圳南山区XX桌游馆
                    start_time: 1790750700000
                    end_time: 1790761500000
                    current_participants: 6
                    max_participants: 12
                    creator_name: 主理人昵称
                    status: open
components:
  schemas:
    ActivityResponse:
      type: object
      properties:
        code:
          type: integer
          description: 0 表示成功
          example: 0
        msg:
          type: string
          description: 失败时的错误信息
        data:
          type: object
          properties:
            list:
              type: array
              items:
                $ref: '#/components/schemas/Activity'
    Activity:
      type: object
      properties:
        _id:
          type: string
          description: 活动唯一 ID（用于详情/报名/签到）
        title:
          type: string
          description: 活动标题
        preference:
          type: string
          description: 活动品类，如 桌游 / 羽毛球 / 飞盘 / 徒步
        fee_type:
          type: string
          description: 费用类型，free / paid
        price:
          type: number
          description: 费用（元），免费为 0
        location:
          type: string
          description: 活动地点文本
        latitude:
          type: number
        longitude:
          type: number
        start_time:
          type: integer
          description: 开始时间，毫秒级 Unix 时间戳
        end_time:
          type: integer
          description: 结束时间，毫秒级 Unix 时间戳
        deadline_time:
          type: integer
          description: 报名截止时间，毫秒级时间戳
        current_participants:
          type: integer
          description: 已报名人数
        max_participants:
          type: integer
          description: 人数上限
        min_group_size:
          type: integer
          description: 成局下限人数
        creator_name:
          type: string
          description: 主理人昵称
        creator_id:
          type: string
          description: 主理人 ID
        cover:
          type: string
          description: 封面图 URL
        status:
          type: string
          description: 活动状态
        refund_rule:
          type: string
          description: 退款规则
x-cuqu-extensions:
  mcpEndpoint: https://agent.cuqu.net/mcp
  mcpAuth: 写操作需 Bearer cq-sk- 个人密钥；读操作可匿名
  llmsTxt: https://cuqu.net/llms.txt
  agentCard: https://cuqu.net/.well-known/agent.json
  note: 本描述文件仅覆盖「只读查活动」能力；报名/支付/签到/发布请用 MCP 端点。