Frill API Overview

The Frill API lets you programmatically interact with your Frill data—create ideas, post announcements, fetch comments, manage votes, and more. It's a REST API using JSON, designed for building custom integrations, automations, and workflows.

What you can do with the API

The API gives you programmatic access to:

• Ideas — Create, read, update, delete feedback and feature requests

• Announcements — Publish changelog entries and updates

• Comments — Read and post comments on ideas and announcements

• Votes — Track and manage user votes on ideas

• Statuses — Manage idea statuses (planned, in progress, completed, etc.)

• Topics — Organize ideas and announcements by category

• Followers — Manage user subscriptions to ideas

API vs. Frill Script

Frill Script (JavaScript widget) — Embeds Frill UI on your website for end users to submit feedback, vote, and browse your roadmap. No coding required beyond installation.

Frill API (REST endpoints) — For developers building custom integrations, syncing data with other tools, or automating workflows. Requires API authentication and code.

Most teams use both: the Script for customer-facing features, the API for backend automation and integrations.

Authentication

API requests require an API key. You'll pass this key in the Authorization header as a Bearer token:

Authorization: Bearer YOUR_API_KEY

Generate API keys in your Frill dashboard under Settings > API Keys.

Base URL and format

All API requests use this base URL:

https://api.frill.co/v1/

Requests and responses use JSON. Always include:

Content-Type: application/json
Accept: application/json

Rate limits and pagination

The API uses cursor-based pagination for list endpoints. Responses include pagination metadata with hasNextPage and endCursor fields.

Default limit: 20 items per page. Maximum: 100 items per page.

Common use cases

• Sync ideas to your project management tool (Jira, Linear, Asana) when they reach a certain status

• Automate announcements when you deploy new releases or tag commits

• Import feedback from other sources (email, Slack, support tickets) into Frill

• Build custom dashboards showing vote counts, trending ideas, or announcement engagement

• Trigger workflows when users comment or vote on specific ideas

Next steps

Ready to start building? See Getting started with the Frill API for your first API call, or jump to API Authentication for details on API keys and security.