PerfumersWorld Educational & Raw Materials API
Live, read-only access to PerfumersWorld's public educational and reference pages and its sitemap-66 raw-material directory. Discovery routes return source identifiers; detail routes fetch one source page on demand and preserve original English text. Material pages publish ABC note segments and Top/Heart/Base groupings; public documentation tabs publish material-specific IFRA and solubility text when available. Structural roles are retained only when source free text states them, never inferred. Commerce, login, cart, and writes are excluded.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the PerfumersWorld Educational & Raw Materials API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/8c851f13-26ce-426c-bb52-de2d0c4584bf/api/v1/educational-page' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY" \
--data-urlencode 'source_url=https://www.perfumersworld.com/glossary.php'Endpoints
Inputs and response fields for every endpoint in this API.
GETV1 educational page/api/v1/educational-page
Fetches one same-origin URL returned by educational-pages and returns its visible source text as Markdown plus source-derived ABC/formula matches and glossary terms. It performs no per-result enrichment beyond this caller-selected page.
Input
source_urlRequiredQuery · stringFull HTTPS URL returned by educational-pages; external hosts and commerce pages are rejected.
Example: https://www.perfumersworld.com/glossary.php
Response
educational_modules?object[]educational_modules[].page_titlestringeducational_modules[].source_urlstringeducational_modules[].glossary_terms?object[]educational_modules[].glossary_terms[].termstringeducational_modules[].glossary_terms[].definitionstringeducational_modules[].section_categorystringeducational_modules[].full_english_contentstringeducational_modules[].abc_system_and_formulas?string[]raw_materials_database?object[]raw_materials_database[].source_skustringraw_materials_database[].source_urlstringraw_materials_database[].material_namestringraw_materials_database[].abc_classification_code?string | nullraw_materials_database[].odor_profile_descriptionstringraw_materials_database[].technical_and_usage_specsobjectraw_materials_database[].technical_and_usage_specs.cas_number?string, default: raw_materials_database[].technical_and_usage_specs.fema_or_ifra?string, default: raw_materials_database[].technical_and_usage_specs.application_notes?string, default: raw_materials_database[].technical_and_usage_specs.synonyms_and_uses?string, default: raw_materials_database[].technical_and_usage_specs.top_heart_base_notes?string[]raw_materials_database[].technical_and_usage_specs.odor_accord_breakdown?object[]raw_materials_database[].technical_and_usage_specs.source_specifications?objectraw_materials_database[].technical_and_usage_specs.dilution_and_solubility?string, default: raw_materials_database[].abc_classification_source_notestringFields marked ? are optional.
GETV1 educational pages/api/v1/educational-pages
Reads the live sitemap and returns non-commerce educational/reference page identifiers for use with the detail operation. Ordering follows first appearance in the sitemap; total is the current discovered count, not a historical guarantee.
Input
queryOptionalQuery · string | nullOptional case-insensitive text matched against page title, URL, or category.
Example: glossary
offsetOptionalQuery · integer, min: 0, default: 0Zero-based offset in the current sitemap-derived collection.
Example: 0
limitOptionalQuery · integer, min: 1, max: 500, default: 25Number of page identifiers to return.
Example: 5
Response
paginationobjectpagination.limitintegerpagination.totalintegerpagination.offsetintegerpagination.returnedintegerpagination.next_offset?integer | nullsource_sitemapstringeducational_modulesobject[]educational_modules[].page_titlestringeducational_modules[].source_urlstringeducational_modules[].section_categorystringFields marked ? are optional.
GETV1 raw material/api/v1/raw-material
Fetches one public view.php?pro_id= record selected from raw-materials plus its public document-list tabs. Source ABC note segments, Top/Heart/Base groupings, IFRA text, solubility text, odor, applications, and technical fields are preserved in English; structural roles are not inferred.
Input
pro_idRequiredQuery · stringExact source SKU returned as source_sku by raw-materials.
Example: 4EW07503
Response
educational_modules?object[]educational_modules[].page_titlestringeducational_modules[].source_urlstringeducational_modules[].glossary_terms?object[]educational_modules[].glossary_terms[].termstringeducational_modules[].glossary_terms[].definitionstringeducational_modules[].section_categorystringeducational_modules[].full_english_contentstringeducational_modules[].abc_system_and_formulas?string[]raw_materials_database?object[]raw_materials_database[].source_skustringraw_materials_database[].source_urlstringraw_materials_database[].material_namestringraw_materials_database[].abc_classification_code?string | nullraw_materials_database[].odor_profile_descriptionstringraw_materials_database[].technical_and_usage_specsobjectraw_materials_database[].technical_and_usage_specs.cas_number?string, default: raw_materials_database[].technical_and_usage_specs.fema_or_ifra?string, default: raw_materials_database[].technical_and_usage_specs.application_notes?string, default: raw_materials_database[].technical_and_usage_specs.synonyms_and_uses?string, default: raw_materials_database[].technical_and_usage_specs.top_heart_base_notes?string[]raw_materials_database[].technical_and_usage_specs.odor_accord_breakdown?object[]raw_materials_database[].technical_and_usage_specs.source_specifications?objectraw_materials_database[].technical_and_usage_specs.dilution_and_solubility?string, default: raw_materials_database[].abc_classification_source_notestringFields marked ? are optional.
GETV1 raw materials/api/v1/raw-materials
Reads sitemap-66.php and returns the source's current raw-material identifiers and names. Use source_sku with raw-material to retrieve one complete record. This route does not fetch one detail page per result.
Input
queryOptionalQuery · string | nullOptional case-insensitive match against the source material name or SKU.
Example: Agarwood
offsetOptionalQuery · integer, min: 0, default: 0Zero-based offset in the current sitemap-66-derived collection.
Example: 0
limitOptionalQuery · integer, min: 1, max: 500, default: 25Number of material identifiers to return.
Example: 5
Response
paginationobjectpagination.limitintegerpagination.totalintegerpagination.offsetintegerpagination.returnedintegerpagination.next_offset?integer | nullsource_sitemapstringraw_materials_databaseobject[]raw_materials_database[].source_skustringraw_materials_database[].source_urlstringraw_materials_database[].material_namestringFields marked ? are optional.
Don’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.