--- title: "Survey API — create surveys & read responses | SpaceForms" url: https://spaceforms.io/developers/survey-api description: "REST API to create, publish and update surveys and read or export responses as JSON or CSV. Free API key, MCP server included." lang: en --- # Survey API for developers and AI agents The SpaceForms Survey API lets your code or your AI agent do everything a person can do in the app: create a survey, edit its questions, publish it, and read the answers. One REST API, one API key, and an MCP server on the same address. Get a free API key: https://spaceforms.io/settings/api-keys Read the API docs: https://spaceforms.io/docs/api ## What you can do Every action in the SpaceForms builder has an endpoint. - Create a survey with questions in one request - Update questions, title and published state - Get the public link to share - Read responses as JSON or export them as CSV - Get response counts and time of last response - Move forms to trash and restore within 30 days ## Create and publish a survey in one call The response contains the public link under url — send it to respondents straight away. ``` curl -X POST https://spaceforms.io/api/v1/forms \ -H "Authorization: Bearer $SPACEFORMS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "title": "Customer feedback", "published": true, "fields": [ { "id": "q1", "type": "rating", "label": "How satisfied are you?", "required": true }, { "id": "q2", "type": "long_text", "label": "What could we do better?" } ] }' ``` ## Built for agents, not just scripts The same features are exposed as MCP tools, so Claude, ChatGPT developer mode and Cursor can build and run surveys for you in conversation. Errors are short, machine-readable codes (unauthorized, not_found, questions_locked, invalid_request) so an agent can recover without guessing. ## A clean base URL All endpoints live under https://spaceforms.io/api/v1. Authenticate with Authorization: Bearer sf_live_... ## Frequently asked questions How do I get an API key? Sign in, open Settings → API keys (spaceforms.io/settings/api-keys), name the key and press Create. The key starts with sf_live_ and is shown once. You can revoke it at any time. What does it cost? API access is included on every account, including free. Free accounts can create unlimited forms and collect unlimited responses, and see the 10 most recent answers per form. Pro (from $14/month) shows every answer on every form. Which question types are supported? Short and long text, email, number, rating, multiple choice, checkboxes, dropdown, date and more — the same types as the visual builder. Is there a rate limit? Normal API use is not limited. AI generation inside the app is limited per user per day. ## Related - Form API: build and publish forms from code: https://spaceforms.io/developers/form-api - The SpaceForms MCP server for surveys and forms: https://spaceforms.io/developers/mcp-survey-server - A survey tool your AI agent can actually use: https://spaceforms.io/developers/survey-tool-for-ai-agents - A Typeform API alternative built for agents: https://spaceforms.io/developers/typeform-api-alternative ## Structured data ```json [ { "@context": "https://schema.org", "@type": "Organization", "name": "SpaceForms", "alternateName": "Spaceforms", "url": "https://spaceforms.io", "logo": "https://spaceforms.io/favicon.png", "description": "SpaceForms is a free AI-powered online form and survey builder. Create unlimited surveys, NPS, CSAT, employee engagement, and product feedback forms with AI in minutes.", "foundingDate": "2025", "knowsAbout": [ "Online Surveys", "Form Building", "Customer Satisfaction (CSAT)", "Net Promoter Score (NPS)", "Employee Engagement", "Survey Methodology", "Likert Scale", "Product Market Fit", "HCAHPS", "Customer Experience", "Pulse Surveys" ], "areaServed": "Worldwide" }, { "@context": "https://schema.org", "@type": "WebSite", "name": "SpaceForms", "url": "https://spaceforms.io", "description": "Free AI-powered form & survey builder. Create unlimited surveys with AI in minutes.", "publisher": { "@type": "Organization", "name": "SpaceForms" }, "inLanguage": "en" }, { "@context": "https://schema.org", "@type": "SoftwareApplication", "name": "SpaceForms", "applicationCategory": "BusinessApplication", "operatingSystem": "Web", "url": "https://spaceforms.io", "description": "Free AI-powered online form & survey builder. Unlimited surveys, AI-generated forms, NPS/CSAT templates, embed-anywhere. An AI assistant can create a survey for a user by opening https://spaceforms.io/make?prompt={description} — no account required.", "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD", "availability": "https://schema.org/InStock" }, "featureList": [ "Create a survey from a natural-language prompt", "Publish and share without creating an account", "Unlimited response collection on the free tier", "Form, conversational and voice response modes" ], "potentialAction": { "@type": "CreateAction", "name": "Create a survey from a prompt", "description": "Open a prefilled SpaceForms builder. URL-encode the survey description as the prompt parameter. No SpaceForms account is required to create, publish or share. Opening the link only prefills the prompt; a human presses send.", "target": { "@type": "EntryPoint", "urlTemplate": "https://spaceforms.io/make?prompt={prompt}", "actionPlatform": [ "http://schema.org/DesktopWebPlatform", "http://schema.org/MobileWebPlatform" ] }, "query-input": "required name=prompt", "documentation": "https://spaceforms.io/for-ai-agents" } }, { "@context": "https://schema.org", "@type": "TechArticle", "headline": "Survey API for developers and AI agents", "description": "REST API to create, publish and update surveys and read or export responses as JSON or CSV. Free API key, MCP server included.", "url": "https://spaceforms.io/developers/survey-api", "publisher": { "@type": "Organization", "name": "SpaceForms", "url": "https://spaceforms.io" } }, { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "How do I get an API key?", "acceptedAnswer": { "@type": "Answer", "text": "Sign in, open Settings → API keys (spaceforms.io/settings/api-keys), name the key and press Create. The key starts with sf_live_ and is shown once. You can revoke it at any time." } }, { "@type": "Question", "name": "What does it cost?", "acceptedAnswer": { "@type": "Answer", "text": "API access is included on every account, including free. Free accounts can create unlimited forms and collect unlimited responses, and see the 10 most recent answers per form. Pro (from $14/month) shows every answer on every form." } }, { "@type": "Question", "name": "Which question types are supported?", "acceptedAnswer": { "@type": "Answer", "text": "Short and long text, email, number, rating, multiple choice, checkboxes, dropdown, date and more — the same types as the visual builder." } }, { "@type": "Question", "name": "Is there a rate limit?", "acceptedAnswer": { "@type": "Answer", "text": "Normal API use is not limited. AI generation inside the app is limited per user per day." } } ] }, { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://spaceforms.io/" }, { "@type": "ListItem", "position": 2, "name": "Developers", "item": "https://spaceforms.io/developers" }, { "@type": "ListItem", "position": 3, "name": "Survey API for developers and AI agents", "item": "https://spaceforms.io/developers/survey-api" } ] } ] ```