Install Jentic One Beta
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.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fideaconsult.net%2Fideaconsult-enanomapper" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fideaconsult.net%2Fideaconsult-enanomapper" | 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
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
/enm/{db}/query/smarts
Substructure search using SMARTS patterns
/enm/{db}/query/similarity
Find structurally similar substances
What agents get from Jentic-routed access to this vendor.
Setup
The eNanoMapper federated search takes no authentication, but wiring it by hand still means mapping its federated select and per-database substance routes and query encodings yourself. Through Jentic you install once, import the eNanoMapper federated search from the API Directory, and your agent calls it.
Permission scoping
eNanoMapper puts the database and substance uuid in the URL path (/enm/{db}/substance/{uuid}), so a rule can pin your agent to reading substances and studies from one database. All of its endpoints are read-only searches, so you scope the agent to the queries it needs and nothing else.
Credential isolation
This API requires no credential, so there is nothing to store, and Jentic One runs the read-only search calls for your agent at execution time. No secret ever enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'search nanomaterial substances' or 'find similar substances by structure', and Jentic returns the matching eNanoMapper operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
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.
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. Run Jentic One, the self-hosted execution layer, 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.
Can I limit what my agent is allowed to do with the eNanoMapper federated search API?
Yes. Because you run Jentic One self-hosted, your own rules decide which eNanoMapper operations the agent may call, and every endpoint is a read-only search, so you can grant only the queries the agent needs, such as free-text /select or a /query/similarity lookup. Since the database and substance UUID sit in the URL path (/enm/{db}/substance/{uuid}), a rule can pin the agent to reading substances and studies from a single database. The API takes no credentials, so scoping is purely about which operations you allow, and anything you do not permit stays out of reach.
For Agents
Run federated search and structural queries across the eNanoMapper nanomaterial database network, retrieving substances, studies, and similarity matches.
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.