---
title: "Search topics and groups"
method: GET
path: "/api/v2/search"
tags: ["search"]
---

# Search topics and groups

`GET /api/v2/search`

Search topics and groups

## Query parameters

- `str` string, required
- `include` string, required
- `offset` integer
- `limit` integer
- `page` integer

## Response `200`

Users Groups activities list

- object
  - `status` object
    - `code` string
  - `data` object
    - `results` object
      - `my` object
        - `topics` object
          - `count` integer
          - `rows` Topic[]
            - `id` string, uuid
            - `title` string, nullable
            - `description` string, html
            - `status` 'inProgress' | 'voting' | 'followUp' | 'closed'
            - `visibility` 'public' | 'private'
            - `categories` string[]
            - `sourcePartnerId` string, uuid
            - `sourcePartnerObjectId` string
            - `creator` object
              - …
            - `tokenJoin` string, nullable — This value is only returned by authorized endpoints
            - `padUrl` string
            - `endsAt` string
            - `pinned` boolean — This value is only returned by authorized endpoints
            - `hashtag` string
            - `createdAt` string
            - `updatedAt` string
        - `groups` object
          - `count` integer
          - `rows` Group[]
            - `id` string, uuid
            - `name` string
            - `parentId` string, uuid, nullable — Parent Groups id.
            - `creator` object
              - …
            - `visibility` 'public' | 'private'
            - `sourcePartnerObjectId` string
      - `public` object
        - `topics` object
          - `count` integer
          - `rows` Topic[]
            - `id` string, uuid
            - `title` string, nullable
            - `description` string, html
            - `status` 'inProgress' | 'voting' | 'followUp' | 'closed'
            - `visibility` 'public' | 'private'
            - `categories` string[]
            - `sourcePartnerId` string, uuid
            - `sourcePartnerObjectId` string
            - `creator` object
              - …
            - `tokenJoin` string, nullable — This value is only returned by authorized endpoints
            - `padUrl` string
            - `endsAt` string
            - `pinned` boolean — This value is only returned by authorized endpoints
            - `hashtag` string
            - `createdAt` string
            - `updatedAt` string

## Changes

- **2019-01-08** `59c81251b4e5` — 2 warning, 2 info
  - removed the optional property `data/results/my/topics/rows/items/favourite` from the response with the `200` status
  - removed the optional property `data/results/public/topics/rows/items/favourite` from the response with the `200` status
  - added the optional property `data/results/my/topics/rows/items/pinned` to the response with the `200` status
  - added the optional property `data/results/public/topics/rows/items/pinned` to the response with the `200` status
- **2018-12-17** `f8b47b43a084` — 2 info
  - added the optional property `data/results/my/topics/rows/items/favourite` to the response with the `200` status
  - added the optional property `data/results/public/topics/rows/items/favourite` to the response with the `200` status
- **2018-08-22** `a34f34aacc16` — 1 info
  - endpoint added
- **2018-08-20** `ba36cd387928` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/citizenos/apis/citizenos-api/changes/api/v2/search/get.md)

---

[API](https://skmtc.dev/citizenos/apis/citizenos-api.md) · [All operations](https://skmtc.dev/citizenos/apis/citizenos-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/citizenos/citizenos-api/revisions/ca28908e6b75/schema)