# PickFu

## Docs

- [How PickFu surveys work: questions, audience, results](https://www.pickfu.com/docs/guides/surveys-overview.md): How PickFu surveys work: question types, audience targeting, written explanations, sample sizes, and the AI analysis you get with results.
- [PickFu survey lifecycle: draft to archived](https://www.pickfu.com/docs/guides/survey-lifecycle.md): Follow a PickFu survey from draft to in-progress, completed, extended, and archived, including when charges apply and when edits are still possible.
- [PickFu survey best practices and writing tips](https://www.pickfu.com/docs/guides/best-practices.md): Tips for writing clear PickFu survey questions, choosing sample sizes, targeting the right audience, and getting more actionable consumer feedback.
- [PickFu's panel and response quality](https://www.pickfu.com/docs/guides/panel-and-quality.md): Who PickFu's respondents are, where they come from, how response quality is kept high, and how to flag a low-quality response from the MCP server or REST API.
- [International surveys and translation](https://www.pickfu.com/docs/guides/international-surveys.md): Run PickFu polls in 15 countries: set the audience country and PickFu auto-translates the question, context, and options into the respondent's language.
- [Organize PickFu surveys with projects and tags](https://www.pickfu.com/docs/guides/projects-and-tags.md): Group related PickFu surveys into projects and apply tags by product, stage, team, or quarter to keep a growing survey library organized.
- [PickFu survey URL parameters reference](https://www.pickfu.com/docs/guides/url-parameters.md): Build PickFu survey links with pre-filled questions, options, media, targeting, and sample size using URL parameters from any app or workflow.
- [PickFu playbooks: multi-step consumer research loops](https://www.pickfu.com/docs/playbooks/overview.md): Browse multi-step PickFu playbooks that chain polls into a repeatable consumer research loop you can run end-to-end by hand or with an AI agent.
- [Amazon main image optimization](https://www.pickfu.com/docs/playbooks/amazon-main-image.md): Run head-to-head PickFu polls to iteratively test and improve your Amazon main product image, lifting search result click-through rates over time.
- [Amazon listing conversion (CVR)](https://www.pickfu.com/docs/playbooks/amazon-listing-conversion.md): Diagnose why Amazon shoppers don't buy, then test image-stack, title, and bullet copy changes that lift your product detail page conversion rate.
- [Packaging design optimization](https://www.pickfu.com/docs/playbooks/packaging-design.md): Test packaging first impressions, see what catches the eye, benchmark against competitor products, and iterate your design until it stands out on the shelf.
- [App store listing optimization (ASO)](https://www.pickfu.com/docs/playbooks/app-store-listing.md): Test your app icon, trailer, screenshots, and store description with real mobile players, then validate the full App Store listing before you launch.
- [Game concept validation](https://www.pickfu.com/docs/playbooks/game-concept-validation.md): Validate a mobile game's concept, core mechanics, art direction, and feature priorities with real players before committing development resources.
- [PickFu use cases: ready-to-run consumer research tests](https://www.pickfu.com/docs/use-cases/overview.md): Browse runnable PickFu use cases — single, ready-to-run tests for every stage of your product, listing, and creative work. Filter by industry and goal.
- [Amazon competitor test](https://www.pickfu.com/docs/use-cases/amazon-competitor-test.md): Run a PickFu poll head-to-head against Amazon competitors to see why shoppers prefer your product or theirs and what to change on your listing.
- [Amazon listing review](https://www.pickfu.com/docs/use-cases/amazon-listing-review.md): Show your Amazon product detail page to real shoppers and surface points of confusion, missing information, and where the listing can be improved.
- [Amazon SERP test](https://www.pickfu.com/docs/use-cases/amazon-serp-test.md): Test how your Amazon product card stacks up in real search results, then optimize titles, images, and price to win clicks and conversions.
- [Main image optimization](https://www.pickfu.com/docs/use-cases/main-image-optimization.md): Test Amazon main product image variations with real shoppers to find the hero shot that stands out on the search results page and lifts CTR.
- [Optimal price finder](https://www.pickfu.com/docs/use-cases/optimal-price-finder.md): Ask real customers four key pricing questions in a PickFu poll to estimate the best price point for your product before you launch or relaunch.
- [Packaging evaluation](https://www.pickfu.com/docs/use-cases/packaging-evaluation.md): Test packaging design options with real shoppers to find the look that stands out on retail shelves and search pages and signals quality at a glance.
- [Product design iteration](https://www.pickfu.com/docs/use-cases/product-design-iteration.md): Run quick PickFu polls between design iterations to collect consumer feedback that guides your product and packaging design decisions.
- [Product idea validation](https://www.pickfu.com/docs/use-cases/product-idea-validation.md): Validate a new product concept with real consumers and discover how likely they are to buy before you invest in prototyping or production.
- [Product research](https://www.pickfu.com/docs/use-cases/product-research.md): Survey real consumers about what features, attributes, and benefits matter most in your product category to guide design and roadmap decisions.
- [Product variant test](https://www.pickfu.com/docs/use-cases/product-variant-test.md): Test Amazon product variants — colors, styles, bundles — with real shoppers and discover which option your customers are most likely to buy.
- [Rapid product concept competition test](https://www.pickfu.com/docs/use-cases/rapid-product-concept-competition-test.md): Use PickFu Rapid to test how your conceptual product would perform against real-world competitors and refine positioning before launch.
- [Rapid product concept feedback](https://www.pickfu.com/docs/use-cases/rapid-product-concept-feedback.md): Use PickFu Rapid to collect quick consumer reactions to a new product idea while you are still sourcing, designing, or prototyping.
- [App Store gameplay review](https://www.pickfu.com/docs/use-cases/app-store-gameplay-review.md): Show a short gameplay clip to real mobile players and learn how they react to your mechanics, visuals, and pacing before launching on the App Store.
- [App Store icon test](https://www.pickfu.com/docs/use-cases/app-store-icon-test.md): Test App Store icon variations head-to-head with real iOS users and learn which design wins downloads, taps, and first impressions.
- [Game character comparison](https://www.pickfu.com/docs/use-cases/game-character-comparison.md): Compare mobile game character designs head-to-head with real players and learn which character art will appeal most to your target audience.
- [Game character feedback](https://www.pickfu.com/docs/use-cases/game-character-feedback.md): Collect written feedback from mobile players on your game character art, personality, and style before locking in the final design.
- [Indie game character feedback](https://www.pickfu.com/docs/use-cases/indie-game-character-feedback.md): Collect detailed reactions from indie game players on your character art, design, and personality before you commit to the final look.
- [Indie game marketing test](https://www.pickfu.com/docs/use-cases/indie-game-marketing-test.md): Test indie game app icons, hero images, store graphics, and ad creatives with real players to find the marketing assets that drive clicks.
- [Indie game UI test](https://www.pickfu.com/docs/use-cases/indie-game-ui-test.md): Test indie game menus, HUDs, damage bars, and other UI elements with real players to discover which layout players prefer and find most intuitive.
- [Rapid App Store icon test](https://www.pickfu.com/docs/use-cases/rapid-app-store-icon-test.md): Use PickFu Rapid to test App Store icon variants for your mobile game and pick the design that drives the most taps from real iOS players.
- [Rapid App Store screenshot order test](https://www.pickfu.com/docs/use-cases/rapid-app-store-screenshot-order-test.md): Use PickFu Rapid to optimize the order of your App Store screenshots and learn which sequence drives the most installs from real mobile users.
- [Rapid game concept feedback](https://www.pickfu.com/docs/use-cases/rapid-game-concept-feedback.md): Use PickFu Rapid to validate a mobile or indie game concept with real gamers and collect quick reactions before committing development resources.
- [Rapid game video feedback](https://www.pickfu.com/docs/use-cases/rapid-game-video-feedback.md): Use PickFu Rapid to improve your game trailer, gameplay clip, or tutorial video with fast consumer feedback from real target players.
- [Business name test](https://www.pickfu.com/docs/use-cases/business-name-test.md): Validate business and brand name options with real consumers before you commit, comparing memorability, clarity, and first impressions head-to-head.
- [Digital ad test](https://www.pickfu.com/docs/use-cases/digital-ad-test.md): Test digital ad creatives, headlines, and images with target customers to learn which ad earns the most clicks before you spend on a paid campaign.
- [Domain name test](https://www.pickfu.com/docs/use-cases/domain-name-test.md): Test domain name options with real consumers and pick a URL that is memorable, easy to spell, and credible before you register and launch your site.
- [Image quality control](https://www.pickfu.com/docs/use-cases/image-quality-control.md): Run a quick PickFu check to confirm your image is error-free, on-brand, and clearly understood by a U.S. consumer audience before you publish.
- [Logo test](https://www.pickfu.com/docs/use-cases/logo-test.md): Compare logo design options head-to-head with real consumers and choose the mark that best fits your business, audience, and brand positioning.
- [Website review](https://www.pickfu.com/docs/use-cases/website-review.md): Show your website to real consumers and surface questions, points of confusion, and friction so you can refine pages before driving paid traffic.
- [Writing quality control](https://www.pickfu.com/docs/use-cases/writing-quality-control.md): Run a quick PickFu check on your text or copy to confirm it is error-free, clear, and well-received by a U.S. consumer audience before publishing.
- [YouTube thumbnail comparison](https://www.pickfu.com/docs/use-cases/youtube-thumbnail-comparison.md): Test YouTube thumbnail variants with real viewers and pick the image that earns the most clicks and improves watch-time before publishing your video.
- [Book cover comparison](https://www.pickfu.com/docs/use-cases/book-cover-comparison.md): Show two or more book cover designs to readers in your genre and pick the cover that grabs attention and signals the right tone for your audience.
- [Book cover feedback](https://www.pickfu.com/docs/use-cases/book-cover-feedback.md): Generate a heatmap and written feedback on your book cover to learn which areas readers focus on and what to refine before publishing.
- [Book description comparison](https://www.pickfu.com/docs/use-cases/book-description-comparison.md): Test short book blurbs side-by-side with target readers to learn which description is most compelling and drives sample downloads and sales.
- [Book testimonial comparison](https://www.pickfu.com/docs/use-cases/book-testimonial-comparison.md): Show readers different blurbs and endorsements for your book and choose the testimonial language that builds credibility and drives conversions.
- [Book title comparison](https://www.pickfu.com/docs/use-cases/book-title-comparison.md): Test book title options with readers in your genre and choose the title that resonates, signals the category, and earns more clicks on retailer pages.
- [Rapid ad feedback](https://www.pickfu.com/docs/use-cases/rapid-ad-feedback.md): Run a quick PickFu Rapid test on your video ad to spot weak moments and collect actionable consumer feedback before going live on paid channels.
- [Rapid copy comparison](https://www.pickfu.com/docs/use-cases/rapid-copy-comparison.md): Use PickFu Rapid to compare copy variants — headlines, taglines, product blurbs — and choose the wording that resonates with real consumers.
- [Rapid copy feedback](https://www.pickfu.com/docs/use-cases/rapid-copy-feedback.md): Use PickFu Rapid to collect quick written consumer feedback on your copy and learn what to clarify, cut, or strengthen before you publish.
- [Rapid design comparison](https://www.pickfu.com/docs/use-cases/rapid-design-comparison.md): Use PickFu Rapid to compare a set of design options side-by-side with real consumers and pick the winner with quick, actionable feedback.
- [Rapid image feedback](https://www.pickfu.com/docs/use-cases/rapid-image-feedback.md): Use PickFu Rapid to learn what works and what to improve about your image — packaging, ad, or listing photo — with quick written feedback.
- [Rapid product variant comparison](https://www.pickfu.com/docs/use-cases/rapid-product-variant-comparison.md): Use PickFu Rapid to compare product variants — colors, sizes, styles — and quickly determine the best option before ordering stock or production.
- [Which PickFu integration should I use?](https://www.pickfu.com/docs/integrations/overview.md): Compare PickFu's web app, MCP server, CLI, and REST API to choose the right way to create surveys and collect consumer feedback — by hand or in code.
- [Authenticate the PickFu CLI, MCP server, and API](https://www.pickfu.com/docs/authentication.md): Authenticate the PickFu CLI and MCP server using OAuth 2.0 or API keys, including setup for headless environments, CI pipelines, and automation.
- [PickFu MCP server for Claude, Cursor, and ChatGPT](https://www.pickfu.com/docs/integrations/mcp-server.md): Connect Claude, Cursor, ChatGPT, and other MCP clients to PickFu to create surveys, fetch results, and generate consumer insights through chat.
- [PickFu CLI for surveys and automation](https://www.pickfu.com/docs/integrations/cli.md): Install the PickFu CLI on macOS, Linux, or Windows to create surveys, fetch results, and automate polls with JSON output for CI/CD workflows.
- [Use PickFu inside OpenClaw agent skills](https://www.pickfu.com/docs/integrations/openclaw.md): Use the PickFu MCP server or CLI inside OpenClaw skills to run autonomous generate, test, and refine research loops with real consumer feedback.
- [Build with PickFu OAuth](https://www.pickfu.com/docs/integrations/build-with-oauth.md): Let your app act on a signed-in user's PickFu account with OAuth 2.0 on WorkOS AuthKit, using PKCE and RFC 7591 Dynamic Client Registration.
- [PickFu REST API reference and conventions](https://www.pickfu.com/docs/api-reference/introduction.md): Reference for the PickFu REST API, including base URL, Bearer token authentication, JSON request and response formats, and error handling.
- [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.
- [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.
- [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.
- [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.
- [Delete survey](https://www.pickfu.com/docs/api-reference/surveys/delete-survey.md): Deletes or archives a survey depending on its state:
- [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.
- [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).
- [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, `text` to search response explanations, and `traits` to filter by res…
- [List survey exports](https://www.pickfu.com/docs/api-reference/surveys/list-survey-exports.md): Returns metadata and download URLs for all export formats associated with a survey: CSV results, PDF reports, and PNG screenshots.
- [Download survey CSV export](https://www.pickfu.com/docs/api-reference/surveys/download-survey-csv-export.md): Streams the CSV export of survey responses as `text/csv`. Use the `version` query parameter to switch between the v1 and v2 CSV formats — v2 is the default.
- [Get click-test heatmap](https://www.pickfu.com/docs/api-reference/surveys/get-click-test-heatmap.md): Returns a permanent CDN URL to a rendered heatmap PNG image for a click-test question. The heatmap composites all click data onto the original question image. Results are cached in Cloudinary — subsequent requests for the same click data return instantly.
- [Send follow-up question](https://www.pickfu.com/docs/api-reference/surveys/send-follow-up-question.md): Sends a follow-up question to a specific respondent based on a completed survey response. The question is delivered to the respondent through their PickFu inbox; they may answer or decline.
- [Get follow-up answers](https://www.pickfu.com/docs/api-reference/surveys/get-follow-up-answers.md): Returns paginated follow-up answers for a survey. Each item is a respondent's reply to a follow-up question that was previously sent via `POST /v1/surveys/{id}/responses/{responseId}/followup`.
- [Rate a response](https://www.pickfu.com/docs/api-reference/responses/rate-a-response.md): Marks an individual respondent comment as helpful or not_helpful.
- [Remove a response rating](https://www.pickfu.com/docs/api-reference/responses/remove-a-response-rating.md): Removes a previously-applied helpful / not_helpful rating from a response. Returns 404 if no rating exists. Does not un-reject answers that were auto-rejected by a prior not_helpful rating.
- [Pin or unpin a response](https://www.pickfu.com/docs/api-reference/responses/pin-or-unpin-a-response.md): Pins or unpins an individual response on a survey. Pinned responses are marked as noteworthy for easy retrieval. This is idempotent — pinning an already-pinned response returns 200 with the same state.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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 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.
- [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.
- [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.
- [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).

## OpenAPI Specs

- [openapi](https://www.pickfu.com/docs/api-reference/openapi.json)

## Optional

- [PickFu](https://www.pickfu.com)
- [Support](mailto:support@pickfu.com)