# PickFu ## Docs - [API Reference](https://www.pickfu.com/docs/api-reference/introduction.md): Complete reference for the PickFu API - [Generate media](https://www.pickfu.com/docs/api-reference/media/generate-media.md): Generates an image from a text prompt using AI. The generated image is uploaded to the PickFu CDN and a permanent URL is returned. - [Upload media](https://www.pickfu.com/docs/api-reference/media/upload-media.md): Uploads an image or video to the PickFu CDN. Accepts either a URL (fetched and re-hosted) or base64-encoded data (max 20MB decoded). - [Get playbook](https://www.pickfu.com/docs/api-reference/playbooks/get-playbook.md): Retrieves a playbook by its slug. Returns the full structured playbook including goal, step-by-step instructions with poll creation URLs, and metadata. The steps_markdown field contains formatted instructions with embedded poll creation links. - [List playbooks](https://www.pickfu.com/docs/api-reference/playbooks/list-playbooks.md): 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. - [Create project](https://www.pickfu.com/docs/api-reference/projects/create-project.md): Creates a new project. Projects help organize related surveys. Both name and description are optional — a default name is used if omitted. - [Get project](https://www.pickfu.com/docs/api-reference/projects/get-project.md): Retrieves a project by its unique GUID, including lightweight survey summaries. - [List projects](https://www.pickfu.com/docs/api-reference/projects/list-projects.md): Returns a paginated list of projects scoped to your team/account. Use query parameters to filter by bookmarked or archived status. - [Update project](https://www.pickfu.com/docs/api-reference/projects/update-project.md): Updates a project by its GUID. You can update the name, description, goal, bookmark status, and archive status. Only provided fields are updated. - [Get survey responses](https://www.pickfu.com/docs/api-reference/responses/get-survey-responses.md): Returns paginated individual responses for a survey. Each response includes the respondent's answer, written explanation, demographic traits, and media (if applicable). Use `question_id` to filter responses to a specific question in multi-question surveys. - [Add respondents](https://www.pickfu.com/docs/api-reference/surveys/add-respondents.md): Adds more respondents to a completed survey by extending the sample size. The `respondentsAmount` parameter is the **new total** number of respondents (not the number to add). - [Create survey](https://www.pickfu.com/docs/api-reference/surveys/create-survey.md): Creates a new survey in draft status. The survey must be published separately using the publish endpoint. - [Delete survey](https://www.pickfu.com/docs/api-reference/surveys/delete-survey.md): Deletes or archives a survey depending on its state: - [Get survey](https://www.pickfu.com/docs/api-reference/surveys/get-survey.md): Retrieves a survey by its unique GUID, including all questions, answer options, respondent answers (if complete), and AI-generated summaries. - [List surveys](https://www.pickfu.com/docs/api-reference/surveys/list-surveys.md): Returns a paginated list of surveys with filtering and sorting options. Use query parameters to filter by status, type, country, tags, projects, and more. - [Publish survey](https://www.pickfu.com/docs/api-reference/surveys/publish-survey.md): Publishes a draft survey and begins collecting responses from the target audience. - [Stop survey](https://www.pickfu.com/docs/api-reference/surveys/stop-survey.md): Stops a live survey that is currently collecting responses. This is irreversible — the survey will be marked as complete and no further responses will be collected. - [Update survey](https://www.pickfu.com/docs/api-reference/surveys/update-survey.md): Updates a draft survey. All fields use replace-all semantics — for example, sending `tags` replaces all existing tags, and sending `questions` replaces all existing questions. - [Create tag](https://www.pickfu.com/docs/api-reference/tags/create-tag.md): Creates a new tag. Tag names must be unique within your team/account (1-100 characters). Returns 409 Conflict if a tag with the same name already exists. - [List tags](https://www.pickfu.com/docs/api-reference/tags/list-tags.md): Returns a paginated list of tags scoped to your team/account. Use the `query` parameter to search tag names. - [Get reporting traits](https://www.pickfu.com/docs/api-reference/traits/get-reporting-traits.md): Returns all available reporting/demographic breakdown traits that can be applied to surveys. These traits allow you to segment survey results by demographics such as age, gender, income, and more. - [Get targeting traits](https://www.pickfu.com/docs/api-reference/traits/get-targeting-traits.md): Returns all available audience targeting traits that can be used when creating or updating surveys. Traits allow you to reach specific demographics such as age groups, gender, income levels, shopping habits, and more. - [Authentication](https://www.pickfu.com/docs/developers/authentication.md): How authentication works with the PickFu CLI and MCP server - [CLI](https://www.pickfu.com/docs/developers/cli.md): Create and manage PickFu polls from the command line - [MCP server](https://www.pickfu.com/docs/developers/mcp-server.md): Use PickFu with Claude, Cursor, and other AI assistants via the Model Context Protocol - [OpenClaw](https://www.pickfu.com/docs/developers/openclaw.md): Run autonomous PickFu research loops from OpenClaw - [Developer overview](https://www.pickfu.com/docs/developers/overview.md): Integrate PickFu into your AI and developer workflows - [URL parameters](https://www.pickfu.com/docs/developers/url-parameters.md): Launch pre-configured PickFu polls from your application using URL parameters - [Best practices](https://www.pickfu.com/docs/product/best-practices.md): Write better survey questions and get more useful consumer feedback - [Projects & tags](https://www.pickfu.com/docs/product/projects-and-tags.md): Organize your surveys with projects and tags - [Survey lifecycle](https://www.pickfu.com/docs/product/survey-lifecycle.md): Understand how a PickFu survey moves from creation through completion - [Surveys overview](https://www.pickfu.com/docs/product/surveys-overview.md): Understand how PickFu surveys work and the types of feedback you can collect ## OpenAPI Specs - [openapi](https://www.pickfu.com/docs/api-reference/openapi.json) ## Optional - [PickFu](https://www.pickfu.com) - [Support](mailto:support@pickfu.com)