Catalog / PerfumersWorld Educational & Raw Materials

PerfumersWorld Educational & Raw Materials API

perfumersworld.com

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.

  • Research
  • perfumery
  • education
  • raw-materials
  • reference
  • chemistry
4 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

Sign 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.

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.

Full HTTPS URL returned by educational-pages; external hosts and commerce pages are rejected.

View call pricing
cURL · V1 educational page
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 · string

Full 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_titlestring
educational_modules[].source_urlstring
educational_modules[].glossary_terms?object[]
educational_modules[].glossary_terms[].termstring
educational_modules[].glossary_terms[].definitionstring
educational_modules[].section_categorystring
educational_modules[].full_english_contentstring
educational_modules[].abc_system_and_formulas?string[]
raw_materials_database?object[]
raw_materials_database[].source_skustring
raw_materials_database[].source_urlstring
raw_materials_database[].material_namestring
raw_materials_database[].abc_classification_code?string | null
raw_materials_database[].odor_profile_descriptionstring
raw_materials_database[].technical_and_usage_specsobject
raw_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?object
raw_materials_database[].technical_and_usage_specs.dilution_and_solubility?string, default:
raw_materials_database[].abc_classification_source_notestring

Fields 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 | null

Optional case-insensitive text matched against page title, URL, or category.

Example: glossary

offsetOptionalQuery · integer, min: 0, default: 0

Zero-based offset in the current sitemap-derived collection.

Example: 0

limitOptionalQuery · integer, min: 1, max: 500, default: 25

Number of page identifiers to return.

Example: 5

Response

paginationobject
pagination.limitinteger
pagination.totalinteger
pagination.offsetinteger
pagination.returnedinteger
pagination.next_offset?integer | null
source_sitemapstring
educational_modulesobject[]
educational_modules[].page_titlestring
educational_modules[].source_urlstring
educational_modules[].section_categorystring

Fields 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 · string

Exact source SKU returned as source_sku by raw-materials.

Example: 4EW07503

Response

educational_modules?object[]
educational_modules[].page_titlestring
educational_modules[].source_urlstring
educational_modules[].glossary_terms?object[]
educational_modules[].glossary_terms[].termstring
educational_modules[].glossary_terms[].definitionstring
educational_modules[].section_categorystring
educational_modules[].full_english_contentstring
educational_modules[].abc_system_and_formulas?string[]
raw_materials_database?object[]
raw_materials_database[].source_skustring
raw_materials_database[].source_urlstring
raw_materials_database[].material_namestring
raw_materials_database[].abc_classification_code?string | null
raw_materials_database[].odor_profile_descriptionstring
raw_materials_database[].technical_and_usage_specsobject
raw_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?object
raw_materials_database[].technical_and_usage_specs.dilution_and_solubility?string, default:
raw_materials_database[].abc_classification_source_notestring

Fields 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 | null

Optional case-insensitive match against the source material name or SKU.

Example: Agarwood

offsetOptionalQuery · integer, min: 0, default: 0

Zero-based offset in the current sitemap-66-derived collection.

Example: 0

limitOptionalQuery · integer, min: 1, max: 500, default: 25

Number of material identifiers to return.

Example: 5

Response

paginationobject
pagination.limitinteger
pagination.totalinteger
pagination.offsetinteger
pagination.returnedinteger
pagination.next_offset?integer | null
source_sitemapstring
raw_materials_databaseobject[]
raw_materials_database[].source_skustring
raw_materials_database[].source_urlstring
raw_materials_database[].material_namestring

Fields 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.