# eNanoMapper database API

> eNanoMapper database API on Apizie: 13 endpoints (Details of multiple studies, Exact chemical structure search, Exact similarity search, Substructure search, …) returned as clean JSON through one API key. 13 endpoints are live now. Call it over REST at https://apizie.tech/v1/open-data:ideaconsult-enanomapper/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:ideaconsult-enanomapper`
- Category: Open Data
- Status: live
- Source: https://phabricator.ideaconsult.net
- Page: https://apizie.tech/api/open-data/ideaconsult-enanomapper
- OpenAPI: https://apizie.tech/api/open-data/ideaconsult-enanomapper/openapi.json

AMBIT REST web services [eNanoMapper profile] with free text & faceted search

## Endpoints

### Details of multiple studies
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/get-investigation-results`

| Parameter | Type | Required | Description |
|---|---|---|---|
| db | string | yes | Database ID |
| type | string | yes | query type |
| search | string | yes | Search parameter, UUID of the investigation or a substance |
| inchikey | string | no | Search parameter, InChI key(s) of the substance component(s), comma delimited |
| id | string | no | Search parameter, chemical structure or substance identifier(s), comma delimited |
| page | integer | no | Starting page |
| pagesize | integer | no | Page size |

### Exact chemical structure search
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/search-by-identifier`

| Parameter | Type | Required | Description |
|---|---|---|---|
| db | string | yes | Database ID |
| term | string | yes | search term type |
| representation | string | yes |  |
| search | string | no | Compound identifier (SMILES, InChI, name, registry identifiers) |
| b64search | string | no | Base64 encoded mol file; if included, will be used instead of the 'search' parameter |
| casesens | boolean | no | Case sensitive search if yes |
| bundle_uri | string | no | Bundle URI |
| sameas | string | no | Ontology URI to define groups of columns |
| page | integer | no | Starting page |
| pagesize | integer | no | Page size |

### Exact similarity search
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/search-by-similarity`

| Parameter | Type | Required | Description |
|---|---|---|---|
| db | string | yes | Database ID |
| search | string | no | Compound identifier (SMILES, InChI, name, registry identifiers) |
| b64search | string | no | Base64 encoded mol file; if included, will be used instead of the 'search' parameter |
| type | string | no | Defines the expected content of the search parameter |
| threshold | number | no | Similarity threshold |
| dataset_uri | string | no | Restrict the search within the AMBIT dataset specified with the URI |
| filterBySubstance | boolean | no | Restrict the search within the set of structures with assigned substances |
| bundle_uri | string | no | If the structure is used in the specified bundle URI, the selection tag will be returned |
| sameas | string | no | Ontology URI to define groups of columns |
| mol | boolean | no | Only for application/json; to include mol as JSON field |
| page | integer | no | Starting page |
| pagesize | integer | no | Page size |

### Substructure search
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/search-by-smarts`

| Parameter | Type | Required | Description |
|---|---|---|---|
| db | string | yes | Database ID |
| search | string | no | Compound identifier (SMILES, InChI, name, registry identifiers) |
| b64search | string | no | Base64 encoded mol file; if included, will be used instead of the 'search' parameter |
| type | string | no | Defines the expected content of the search parameter |
| dataset_uri | string | no | Restrict the search within the AMBIT dataset specified with the URI |
| filterBySubstance | boolean | no | Restrict the search within the set of structures with assigned substances |
| bundle_uri | string | no | If the structure is used in the specified bundle URI, the selection tag will be returned |
| sameas | string | no | Ontology URI to define groups of columns |
| mol | boolean | no | Only for application/json; to include mol as JSON field |
| page | integer | no | Starting page |
| pagesize | integer | no | Page size |

### Search endpoint summary
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/get-endpoint-summary`

| Parameter | Type | Required | Description |
|---|---|---|---|
| db | string | yes | Database ID |
| top | string | no | Top endpoint category |
| category | string | no | Endpoint category (The value in the protocol.category.code field) |

### List substances
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/get-substances`

| Parameter | Type | Required | Description |
|---|---|---|---|
| db | string | yes | Database ID |
| search | string | no | Search parameter |
| type | string | no |  |
| compound_uri | string | no | If type=related finds all substances containing this compound; if typ =reference - finds all substances with this compound as reference… |
| bundle_uri | string | no | Retrieves if selected in this bundle |
| addDummySubstance | boolean | no | Adds a compound record as substance in JSON; only if type=related |
| studysummary | boolean | no | If true retrieves study summary for each substance |
| page | integer | no | Starting page |
| pagesize | integer | no | Page size |

### Get a substance
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/get-substance-by-uuid`

| Parameter | Type | Required | Description |
|---|---|---|---|
| db | string | yes | Database ID |
| uuid | string | yes | Substance UUID |
| property_uris[] | string | no | Property URIs |
| page | integer | no | Starting page |
| pagesize | integer | no | Page size |

### Substance composition
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/get-substance-composition`

| Parameter | Type | Required | Description |
|---|---|---|---|
| db | string | yes | Database ID |
| uuid | string | yes | Substance UUID |
| all | boolean | no | true (Show all compositions) false (do not show hidden compositions) |
| page | integer | no | Starting page |
| pagesize | integer | no | Page size |

### Get substance composition as a dataset
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/get-substance-structures`

| Parameter | Type | Required | Description |
|---|---|---|---|
| db | string | yes | Database ID |
| uuid | string | yes | Substance UUID |
| page | integer | no | Starting page |
| pagesize | integer | no | Page size |

### get substance study
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/get-substance-study`

| Parameter | Type | Required | Description |
|---|---|---|---|
| db | string | yes | Database ID |
| uuid | string | yes | Substance UUID |
| top | string | no | Top endpoint category |
| category | string | no | Endpoint category (The value in the protocol.category.code field) |
| property_uri | string | no | Property URI https://data.enanomapper.net/property/{UUID} , see Property service |
| property | string | no | Property UUID |
| investigation_uuid | string | no | Investigation UUID, a code to link different studies |
| page | integer | no | Starting page |
| pagesize | integer | no | Page size |

### Get study summary for the substance
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/get-substance-study-summary`

| Parameter | Type | Required | Description |
|---|---|---|---|
| db | string | yes | Database ID |
| uuid | string | yes | Substance UUID |
| top | string | no | Top endpoint category |
| category | string | no | Endpoint category (The value in the protocol.category.code field) |
| property_uri | string | no | Property URI https://data.enanomapper.net/property/{UUID} , see Property service |
| property | string | no | Property UUID, see Property service |
| result | boolean | no | If true will group by topcategory,endpointcategory,interpretation result |
| page | integer | no | Starting page |
| pagesize | integer | no | Page size |

### Apache Solr powered search
`GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/solrquery-get`

| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | no | The query |
| fq | string | no | Filter query |
| fl | string | no | Field list |
| start | integer | no | Starting page |
| rows | integer | no | Page size |
| wt | string | no | Response format |

### Apache Solr powered search
`POST https://apizie.tech/v1/open-data:ideaconsult-enanomapper/solrquery-post`

| Parameter | Type | Required | Description |
|---|---|---|---|
| wt | string | no | Response format |
| body | object | no | JSON request body |

## Example
```
curl "https://apizie.tech/v1/open-data:ideaconsult-enanomapper/get-investigation-results" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the eNanoMapper database API?
Create a free Apizie key, then send GET https://apizie.tech/v1/open-data:ideaconsult-enanomapper/get-investigation-results with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the eNanoMapper database API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the eNanoMapper database API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:ideaconsult-enanomapper.

### What is the status of the eNanoMapper database API?
Live: works with just an Apizie key