Skip to main content
URL parameters let you create PickFu survey links with pre-filled questions, options, targeting, and settings. Embed these links in your application to let users launch polls without manual configuration.

​
Use cases

  • SaaS platforms — Add a “Test with PickFu” button that opens a poll pre-filled with the user’s content
  • Internal tools — Automate poll creation from dashboards or admin panels
  • Custom workflows — Generate poll links programmatically from scripts or CI/CD pipelines

​
Base URL

https://app.pickfu.com/ask/survey?
Add parameters after the ?, separated by &.

​
Quick example

https://app.pickfu.com/ask/survey?
  q1-prompt=Which+logo+is+better?
  &q1-type=head_to_head
  &q1-o1-media_url=https://example.com/logo-a.png
  &q1-o2-media_url=https://example.com/logo-b.png
  &targeting=25-34,female
  &sample_size=50
  &country=US

​
Parameter reference

​
Questions

ParameterDescriptionExample
q1-promptQuestion text (URL-encoded)q1-prompt=Which+is+better?
q1-typePoll typeq1-type=head_to_head
Use q1, q2, q3 etc. for multi-question surveys.

​
Options

ParameterDescriptionExample
q1-o1-valueText optionq1-o1-value=Option+A
q1-o1-media_urlImage or video URLq1-o1-media_url=https://...
q1-o1-asinAmazon product ASINq1-o1-asin=B08N5WRWNW
q1-o1-image_setMultiple images (comma-separated)q1-o1-image_set=url1,url2
Use o1, o2, o3 etc. for multiple options.

​
Question context

ParameterDescription
q1-context-textExplanatory text shown with the question
q1-context-media_urlReference image or video shown with the question

​
Targeting and settings

ParameterDescriptionExample
country2-letter country codecountry=US
targetingComma-separated trait permalinkstargeting=25-34,female,amznpr
reportingDemographic breakdowns to collectreporting=age,gender,income
sample_sizeNumber of respondentssample_size=50

​
Supported poll types

TypeParameterOptions required
Head-to-headhead_to_head2
Rankedranked3-8
Open-endedopen_ended0-1
Star ratingstar_rating0-1
Emoji ratingemoji_rating0-1
Single selectsingle_select3-8
Multi selectmulti_select3-8
Click testclick_test1
Five-second testfive_second_test1

​
Special parameters

ParameterDescriptionExample
copy_fromDuplicate an existing survey by GUIDcopy_from=ABC123

​
Building URLs programmatically

URL-encode special characters in parameter values:
CharacterEncoded
Space+ or %20
&%26
?%3F
=%3D
Example in JavaScript: 
function buildPollUrl({ question, type, options, targeting, sampleSize }) {
  const params = new URLSearchParams();
  params.set('q1-prompt', question);
  params.set('q1-type', type);
  options.forEach((opt, i) => {
    params.set(`q1-o${i + 1}-value`, opt);
  });
  if (targeting) params.set('targeting', targeting.join(','));
  if (sampleSize) params.set('sample_size', String(sampleSize));
  return `https://app.pickfu.com/ask/survey?${params.toString()}`;
}

​
URL parameters vs. REST API

URL parametersREST API
Best forLaunching polls from a UIFull programmatic control
Auth requiredNo (user signs in on PickFu)Yes (API key or OAuth)
Creates draftYes (user reviews before publishing)Yes (publish separately)
Error handlingVisual (PickFu shows validation errors)Structured JSON errors
Retrieves resultsNoYes
Use URL parameters when you want users to review and publish polls themselves. Use the REST API when you need full automation.
For a comprehensive guide with more examples and troubleshooting, see the help center article on URL parameters.