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

# List playbooks

> Returns a paginated list of available PickFu playbooks (step-by-step research guides). Each playbook is a structured sequence of polls designed for a specific research goal. Optionally filter by industry.



## OpenAPI

````yaml /docs/api-reference/openapi.json get /playbooks
openapi: 3.1.0
info:
  title: PickFu API
  version: 1.0.0
  description: >-
    The PickFu API enables programmatic access to create surveys, retrieve
    results, and integrate PickFu into your workflows.


    ## Overview


    PickFu helps you get instant consumer feedback through surveys. With the
    API, you can:


    - Create surveys programmatically

    - Retrieve survey results and respondent data

    - Target specific audiences with demographic traits

    - Integrate PickFu into your product development workflow


    ## Rate Limits


    Selected endpoints (currently the CSV export endpoints) enforce per-caller
    rate limits and return `429 Too Many Requests` when exceeded. See each
    endpoint description for its specific budget.


    ## Authentication


    All API requests require a Bearer token — either an API key or an OAuth 2.0
    access token. See the [Authentication
    guide](https://www.pickfu.com/docs/developers/authentication) for details.
  contact:
    name: PickFu Support
    email: support@pickfu.com
    url: https://www.pickfu.com
servers:
  - url: https://api.pickfu.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Surveys
    description: >-
      Create, retrieve, update, and publish surveys. Surveys are the core
      resource — each contains one or more questions with answer options.
  - name: Responses
    description: >-
      Retrieve individual responses (answers) for a survey, with pagination and
      per-question filtering.
  - name: Tags
    description: Organize surveys with tags. Tags are scoped to your team/account.
  - name: Projects
    description: >-
      Organize surveys into projects. Projects group related surveys and can be
      bookmarked or archived.
  - name: Traits
    description: >-
      Audience targeting and reporting traits used to reach specific
      demographics and segment survey results.
  - name: Playbooks
    description: >-
      Discover and retrieve step-by-step research playbooks. Each playbook is a
      structured sequence of polls designed for a specific research goal.
  - name: Help
    description: Search the PickFu help center for articles and guides.
  - name: Media
    description: >-
      Generate images from text prompts and upload media files to the PickFu
      CDN.
  - name: Semantic Search
    description: >-
      Search completed surveys in your enrolled team account by meaning and
      answer evidence.
paths:
  /playbooks:
    get:
      tags:
        - Playbooks
      summary: List playbooks
      description: >-
        Returns a paginated list of available PickFu playbooks (step-by-step
        research guides). Each playbook is a structured sequence of polls
        designed for a specific research goal. Optionally filter by industry.
      operationId: listPlaybooks
      parameters:
        - schema:
            type: integer
            minimum: 1
            default: 1
          in: query
          name: page
          required: false
          description: Page number
        - schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 20
          in: query
          name: limit
          required: false
          description: Number of playbooks per page
        - schema:
            type: string
          in: query
          name: industry
          required: false
          description: >-
            Filter playbooks by industry (e.g. "ecommerce" or "E-commerce",
            "mobile apps")
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  playbooks:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type:
                            - string
                            - 'null'
                          description: Unique playbook identifier (GUID)
                        name:
                          type: string
                          description: Playbook name
                        description:
                          type:
                            - string
                            - 'null'
                          description: Short description of the playbook
                        industry:
                          type:
                            - string
                            - 'null'
                          description: Industry category
                        poll_count:
                          type: integer
                          description: Number of surveys in this playbook
                        duration:
                          type:
                            - string
                            - 'null'
                          description: Estimated completion time (e.g. "2-3 days")
                        icon:
                          type:
                            - string
                            - 'null'
                          description: Icon identifier or emoji
                        icon_lucide:
                          type:
                            - string
                            - 'null'
                          description: Lucide icon name for the UI
                        url:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Direct URL to view this playbook on PickFu. Always
                            null — no /playbooks/<slug> route exists
                  pagination:
                    type: object
                    properties:
                      total:
                        type: integer
                        description: Total number of matching playbooks
                      page:
                        type: integer
                        description: Current page number
                      limit:
                        type: integer
                        description: Number of playbooks per page
                      totalPages:
                        type: integer
                        description: Total number of pages
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        OAuth2 access token obtained via the authorization flow. Include in the
        Authorization header as: `Bearer {access_token}`

````

## Related topics

- [PickFu MCP server for Claude, Cursor, and ChatGPT](https://www.pickfu.com/docs/integrations/mcp-server.md)
- [Amazon listing conversion (CVR)](https://www.pickfu.com/docs/playbooks/amazon-listing-conversion.md)
- [App store listing optimization (ASO)](https://www.pickfu.com/docs/playbooks/app-store-listing.md)
- [Improving Amazon listing conversion (CVR) with PickFu](https://www.pickfu.com/help/improving-your-amazon-listing-conversion-cvr-with-pickfu-getting-started-faqs.md)
- [Amazon listing mockup generator](https://www.pickfu.com/help/amazon-listing-mockup-generator.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.