Research

Research is a powerful feature that allows you to conduct multi-step explorations of your data, creating comprehensive reports through iterative searches, structured organization, and cohesive content generation.

Overview

Research in Mixpeek enables deep exploration of your content through multiple connected search operations, helping users discover insights, generate reports, and synthesize information across your multimodal data.

Watch an Intro Video

Unlike standard search which focuses on finding immediate answers, Research:

Conducts multiple connected searches across your content
Organizes findings into structured reports with sections
Maintains consistent narrative and terminology across sections
Provides citations and references to source documents
Synthesizes information for comprehensive understanding

Key Features

Multi-Stage Search

Automatically breaks down complex queries into multiple targeted searches for deeper exploration

Structured Reports

Organizes findings into coherent sections with proper formatting and clear hierarchical structure

Content Synthesis

Combines information from multiple sources into cohesive narratives while maintaining accuracy

Source Citations

Properly attributes information to source documents with references and citations

Getting Started with Research

Initialize a Research Session

Start by creating a new research session with your primary query and optional parameters.

Configure Report Structure

Optionally specify the structure of the final report, including sections and organizational approach.

Monitor Progress

Research operations run asynchronously - you can monitor their progress as they explore data.

Retrieve the Report

Once complete, retrieve the structured report with all findings and references.

Research Parameters

Basic Parameters

Parameter	Type	Description
`query`	string	The primary research question or topic
`namespace`	string	Namespace to search within
`max_runtime`	integer	Maximum runtime in seconds (Default: 300)
`report_format`	string	Output format: “markdown”, “html”, or “json” (Default: “markdown”)
`depth`	string	Research depth: “quick”, “standard”, or “comprehensive” (Default: “standard”)

Advanced Parameters

Parameter	Type	Description
`structure`	object	Custom report structure definition
`collections`	array	Specific collections to include in the research
`filters`	object	Additional filters to apply to searches
`max_sources`	integer	Maximum number of source documents to consider (Default: 100)
`style_guide`	object	Style preferences for the generated report

Custom Structure Example

{
  "structure": {
    "sections": [
      {
        "title": "Introduction",
        "content": "Brief overview of the topic"
      },
      {
        "title": "Historical Context",
        "content": "Background and development of the issue"
      },
      {
        "title": "Current Research",
        "content": "Recent findings and studies"
      },
      {
        "title": "Impact Analysis",
        "content": "Effects and implications"
      },
      {
        "title": "Future Outlook",
        "content": "Projections and predictions"
      }
    ]
  }
}

Retrieving Research Results

Once the research is complete, retrieve the full report:

# Get final research report
report = client.research.get(research_id)

if report["status"] == "completed":
    # Access the full report
    content = report["content"]
    sources = report["sources"]
    
    # Save report to file
    with open("research_report.md", "w") as f:
        f.write(content)
        
    print(f"Report generated with {len(sources)} source citations")
else:
    print(f"Research still in progress: {report['progress']}% complete")

# Get final research report
report = client.research.get(research_id)

if report["status"] == "completed":
    # Access the full report
    content = report["content"]
    sources = report["sources"]
    
    # Save report to file
    with open("research_report.md", "w") as f:
        f.write(content)
        
    print(f"Report generated with {len(sources)} source citations")
else:
    print(f"Research still in progress: {report['progress']}% complete")

// Get final research report
async function getReport(researchId) {
  const report = await client.research.get(researchId);
  
  if (report.status === "completed") {
    // Access the full report
    const content = report.content;
    const sources = report.sources;
    
    // Do something with the report
    console.log(`Report generated with ${sources.length} source citations`);
    return content;
  } else {
    console.log(`Research still in progress: ${report.progress}% complete`);
    return null;
  }
}

curl -X GET "https://api.mixpeek.com/v1/research/{research_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Working with Research Reports

Research reports include both the generated content and metadata about sources:

Report Structure

{
  "id": "research_abc123",
  "status": "completed",
  "query": "Impact of climate change on agriculture",
  "content": "# Impact of Climate Change on Agriculture\n\n## Introduction\n...",
  "format": "markdown",
  "sources": [
    {
      "id": "doc_123",
      "title": "Climate Effects on Global Crop Yields",
      "collection": "research_papers",
      "relevance_score": 0.92,
      "citations": [
        {
          "section": "Introduction",
          "position": "paragraph_2"
        }
      ]
    },
    // More sources...
  ],
  "sections": [
    {
      "title": "Introduction",
      "word_count": 312,
      "sources_used": ["doc_123", "doc_456"]
    },
    // More sections...
  ],
  "metadata": {
    "completion_time": "2023-06-15T09:12:33Z",
    "total_runtime": 1632,
    "searches_performed": 28,
    "documents_analyzed": 142
  }
}

Citation Formats

Research reports can include citations in different formats:

# Request specific citation format
report = client.research.get(
    research_id, 
    citation_format="apa"  # Options: apa, mla, chicago, ieee
)

The citation format affects how sources are referenced in the report content.

Use Cases

Competitor Analysis

Generate comprehensive reports on competitors, their products, market positioning, and strategies

Literature Review

Create structured summaries of academic or industry literature on specific topics

Market Research

Conduct in-depth analysis of market trends, customer preferences, and industry developments

Product Documentation

Generate comprehensive documentation from technical content, user feedback, and support data

Best Practices

Craft Specific Queries

Provide Structure for Complex Topics

Combine with Taxonomies

Monitor and Iterate

Limitations

Session Duration: Research sessions have a maximum runtime of 1 hour (Enterprise tier)
Report Size: Maximum report size is 100,000 words
Source Constraints: A maximum of 500 sources can be cited in a single report
Processing Tiers: Research depth affects both quality and processing time:
- Quick Mode: 1-3 minutes, surface-level exploration
- Standard Mode: 5-10 minutes, moderately detailed
- Comprehensive Mode: 15-60 minutes, highly detailed with extensive sources

Overview

Data Management

Data Processing

Search & Retrieval

Data Enrichment

Troubleshooting

Overview

Key Features

Multi-Stage Search

Structured Reports

Content Synthesis

Source Citations

Getting Started with Research

Research Parameters

Retrieving Research Results

Working with Research Reports

Use Cases

Competitor Analysis

Literature Review

Market Research

Product Documentation

Best Practices

Limitations

Overview

Data Management

Data Processing

Search & Retrieval

Data Enrichment

Troubleshooting

​Overview

​Key Features

Multi-Stage Search

Structured Reports

Content Synthesis

Source Citations

​Getting Started with Research

​Research Parameters

​Retrieving Research Results

​Working with Research Reports

​Use Cases

Competitor Analysis

Literature Review

Market Research

Product Documentation

​Best Practices

​Limitations

Overview

Key Features

Getting Started with Research

Research Parameters

Retrieving Research Results

Working with Research Reports

Use Cases

Best Practices

Limitations