← Screenwise API
Linear Integration

Your Screenwise API integration, planned as Linear issues.

Adding WISE scores to a review site, store, library app or AI assistant is about eight tasks. Connect Linear, answer three questions, and Screenwise writes those tasks into your team. When the API changes or your key nears its limit, a new issue shows up there too.

Checking for a Linear connection…

Two things land in Linear: the plan once, and updates when they matter.

The plan

A parent issue and up to nine sub-issues, in the order the work happens. Each one carries the endpoint, the request, the rule that trips people up (send the year, trust 0.75 and up) and a done-when line.

API changes

When Screenwise adds a field worth using, a new MCP tool, or deprecates something, your team gets a sub-issue under the plan with what changed and what to do. Internal changes that touch nothing you call stay out.

Key health

If the API key registered to your Linear email uses 80% of its daily quota, or is revoked, you get an issue with the numbers and the fix before your users see a 429.

Questions developers ask

What does the Screenwise Linear integration do?

It turns the Screenwise API docs into a plan in your Linear team. You answer three questions (what you are building, which media types you show, how scores should appear) and Screenwise creates one parent issue with sub-issues for each step: get an API key, match your titles to Screenwise slugs, fetch and cache WISE data, show badges or parent guidance, connect the MCP server if you are building an assistant, report missing titles, and QA. After that it adds sub-issues when the API changes or when your API key nears its daily quota or is revoked.

What permissions does it ask for?

Read and issues:create. Read lists your teams so you can pick one. Linear's issues:create scope allows creating and updating issues and their attachments; Screenwise only ever creates new issues and link attachments under its own plan. It cannot delete issues, comment, or change workspace settings.

Do I need a Screenwise account?

No. Your Linear workspace is the identity. If you request a Screenwise API key with the same email as your Linear account, Screenwise can also warn you in Linear when that key nears its daily quota.

How often does Screenwise add issues?

Only when there is something to do: an API change worth acting on, your key using 80% or more of its daily quota, or your key being revoked. Each item is filed once. You can switch follow-ups off on this page.

How do I disconnect it?

Click Disconnect on this page, or in Linear open Settings, then Applications, find Screenwise and revoke access. Issues already created stay in your workspace.

New to the API? Start with the Screenwise API docs.