Research examples
Broad comparison query
Default multi-source query
```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
}
}
```
GitHub-only
GitHub-focused query
```bash
curl https://api.faircompany.ai/v1/crawl/research \
-X POST \
-H "Authorization: Bearer fc_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"query": "vector database benchmarks site:github.com",
"sources": ["github"],
"limit": 10
}'
```
```ts
const results = await fc.research({
query: "vector database benchmarks site:github.com",
sources: ["github"],
limit: 10,
});
console.log(results.all.map((item) => item.url));
```
```python
results = fc.research(
"vector database benchmarks site:github.com",
sources=["github"],
limit=10,
)
print([item.url for item in results.all])
```
```json
{
"tool": "faircrawl_research",
"arguments": {
"query": "vector database benchmarks site:github.com",
"sources": ["github"],
"limit": 10
}
}
```
Best practice
Start with depth: "default" and a small source set. Only opt into heavier sources or enrichment when the default result set is too shallow.