> ## Documentation Index
> Fetch the complete documentation index at: https://developers.respondent.io/llms.txt
> Use this file to discover all available pages before exploring further.

> Search and retrieve topics used for B2C project targeting. Use the returned IDs when setting `topicIds` on a project. **Note:** Topic IDs differ between staging and production.

# Retrieve topics list



## OpenAPI

````yaml get /v1/topics
openapi: 3.0.0
info:
  title: Partner API
  description: Public API for partner integrations
  version: '1.0'
  contact: {}
servers:
  - url: https://api-staging.respondent.io
security: []
tags: []
paths:
  /v1/topics:
    get:
      tags:
        - topics
      summary: Retrieve topics list
      description: |-
        These topics are not available in production:
          • Internet & Telecom
          • Online Communities
          • Hobbies & Leisure
          • Jobs & Education
          • Reference
          • Business & Industrial
          • People & Society
          • News
      operationId: TopicsController_search
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
        - name: x-api-secret
          in: header
          required: true
          schema:
            type: string
        - name: page
          required: false
          in: query
          schema:
            type: number
            default: 1
        - name: pageSize
          required: false
          in: query
          schema:
            type: number
            default: 50
        - name: includeCount
          required: false
          in: query
          schema:
            type: boolean
            default: false
        - name: query
          required: false
          in: query
          description: 'Character Limit: min 3 and max 100'
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopicsPaginatedDto'
components:
  schemas:
    TopicsPaginatedDto:
      type: object
      properties:
        totalResults:
          type: number
          description: >-
            The total number of results possible, which is only provided in the
            response when `includeCount` is passed as `true` within a request.
        page:
          type: number
          default: 1
        pageSize:
          type: number
          default: 50
        results:
          type: array
          items:
            $ref: '#/components/schemas/Topic'
      required:
        - page
        - pageSize
        - results
    Topic:
      type: object
      properties:
        id:
          type: string
          format: ObjectId
        createdAt:
          format: date-time
          type: string
        name:
          type: string
        customName:
          type: string
        updatedAt:
          format: date-time
          type: string
      required:
        - id
        - createdAt
        - name

````