Research overview
POST /v1/crawl/research fans out one query across the configured source set, merges results, and optionally synthesizes a grounded answer.
Use it when:
- one page will not answer the question
- you want citations with source URLs
- you need search, ranking, and enrichment in one call
- you want a common contract across web, communities, code, and reference sources
Research with synthesis
```bash
curl https://api.faircompany.ai/v1/crawl/research \
-X POST \
-H "Authorization: Bearer fc_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"query": "Claude Code vs Cursor for large codebases",
"sources": ["web", "reddit", "hackernews", "github"],
"depth": "default",
"synthesize": true
}'
```
```ts
const research = await fc.research({
query: "Claude Code vs Cursor for large codebases",
sources: ["web", "reddit", "hackernews", "github"],
depth: "default",
synthesize: true,
});
console.log(research.synthesis?.summary);
console.log(research.stats);
```
```python
research = fc.research(
"Claude Code vs Cursor for large codebases",
sources=["web", "reddit", "hackernews", "github"],
depth="default",
synthesize=True,
)
print(research.synthesis.summary if research.synthesis else None)
print(research.stats.total_results)
```
```json
{
"tool": "faircrawl_research",
"arguments": {
"query": "Claude Code vs Cursor for large codebases",
"sources": ["web", "reddit", "hackernews", "github"],
"depth": "default",
"synthesize": true
}
}
```