A hybrid semantic + keyword search API for research documents powered by OpenSearch and SPECTER2 embeddings.
\nHybrid Search: Combines BM25 keyword search with SPECTER2 semantic embeddings
\nN-gram Analyzers: Partial matching on author names, subject areas, and fields
\nFaceted Search: Filter by year, document type, field, and subject area
\nFlexible Sorting: Sort by relevance, date, or citations
\nLocal: http://localhost:3000/api/v1
Production: Update the http://localhost:3000/api/v1 variable
No authentication required for search endpoints.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Research Search API","slug":"research-search-api"}],"owner":"32690520","collectionId":"633053d4-3a0a-4092-b139-d0a1aa152db9","publishedId":"2sB3dWqmb1","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-20T07:27:46.000Z"},"item":[{"name":"Search","item":[{"name":"Hybrid Search","id":"667e1750-4f3a-4f04-97c4-168668a4e15e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"query\": \"polymer degradation\",\n \"page\": 1,\n \"per_page\": 20,\n \"sort\": \"relevance\"\n}"},"url":"http://localhost:3000/api/v1/search","description":"Search research documents using a combination of BM25 keyword matching and SPECTER2 semantic embeddings.
\nReturns matching documents with facets for filtering and pagination info.
\n","urlObject":{"path":["search"],"host":["http://localhost:3000/api/v1"],"query":[],"variable":[]}},"response":[{"id":"aac3d52f-1908-4cd8-99d9-2b24f9e3289d","name":"Success - Results Found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"query\": \"polymer\"\n}"},"url":"http://localhost:3000/api/v1/search"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"results\": [\n {\n \"_id\": \"693ea76583acace877692939\",\n \"title\": \"Interaction potential between polymer grafted nanosheets\",\n \"abstract\": \"We examine the polymer mediated interaction...\",\n \"authors\": [\n {\n \"author_name\": \"Chokshi, P.\",\n \"author_affiliation\": \"Indian Institute of Technology Delhi\"\n }\n ],\n \"publication_year\": 2019,\n \"document_type\": \"Article\",\n \"field_associated\": \"Chemical Engineering\",\n \"citation_count\": 6\n }\n ],\n \"facets\": {\n \"years\": [{\"value\": 2024, \"count\": 79}],\n \"document_types\": [{\"value\": \"Article\", \"count\": 150}],\n \"fields\": [{\"value\": \"Chemical Engineering\", \"count\": 45}]\n },\n \"pagination\": {\n \"page\": 1,\n \"per_page\": 20,\n \"total\": 250,\n \"total_pages\": 13\n },\n \"cacheHit\": false\n}"}],"_postman_id":"667e1750-4f3a-4f04-97c4-168668a4e15e"},{"name":"Search with Filters","id":"39ef9f14-6199-4d44-a775-bc1c603f952e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"query\": \"machine learning\",\n \"page\": 1,\n \"per_page\": 10,\n \"sort\": \"citations\",\n \"filters\": {\n \"year_from\": 2020,\n \"year_to\": 2024,\n \"field_associated\": \"Computer Science\",\n \"document_type\": \"Article\"\n }\n}"},"url":"http://localhost:3000/api/v1/search","description":"Search with year range, field, and document type filters applied.
\nSearch specifically in author names using N-gram partial matching.
\nThe API uses N-gram analyzers (2-4 characters) for partial matching:
\nsearch_in Optionsauthor - Author names onlytitle - Paper titles onlyabstract - Abstracts onlysubject_area - Subject areasfield - Associated fieldsSearch specifically in subject areas and associated fields.
\nSearching \"Eng\" will match:
\nYou can search in multiple fields by providing an array:
\n\"search_in\": [\"subject_area\", \"field\"]\nCheck the health status of search services including:
\nReturns status of all dependent services.
\n","urlObject":{"path":["search","health"],"host":["http://localhost:3000/api/v1"],"query":[],"variable":[]}},"response":[{"id":"c2e2701d-c785-41f8-a738-de7f78222a6d","name":"Healthy","originalRequest":{"method":"GET","header":[],"url":"http://localhost:3000/api/v1/search/health"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"healthy\",\n \"services\": {\n \"opensearch\": \"connected\",\n \"embedding\": \"available\",\n \"redis\": \"connected\"\n }\n}"}],"_postman_id":"abab03f2-3070-4510-afe3-c10ca2aeffec"}],"id":"437c1f79-a1a0-4a43-aaa7-6af642fc369e","description":"Search endpoints for finding research documents
\n","_postman_id":"437c1f79-a1a0-4a43-aaa7-6af642fc369e"},{"name":"Documents","item":[{"name":"Get Document by ID","id":"4d656f94-c21d-4067-82e6-cf9185251321","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/v1/document/:id","description":"Retrieve a single research document by its ID.
\nReturns full document details including:
\nMongoDB ObjectId or OpenSearch document ID
\n","type":"text/plain"},"type":"any","value":"693ea76583acace877692939","key":"id"}]}},"response":[{"id":"8f90acf8-d14e-48ad-8665-8f41af393a8b","name":"Document Found","originalRequest":{"method":"GET","header":[],"url":"http://localhost:3000/api/v1/document/693ea76583acace877692939"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"document\": {\n \"_id\": \"693ea76583acace877692939\",\n \"title\": \"Interaction potential between polymer grafted nanosheets\",\n \"abstract\": \"We examine the polymer mediated interaction between two brush coated nanosheets...\",\n \"authors\": [\n {\n \"author_name\": \"Chokshi, P.\",\n \"author_email\": \"paresh@chemical.iitd.ac.in\",\n \"author_affiliation\": \"Indian Institute of Technology Delhi\"\n }\n ],\n \"publication_year\": 2019,\n \"document_type\": \"Article\",\n \"field_associated\": \"Chemical Engineering\",\n \"citation_count\": 6,\n \"subject_area\": [\"Chemical Engineering\", \"Materials Science\"]\n }\n}"},{"id":"567aee06-fd17-4fa4-af0f-90aa20e0f24b","name":"Document Not Found","originalRequest":{"method":"GET","header":[],"url":"http://localhost:3000/api/v1/document/invalid-id"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Not Found\",\n \"message\": \"Document not found\",\n \"statusCode\": 404\n}"}],"_postman_id":"4d656f94-c21d-4067-82e6-cf9185251321"},{"name":"Get Documents by Author","id":"5d35a96d-dce9-4a15-9766-4db72896880d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/v1/documents/by-author/:authorId?page=1&per_page=20","description":"Retrieve all research documents published by a specific author.
\nReturns paginated list of documents by the author.
\n","urlObject":{"path":["documents","by-author",":authorId"],"host":["http://localhost:3000/api/v1"],"query":[{"description":{"content":"Page number (default: 1)
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Results per page (1-100, default: 20)
\n","type":"text/plain"},"key":"per_page","value":"20"}],"variable":[{"id":"7f9eb7c4-bc85-4435-8f9b-036459cda6da","description":{"content":"Scopus Author ID
\n","type":"text/plain"},"type":"any","value":"22952938400","key":"authorId"}]}},"response":[],"_postman_id":"5d35a96d-dce9-4a15-9766-4db72896880d"}],"id":"38bb7170-3db1-4619-b587-cb60ef144221","description":"Endpoints for retrieving individual documents
\n","_postman_id":"38bb7170-3db1-4619-b587-cb60ef144221"},{"name":"Server","item":[{"name":"Server Health","id":"f4a47ae5-081c-494a-8d6b-a91dfd1b67a0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/v1/../health","description":"Check overall server health status.
\nGET /health
Returns server status and uptime information.
\n","urlObject":{"path":["..","health"],"host":["http://localhost:3000/api/v1"],"query":[],"variable":[]}},"response":[{"id":"521933c8-9d14-4a34-85d3-bc58e5a2939e","name":"Healthy","originalRequest":{"method":"GET","header":[],"url":"http://localhost:3000/health"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"healthy\"\n}"}],"_postman_id":"f4a47ae5-081c-494a-8d6b-a91dfd1b67a0"}],"id":"3e150f20-f635-4c6b-9bcc-96695b5bfb02","description":"Server health and status endpoints
\n","_postman_id":"3e150f20-f635-4c6b-9bcc-96695b5bfb02"}],"variable":[{"key":"base_url","value":"http://localhost:3000/api/v1","type":"string"}]}