API Documentation

GET /domains

List all available Dive domains. No authentication required.

curl "https://www.mooremetrics.com/wp-json/mooremetrics/v1/domains"

{ "domains": [ { "slug": "showdive", "label": "ShowDive", "entity_type": "TV Show", "characteristics": 13, "supports_location": false }, { "slug": "chowdive", "label": "ChowDive", "entity_type": "Restaurant", "characteristics": 12, "supports_location": true }, ... ]}

GET /domains/{domain}/items

Browse items and their characteristic scores. No authentication required. ChowDive and CollegeDive items include latitude/longitude; those domains can also be filtered by radius.

curl "https://www.mooremetrics.com/wp-json/mooremetrics/v1/domains/showdive/items?search=break&limit=5"

curl "https://www.mooremetrics.com/wp-json/mooremetrics/v1/domains/chowdive/items?latitude=40.7128&longitude=-74.0060&radius_miles=10&limit=5"

GET /domains/{domain}/characteristics

List the characteristic dimensions for a domain. No authentication required. Useful for building dynamic slider UIs. The response also reports whether location filtering is supported.

curl "https://www.mooremetrics.com/wp-json/mooremetrics/v1/domains/fragrancedive/characteristics"

POST /recommend AUTH

Get recommendations based on items the user likes. Accepts up to 20 input items with fuzzy matching.

curl -X POST "https://www.mooremetrics.com/wp-json/mooremetrics/v1/recommend" \ -H "X-API-Key: mm_live_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "domain": "showdive", "items": ["Breaking Bad", "The Wire", "Better Call Saul"], "limit": 10, "include_characteristics": true }'

Location-filtered ChowDive example:

curl -X POST "https://www.mooremetrics.com/wp-json/mooremetrics/v1/recommend" \ -H "X-API-Key: mm_live_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "domain": "chowdive", "items": ["Shake Shack"], "latitude": 40.7128, "longitude": -74.0060, "radius_miles": 25, "limit": 10 }'

{ "domain": "showdive", "matched_inputs": [ { "input": "Breaking Bad", "matched_to": "Breaking Bad", "id": "Breaking.Bad" } ], "unmatched_inputs": [], "count": 10, "recommendations": [ { "rank": 1, "id": "Ozark", "name": "Ozark", "score": 0.945321, "characteristics": { "sci_fi_elements": -0.8012, "comedy": -0.4521, "crime_focus": 1.8934, ... } }, ... ]}

For location-filtered ChowDive/CollegeDive responses, recommendations include latitude, longitude, and distance_miles.

POST /recommend-by-preferences AUTH

Get recommendations by specifying desired characteristic values (like the slider interface). Only include the characteristics you care about — omitted ones are ignored.

curl -X POST "https://www.mooremetrics.com/wp-json/mooremetrics/v1/recommend-by-preferences" \ -H "X-API-Key: mm_live_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "domain": "fragrancedive", "preferences": { "mainstream": -2.0, "intense_powerful": 3.0, "expensive": 2.5 }, "limit": 10 }'

CollegeDive preferences near Boston example:

curl -X POST "https://www.mooremetrics.com/wp-json/mooremetrics/v1/recommend-by-preferences" \ -H "X-API-Key: mm_live_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "domain": "collegedive", "preferences": { "Prestige": 2.0, "Urbanicity": 1.5 }, "latitude": 42.3601, "longitude": -71.0589, "radius_miles": 100, "limit": 10 }'

GET /correlation AUTH BASIC+

Get the pairwise similarity score between two items. Requires Basic or Pro plan. Values are normalized to a 0–1 scale.

curl -H "X-API-Key: mm_live_your_key_here" \ "https://www.mooremetrics.com/wp-json/mooremetrics/v1/correlation?domain=moviedive&item1=The+Godfather&item2=Goodfellas"

{ "domain": "moviedive", "item1": { "id": "The.Godfather", "name": "The Godfather" }, "item2": { "id": "Goodfellas", "name": "Goodfellas" }, "correlation": 0.674200}

GET /usage AUTH

Check your current usage, remaining quota, and per-domain breakdown for the current billing period.

curl -H "X-API-Key: mm_live_your_key_here" \ "https://www.mooremetrics.com/wp-json/mooremetrics/v1/usage"

POST /register

Programmatically register for a free API key. One key per email address.

curl -X POST "https://www.mooremetrics.com/wp-json/mooremetrics/v1/register" \ -H "Content-Type: application/json" \ -d '{"email": "you@example.com"}'