GATHER FOR DEVELOPERS
Your customer.
As an API.
Every customer-facing decision, validated before it ships. Gather answers a question about your buyers with a verdict and a confidence score your code can branch on, in minutes instead of weeks. Ship when the answer is strong. Escalate to real interviews when it is not.
REST and MCP. Bearer auth. JSON in, findings out.
A check your pipeline can read, not a report someone has to.
# Ask your buyers before the campaign goes live
curl https://synthetic.gatherhq.com/api/v1/studies \
-H "Authorization: Bearer $GATHER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"topic": "Does leading with onboarding speed beat
leading with price for this segment?",
"study_type": "messaging",
"audience_description": "Directors+ in IT and DevOps at
North American companies with 500-5,000 employees"
}'
# -> headline_finding, key_findings[], consensus_themes[],
# objections[], report_url - in one responseWHERE IT GOES IN YOUR WORKFLOW
A check that runs before you ship.
You would not ship code without a test. Every one of these decisions is normally made on a guess and measured weeks later. Put a call in front of it and the guess becomes an answer while you can still act on it.
01
Before ads go out
Score creative and hooks against the audience you are actually buying, while the budget is still movable.
02
Before emails send
Test the subject line and the offer on the segment the campaign targets, not on last quarter’s list.
03
Before the page ships
Put two positioning options in front of buyers and ship the one they can repeat back to you.
04
Before pricing changes
Find the objection and the walk-away point before the change reaches a renewal conversation.
TWO WAYS IN
Call it from your code, or hand it to your agent.
The REST API is for pipelines and product code. MCP is for Claude, Cursor and any agent that should be able to ask your customers a question on its own.
One POST, one verdict.
Bearer auth against synthetic.gatherhq.com. Every study comes back with overall_confidence, so the call is a gate your code can act on rather than a document to read.
const res = await fetch(
"https://synthetic.gatherhq.com/api/v1/studies", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.GATHER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
topic: "Which launch angle lands with CISOs?",
study_type: "messaging",
audience_description: "CISOs and VP Security at" +
" North American enterprises, 1,000+ employees",
webhook_url: "https://yourapp.com/hooks/gather",
}),
});
const study = await res.json();
console.log(study.headline_finding);
console.log(study.key_findings);
console.log(study.report_url);Your agent asks the customer.
Gather is a connector in the Claude directory. Point any MCP client at it and your agent can run real research, pull findings and cite a report without leaving the chat.
{
"mcpServers": {
"gather": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://share.gatherhq.com/api/mcp"
]
}
}
}
// Then just ask, in plain language:
//
// "Before we launch Tuesday's campaign, run a
// messaging study on mid-market IT buyers and
// tell me which angle to lead with."
//
// Sign in with your work email on first connect.
// The agent runs the research and comes back with
// findings, a confidence score and a report link.GET STARTED
Copy this. You are running in a minute.
Same call, your language. Set GATHER_API_KEY and go. The Node example shows the pattern that matters: branch on the confidence score instead of reading the answer.
# 1. See what you can ask
curl https://synthetic.gatherhq.com/api/v1/study-types \
-H "Authorization: Bearer $GATHER_API_KEY"
# 2. Run a study against your own audience
curl -X POST https://synthetic.gatherhq.com/api/v1/studies \
-H "Authorization: Bearer $GATHER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"topic": "Will a 15% increase change renewal intent?",
"study_type": "pricing",
"audience_description": "Directors+ in IT, DevOps and
Infrastructure at North American companies with
500-5,000 employees who use observability tools"
}'
# 3. Browse everything you have run
curl https://synthetic.gatherhq.com/api/v1/studies \
-H "Authorization: Bearer $GATHER_API_KEY"REFERENCE
The whole surface area.
Base URL https://synthetic.gatherhq.com. Every route takes Authorization: Bearer YOUR_API_KEY.
- POST
/api/v1/studiesRun a study. Preset audience or a natural-languageaudience_description. Returns findings, themes, objections and a report URL. - GET
/api/v1/studiesList completed studies with headline findings and report links. - GET
/api/v1/studies/{id}Fetch one study in full, including every interview response. - POST
/api/v1/researchLighter call for agents: topic plus audience, returns a markdown summary ready to paste. - POST
/api/v1/simulateRun a scenario against your brand’s own saved personas in Gather. - GET
/api/v1/personasEvery preset B2B and B2C profile, with the default sets. - GET
/api/v1/study-typesThe eleven study types: brand, product, concept, competitor, cx, pricing, messaging, winloss, churn, segmentation, custom. - MCP
share.gatherhq.com/api/mcpThe Gather connector, listed in the Claude directory. Work-email sign-in on first connect, then one conversational tool that reaches everything Gather can do.
FOUR THINGS TO BUILD FIRST
Put it in the path of a decision.
AD PRE-FLIGHT
Nothing launches unasked
In the campaign build step, run a messaging study on the audience you are about to buy. Hold the launch if the angle does not land.
creative ready → POST /studies → objections → launch or rewrite
EMAIL PRE-SEND
Subject lines that earn the send
Score two or three subject lines against the exact segment the send targets, then pass the winner to your ESP.
segment picked → POST /studies → winner → ESP
PRICING
Find the walk-away first
Run a pricing study before the change reaches a renewal call. Get the objection and the point where intent breaks.
proposed price → POST /studies → walk-away point → decide
AGENTS
Give your agent a customer
Connect over MCP and your agent stops guessing what buyers want. It asks them, then writes the brief itself.
agent task → run_research → findings → draft
START BUILDING
Your customers, one call away.
Tell us what you are building and we will issue a key and walk the first integration with you. Most teams have a study running the same day.
