How monika-kompal/instagram-search works
Instagram Search is a Spring-based API for importing Instagram-post data and finding posts through keyword, natural-language, semantic, and hybrid search, with autocomplete and analytics. The principal search flow runs from an API controller through query parsing or search services to Elasticsearch-backed post data and returns ranked results. Separate indexing and import endpoints support the search corpus. Source excerpts establish several service calls and Elasticsearch operations; other controller-to-service links are supported by the source index. The README is empty, so capability coverage is based on the tree and sampled sources.
Main entry points: VectorSearchService.java Semantic search · VectorSearchController.java Vector API · InstagramPostService.java Keyword search · AiSearchController.java Natural query API
Components 23
API endpoints
- Keyword search API
instagramsearch/src/main/java/com/monika/instagramsearch/controller/InstagramPostController.java - Natural query API
instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java - Hybrid search API
instagramsearch/src/main/java/com/monika/instagramsearch/controller/HybridSearchController.java - Vector API
instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java - Import API
instagramsearch/src/main/java/com/monika/instagramsearch/controller/DataImportController.java - Autocomplete API
instagramsearch/src/main/java/com/monika/instagramsearch/controller/AutoCompleteController.java - Analytics API
instagramsearch/src/main/java/com/monika/instagramsearch/controller/AggregationController.java
Search and discovery
- Keyword search
instagramsearch/src/main/java/com/monika/instagramsearch/service/InstagramPostService.java - Hybrid ranking
instagramsearch/src/main/java/com/monika/instagramsearch/service/HybridSearchService.java - Suggestions
instagramsearch/src/main/java/com/monika/instagramsearch/service/AutoCompleteService.java - Post analytics
instagramsearch/src/main/java/com/monika/instagramsearch/service/AggregationService.java
AI and vectors
- Query parsing
instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/AiQueryParserService.java - Parsed query fields
instagramsearch/src/main/java/com/monika/instagramsearch/dto/ParsedQueryDto.java - Embedding generation
instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/EmbeddingService.java - Semantic search
instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java
Post data and indexing
- Data import
instagramsearch/src/main/java/com/monika/instagramsearch/service/DataImportService.java - Post repository
instagramsearch/src/main/java/com/monika/instagramsearch/repository/InstagramPostRepository.java - Post document
instagramsearch/src/main/java/com/monika/instagramsearch/document/InstagramPostDocument.java - Vector document
instagramsearch/src/main/java/com/monika/instagramsearch/document/InstagramPostVectorDocument.java
Other components
- API client
- Anthropic API
- Embedding API
- Elasticsearch
Connections 32
- API client → Keyword search API: searches
instagramsearch/src/main/java/com/monika/instagramsearch/controller/InstagramPostController.java - API client → Natural query API: submits query
instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java - API client → Hybrid search API: searches
instagramsearch/src/main/java/com/monika/instagramsearch/controller/HybridSearchController.java - API client → Vector API: searches
instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java - API client → Import API: imports data
instagramsearch/src/main/java/com/monika/instagramsearch/controller/DataImportController.java - API client → Autocomplete API: requests suggestions
instagramsearch/src/main/java/com/monika/instagramsearch/controller/AutoCompleteController.java - API client → Analytics API: requests analytics
instagramsearch/src/main/java/com/monika/instagramsearch/controller/AggregationController.java - Keyword search API → Keyword search: calls
instagramsearch/src/main/java/com/monika/instagramsearch/controller/InstagramPostController.java - Natural query API → Query parsing: parses query
instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java - Natural query API → Keyword search: searches posts
instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java - Query parsing → Parsed query fields: produces
instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/AiQueryParserService.java - Query parsing → Anthropic API: requests parsing
instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/AiQueryParserService.java - Hybrid search API → Hybrid ranking: calls
instagramsearch/src/main/java/com/monika/instagramsearch/controller/HybridSearchController.java - Hybrid ranking → Keyword search: gets keyword results
instagramsearch/src/main/java/com/monika/instagramsearch/service/HybridSearchService.java - Hybrid ranking → Semantic search: gets vector results
instagramsearch/src/main/java/com/monika/instagramsearch/service/HybridSearchService.java - Vector API → Semantic search: searches and indexes
instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java - Vector API → Post repository: loads posts
instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java - Vector API → Embedding generation: generates embeddings
instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java - Semantic search → Embedding generation: generates vectors
instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java - Embedding generation → Embedding API: requests embeddings
instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/EmbeddingService.java - Semantic search → Vector document: creates and searches
instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java - Keyword search → Elasticsearch: searches posts
instagramsearch/src/main/java/com/monika/instagramsearch/service/InstagramPostService.java - Autocomplete API → Suggestions: calls
instagramsearch/src/main/java/com/monika/instagramsearch/controller/AutoCompleteController.java - Suggestions → Elasticsearch: searches suggestions
instagramsearch/src/main/java/com/monika/instagramsearch/service/AutoCompleteService.java - Analytics API → Post analytics: calls
instagramsearch/src/main/java/com/monika/instagramsearch/controller/AggregationController.java - Post analytics → Elasticsearch: aggregates posts
instagramsearch/src/main/java/com/monika/instagramsearch/service/AggregationService.java - Semantic search → Elasticsearch: queries and saves vectors
instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java - Import API → Data import: calls
instagramsearch/src/main/java/com/monika/instagramsearch/controller/DataImportController.java - Data import → Post document: builds posts
instagramsearch/src/main/java/com/monika/instagramsearch/service/DataImportService.java - Post repository → Post document: stores records
instagramsearch/src/main/java/com/monika/instagramsearch/repository/InstagramPostRepository.java - Post repository → Elasticsearch: persists posts
- Vector document → Elasticsearch: vector index