For Agents
Run federated search and structural queries across the eNanoMapper nanomaterial database network, retrieving substances, studies, and similarity matches.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the eNanoMapper federated search, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with eNanoMapper federated search API.
Run free-text search across federated nanomaterial databases via /select
Retrieve substance records, including composition and structures, by UUID
Pull study summaries attached to a specific substance for hazard assessment
Run SMARTS substructure queries through /enm/{db}/query/smarts
GET STARTED
Use for: Search the eNanoMapper databases for studies on titanium dioxide nanoparticles, Retrieve a substance record by its UUID, Find substances structurally similar to a reference compound, List all studies attached to a given substance
Not supported: Does not handle laboratory data ingestion, regulatory submission filing, or chemical synthesis planning — use for read-only federated search across nanomaterial databases only.
eNanoMapper is a federated search service over a network of nanomaterial safety databases curated by IdeaConsult. The API exposes 13 endpoints covering free-text search, substance lookup, study and structural queries, similarity search via SMARTS patterns, and faceted browsing across the project corpus. It is designed for researchers building agent-driven literature reviews, regulatory dossiers, or hazard assessments that need consolidated access to nanomaterial data without scraping individual database websites.
Find chemically similar substances via /enm/{db}/query/similarity
Browse investigations and study collections within a specific database
Use faceted filters to narrow large result sets by study type, endpoint, or organism
Patterns agents use eNanoMapper federated search API for, with concrete tasks.
★ Nanomaterial Literature Review
Researchers compile a literature review on a class of nanomaterials by running federated free-text searches across eNanoMapper databases via /select, then pulling study summaries for each matched substance. The API removes the need to manually search and reconcile records across separate database UIs.
Call GET /select with q=titanium+dioxide and aggregate matched substances, then for each call GET /enm/{db}/substance/{uuid}/studySummary
Substructure-Based Substance Discovery
Find substances containing a specific functional group or structural motif using SMARTS pattern matching. The /query/smarts endpoint accepts a SMARTS string and returns matching substances, useful for grouping nanomaterials by surface chemistry or coating type before downstream analysis.
Call GET /enm/{db}/query/smarts with a SMARTS pattern and return all matching substances with their UUIDs
Read-Across Similarity Lookup
Identify analog substances for a regulatory read-across argument by querying chemical similarity. The /query/similarity endpoint returns substances ranked by structural similarity to a reference compound, supporting hazard assessment when direct test data is sparse.
Submit a reference compound to GET /enm/{db}/query/similarity and rank the top 20 analogs by similarity score
AI Agent Regulatory Dossier
A regulatory agent uses Jentic to find eNanoMapper operations matching 'gather nanomaterial study data', loads the substance and studySummary schemas, and assembles a structured dossier for a substance. The agent saves the regulator hours of manual database navigation.
Use Jentic search 'gather nanomaterial study data' to load the eNanoMapper studySummary schema, then execute it for a substance UUID
13 endpoints — enanomapper is a federated search service over a network of nanomaterial safety databases curated by ideaconsult.
METHOD
PATH
DESCRIPTION
/select
Free-text federated search across the eNanoMapper corpus
/enm/{db}/substance
List substances within a specific database
/enm/{db}/substance/{uuid}
Retrieve a substance record by UUID
/enm/{db}/substance/{uuid}/study
List studies attached to a substance
/enm/{db}/substance/{uuid}/studySummary
Aggregated study summary for a substance
/enm/{db}/query/smarts
Substructure search using SMARTS patterns
/enm/{db}/query/similarity
Find structurally similar substances
/select
Free-text federated search across the eNanoMapper corpus
/enm/{db}/substance
List substances within a specific database
/enm/{db}/substance/{uuid}
Retrieve a substance record by UUID
/enm/{db}/substance/{uuid}/study
List studies attached to a substance
/enm/{db}/substance/{uuid}/studySummary
Aggregated study summary for a substance
Three things that make agents converge on Jentic-routed access.
Credential isolation
eNanoMapper does not require API credentials for read access. Jentic still proxies the call so audit logs, quotas, and user attribution are consistent with secured APIs in the same agent — no special handling is needed in client code.
Intent-based discovery
Agents search by intent (e.g., 'search nanomaterial databases') and Jentic returns the eNanoMapper /select and /query operations with their input schemas, so the agent can compose queries without learning the path conventions by hand.
Time to first call
Direct eNanoMapper integration: 2-3 days to learn the {db} path conventions and structural query parameters. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
NANoREG federated search
Sister API exposing the same federated search interface against the NANoREG nanomaterial dataset
Choose NANoREG when the agent specifically needs the NANoREG project corpus rather than the broader eNanoMapper view.
EBI API
European Bioinformatics Institute APIs covering molecular and chemical reference data
Use EBI alongside eNanoMapper when an agent needs broader chemical or biological reference data to enrich nanomaterial substance records.
Clarivate API
Scientific literature and citation data that pairs with eNanoMapper substance records
Use Clarivate alongside eNanoMapper when a literature review needs to cross-reference cited papers for substances returned from the federated search.
Specific to using eNanoMapper federated search API through Jentic.
What authentication does the eNanoMapper federated search API use?
The eNanoMapper federated search API does not declare an authentication scheme in its OpenAPI spec — endpoints are publicly readable for the project corpus. Through Jentic, requests are still routed and logged so agents can be governed centrally even on open APIs.
Can I run substructure searches against eNanoMapper?
Yes. GET /enm/{db}/query/smarts accepts a SMARTS pattern and returns substances whose structures match the substructure. This is useful for grouping nanomaterials by functional group or coating before downstream similarity or hazard analysis.
What are the rate limits for the eNanoMapper API?
The IdeaConsult-hosted eNanoMapper service does not publish hard rate limits in the OpenAPI spec. Federated queries can be expensive — design agents to back off on slow responses, prefer faceted filtering before deep result iteration, and use the task service endpoints for long-running similarity searches.
How do I run a federated nanomaterial search through Jentic?
Run pip install jentic and import the SDK, then await client.search('search nanomaterial databases') to find the eNanoMapper /select operation. Load the schema and execute with a query string and any database filters. Sign up at https://app.jentic.com/sign-up for an API key.
Which databases does eNanoMapper search?
eNanoMapper federates across the project's nanomaterial databases hosted at api.ideaconsult.net. The path parameter {db} selects which database to query — for the eNanoMapper main view, that is the eNanoMapper database; for NANoREG data, the sibling endpoint at /nanoreg1 is used. Both share the same query schema.
Can I retrieve a study summary in one call?
Yes. GET /enm/{db}/substance/{uuid}/studySummary returns an aggregated summary of all studies attached to a substance, including endpoint outcomes and data sources. This is the recommended endpoint for dossier-building agents because it avoids fetching every individual study record.
/enm/{db}/query/smarts
Substructure search using SMARTS patterns
/enm/{db}/query/similarity
Find structurally similar substances