Marsad Documentation

Build, operate, and understand Marsad.

Marsad supports social-media data collection, analysis, analytics, and reporting. Find product guidance, system contracts, and repository-specific implementation knowledge in one place.

New developer? Start here Browse documentation Explore user journeys

Choose your starting point

The documentation is organized by the question you need to answer and the part of Marsad you are working on.

Product

Understand Marsad’s users, capabilities, and end-to-end workflows.

System

Explore service boundaries, data flows, contracts, and operations.

Web App

Maintain the Next.js application, its data, APIs, and integrations.

Model Server

Work with processing pipelines, collectors, workers, and providers.

Common tasks

Jump straight to the guides used most often when working with Marsad.

Upload and analyze a dataset

Follow the researcher journey from data input to completed results.

Collect social-platform data

Learn the collection workflow and its asynchronous job lifecycle.

Change a service contract

Review the HTTP, queue, storage, and security rules shared by both services.

Understand the system architecture

View the C4 System Context (Level 1) and Container (Level 2) diagrams.

Develop the web app

Set up the main repository and understand its architecture and boundaries.