Name: Analyze Food Personality, Flavor DNA & Compatibility API
Brand: nicheapi-llc-1
SKU: api-nicheapi-llc-1-flavordna
Availability: InStock
Author: API Market

True Scary Stories

# Flavor DNA & Food Personality API

## Overview
The Flavor DNA & Food Personality API delivers structured, multi-dimensional food personality analysis by combining sensory science, cultural cuisine analysis, and food psychology research. It maps user food preferences across 15 flavor dimensions, classifies them into one of 10 taste archetypes, and scores compatibility against 30 cuisine profiles and 16 dietary patterns. The API also calculates compatibility scores between two food personalities — making it a versatile resource for developers building features around food discovery, personalization, and social matching. With 10 built-in foodie personas and a dedicated test endpoint, it is well-suited for rapid prototyping across dating apps, restaurant platforms, meal kit services, and wellness products.

## Features

*   **15 Flavor Dimensions**: Each profile is scored 0–100 across dimensions including Heat Tolerance, Umami Sensitivity, Sweet Preference, Sour Appreciation, Salt Craving, Bitterness Tolerance, Fat/Savoriness, Texture Adventurousness, Spice Complexity, and 6 additional dimensions.
*   **10 Taste Archetypes**: Classifies eaters into profiles such as The Bold Experimentalist, Comfort Ritualist, Global Nomad, Sensory Minimalist, Health Devotee, Social Feaster, Nostalgic Traditionalist, Efficiency Eater, Craft Connoisseur, and Intuitive Grazer.
*   **30 Cuisine Profiles**: Full flavor DNA signatures for world cuisines including Italian, Japanese, Thai, Korean, Ethiopian, Peruvian, and 24 more.
*   **16 Dietary Patterns**: Covers Omnivore, Flexitarian, Pescatarian, Vegetarian, Vegan, Keto, Paleo, Mediterranean, and 8 more — each with flavor impact analysis.
*   **Food Memory Archetypes**: 8 categories linking past food experiences to current preferences, including The Childhood Classic, Travel Revelation, Home Comfort, and Celebration Feast.
*   **Food Personality Compatibility**: Calculates flavor dimension alignment, archetype harmony, and shared cuisine recommendations between two profiles.
*   **Batch Processing**: Analyze up to 50 preference sets in a single request.
*   **Adventurousness Scoring**: Returns a percentile ranking and labeled score alongside contributing heat, cuisine, and texture factors.
*   **Built-In Test Personas**: 10 richly detailed foodie personas — from a Spice Seeker to a Minimalist Purist — available via the test endpoint for prototyping and schema validation.

## Use Cases

The Flavor DNA & Food Personality API is suited for a range of products and personalization workflows:

*   **Dating Apps**: Add food personality matching as a compatibility dimension. Generate shareable Flavor DNA profile cards and surface archetype alignment scores alongside other compatibility signals.
*   **Restaurant Booking Platforms**: Recommend restaurants based on flavor personality rather than cuisine type alone — matching the right dining experience to a user's specific palate, not just their broad category preferences.
*   **Meal Kit Services**: Personalize weekly recipe selections based on flavor DNA scores. A Health Devotee receives different boxes than a Social Feaster, and recommendations adapt as user preferences evolve.
*   **Food Delivery Apps**: Replace generic recommendation engines with flavor-personalized results, ranking menus and dishes by their match percentage against a user's flavor profile.
*   **Travel & Hospitality**: Curate destination dining itineraries based on a traveler's flavor DNA — connecting the right food cultures to the right palate.
*   **Wellness & Nutrition Apps**: Connect dietary pattern analysis with flavor preference data to recommend sustainable eating habits that align with how users actually experience food.
*   **Culinary Education**: Help students track their palate development over time, surfacing flavor dimension growth and archetype evolution across a course of study.


## API Documentation

### Base URL
All API requests for the Flavor DNA & Food Personality API should be made to the following base URL:
`https://prod.api.market/api/v1/nicheapi-llc-1/flavordna/v1/flavordna`

### Authentication
Authentication is handled via an API key obtained from RapidAPI. Include your key in the `x-api-market-key` header of every request:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key from RapidAPI.


### Endpoints

#### 1. Analyze Flavor DNA

Perform a full flavor DNA analysis from a set of food preferences. Returns taste archetype classification, 15 flavor dimension scores, adventurousness percentile, dietary pattern analysis, and recommended cuisines.

**Method**: `POST`
**Endpoint**: `/v1/flavordna/analyze`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `preferences` | body | Object containing the user's food preference inputs (see fields below) | `object` | Yes |
| `preferences.cuisine_preferences` | body | Array of cuisine names the user enjoys | `array` | No |
| `preferences.disliked_cuisines` | body | Array of cuisine names the user dislikes | `array` | No |
| `preferences.heat_tolerance` | body | Self-reported heat tolerance on a scale of 1–10 | `integer` | No |
| `preferences.adventurousness_rating` | body | Self-reported food adventurousness on a scale of 1–10 | `integer` | No |
| `preferences.dietary_pattern` | body | The user's dietary pattern (e.g., `"omnivore"`, `"vegan"`, `"mediterranean"`) | `string` | No |
| `preferences.cooking_frequency` | body | How often the user cooks (e.g., `"daily"`, `"weekly"`, `"professionally"`) | `string` | No |
| `preferences.food_memories` | body | Array of free-text food memory descriptions | `array` | No |
| `preferences.texture_preferences` | body | Array of preferred textures (e.g., `"crunchy"`, `"creamy"`) | `array` | No |
| `preferences.avoided_textures` | body | Array of textures the user dislikes | `array` | No |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/flavordna/v1/flavordna/analyze" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "preferences": {
      "cuisine_preferences": ["Thai", "Mexican", "Japanese", "Korean"],
      "disliked_cuisines": ["British"],
      "heat_tolerance": 8,
      "adventurousness_rating": 9,
      "dietary_pattern": "omnivore",
      "cooking_frequency": "weekly",
      "food_memories": ["Ate amazing street food in Bangkok that changed my life"],
      "texture_preferences": ["crunchy"],
      "avoided_textures": []
    }
  }'
```

**Example Response (200 OK)**:

```json
{
  "archetype_match": {
    "archetype_id": "ARCH-FD-001",
    "archetype_name": "The Bold Experimentalist",
    "confidence": 87.3,
    "all_matches": [
      {"archetype_id": "ARCH-FD-001", "archetype_name": "The Bold Experimentalist", "score": 83.3, "confidence": 87.3},
      {"archetype_id": "ARCH-FD-003", "archetype_name": "The Global Nomad", "score": 72.1, "confidence": 7.6},
      {"archetype_id": "ARCH-FD-009", "archetype_name": "The Craft Connoisseur", "score": 68.5, "confidence": 3.8}
    ]
  },
  "flavor_dna_scores": {
    "FD-001": 87, "FD-002": 72, "FD-003": 35, "FD-004": 60,
    "FD-005": 50, "FD-006": 30, "FD-007": 53, "FD-008": 75,
    "FD-009": 78, "FD-010": 70, "FD-011": 43, "FD-012": 43,
    "FD-013": 55, "FD-014": 48, "FD-015": 30
  },
  "adventurousness": {
    "percentile": 82.5,
    "label": "Extremely Adventurous",
    "factors": {
      "heat_tolerance_factor": 80.0,
      "adventurousness_factor": 90.0,
      "cuisine_preference_factor": 72.5,
      "texture_adventurousness": 75.0
    }
  },
  "dietary_pattern_analysis": {
    "pattern_name": "Omnivore",
    "description": "No dietary restrictions. Eats all food groups.",
    "flavor_impact": "Full spectrum of flavor experiences available."
  },
  "recommended_cuisines": [
    {"cuisine_name": "Thai", "match_score": 87.2, "adventure_level": "adventurous"},
    {"cuisine_name": "Korean", "match_score": 82.4, "adventure_level": "moderate"},
    {"cuisine_name": "Mexican", "match_score": 78.6, "adventure_level": "accessible"}
  ]
}
```

#### 2. Batch Analyze Flavor DNA

Analyze up to 50 food preference sets in a single request.

**Method**: `POST`
**Endpoint**: `/v1/flavordna/analyze/batch`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `profiles` | body | Array of preference objects, each following the same structure as the `/analyze` request body (max 50) | `array` | Yes |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/flavordna/v1/flavordna/analyze/batch" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profiles": [
      {"preferences": {"cuisine_preferences": ["Thai", "Korean"], "heat_tolerance": 9}},
      {"preferences": {"cuisine_preferences": ["Italian", "French"], "heat_tolerance": 2}}
    ]
  }'
```

#### 3. Calculate Food Compatibility

Calculate food personality compatibility between two flavor DNA profiles. Returns flavor dimension alignment, archetype harmony score, and shared cuisine recommendations.

**Method**: `POST`
**Endpoint**: `/v1/flavordna/compatibility`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `profile_a` | body | First flavor DNA profile object, including `archetype` and `flavor_dna_scores` | `object` | Yes |
| `profile_b` | body | Second flavor DNA profile object, including `archetype` and `flavor_dna_scores` | `object` | Yes |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/flavordna/v1/flavordna/compatibility" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_a": {
      "archetype": {},
      "flavor_dna_scores": {"FD-001": 85, "FD-002": 70}
    },
    "profile_b": {
      "archetype": {},
      "flavor_dna_scores": {"FD-001": 45, "FD-002": 65}
    }
  }'
```

#### 4. Run Test Scenarios

Run analysis across a specified number of built-in foodie personas, covering diverse food personality types including the Spice Seeker, Comfort Homebody, Health Optimizer, and Global Gastronaut.

**Method**: `POST`
**Endpoint**: `/v1/flavordna/test`

**Request Body**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `count` | body | Number of built-in personas to run | `integer` | No | `1` | `10` |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/flavordna/v1/flavordna/test" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count": 3}'
```

#### 5. List Taste Archetypes

Retrieve all 10 taste archetypes with full descriptions.

**Method**: `GET`
**Endpoint**: `/v1/flavordna/archetypes`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/flavordna/v1/flavordna/archetypes" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 6. List Flavor Dimensions

Retrieve all 15 flavor dimensions with scoring methodology and descriptions.

**Method**: `GET`
**Endpoint**: `/v1/flavordna/flavors`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/flavordna/v1/flavordna" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 7. List Cuisine Profiles

Retrieve all 30 cuisine profiles with their flavor DNA signatures.

**Method**: `GET`
**Endpoint**: `/v1/flavordna/cuisines`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/flavordna/v1/flavordna/cuisines" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 8. List Dietary Patterns

Retrieve all 16 dietary patterns with flavor impact analysis.

**Method**: `GET`
**Endpoint**: `/v1/flavordna/patterns`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/flavordna/v1/flavordna/patterns" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 9. Health Check

Check API availability and retrieve live dataset statistics.

**Method**: `GET`
**Endpoint**: `/v1/flavordna/health`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/flavordna/v1/flavordna/health" \
  -H "x-api-market-key: YOUR_API_KEY"
```


## Status Codes
Below is a list of common HTTP status codes you may encounter when interacting with the Flavor DNA & Food Personality API:

*   **`200 OK`**: The request was successful and the server has returned the requested data.
*   **`400 Bad Request`**: The server could not process the request due to invalid input — such as a malformed `preferences` object, an unrecognized dietary pattern value, or a batch array exceeding 50 items. Review your request body before retrying.
*   **`401 Unauthorized`**: Authentication failed. Your `x-api-market-key` header is missing or contains an invalid key. Confirm your key is active and correctly included in the request header.
*   **`403 Forbidden`**: Your API key is valid, but your current plan does not permit access to the requested resource or endpoint. Review your plan's permissions on RapidAPI.
*   **`404 Not Found`**: The requested endpoint does not exist. Verify the URL path against the endpoint reference above.
*   **`429 Too Many Requests`**: You have exceeded your plan's rate limit. Implement client-side rate limiting and exponential backoff. Check the `Retry-After` response header for guidance on when to retry.
*   **`500 Internal Server Error`**: An unexpected server-side error occurred. Retry the request after a short delay.
*   **`503 Service Unavailable`**: The server is temporarily unavailable due to maintenance or elevated load. Retry after a short delay.

## Rate Limits

Rate limits vary by plan:

| Plan | Price | Requests/Month | Rate Limit |
| :--- | :--- | :--- | :--- |
| **Free** | $0 | 100 | 10 req/min |
| **Pro** | $49/mo | 5,000 | 60 req/min |
| **Business** | $149/mo | 50,000 | 300 req/min |
| **Enterprise** | $499/mo | 500,000 | 1,000 req/min |

If you exceed your plan's rate limit, the API returns a `429 Too Many Requests` status code. Implement exponential backoff in your client and monitor the `Retry-After` header for retry timing guidance.

## FAQ

*   **What inputs does the analyze endpoint require?**
    All fields inside the `preferences` object are optional, but richer inputs produce more accurate results. At minimum, providing `cuisine_preferences` and `heat_tolerance` is recommended for meaningful archetype classification.

*   **What is a Flavor DNA score?**
    Each of the 15 flavor dimensions is scored 0–100 based on the submitted preferences. These scores collectively determine archetype classification, cuisine match rankings, and compatibility calculations. Dimension keys (`FD-001` through `FD-015`) map to named dimensions available via the `/flavors` reference endpoint.

*   **How does food compatibility work?**
    The `/compatibility` endpoint accepts two flavor DNA profile objects and returns a compatibility score based on alignment across flavor dimensions and archetype harmony. Profiles are typically generated first via `/analyze` and then passed to `/compatibility`.

*   **How many preference sets can I batch analyze at once?**
    The `/analyze/batch` endpoint accepts up to 50 preference objects per request.

*   **Can I test the API before building a full integration?**
    Yes. The `/test` endpoint runs analysis across up to 10 built-in foodie personas with no preference input required. Use this to explore the response schema and validate your parsing logic.

*   **How do I access the archetype, cuisine, and dietary pattern libraries directly?**
    The reference endpoints — `/archetypes`, `/flavors`, `/cuisines`, and `/patterns` — return the full dictionaries used by the analysis engine. These are useful for building UI elements, onboarding flows, or documentation.

*   **How do I authenticate my requests?**
    All requests require an `x-api-market-key` header with your API key obtained from RapidAPI.

*   **What rate limit applies to my plan?**
    Rate limits range from 10 requests/minute on the Free plan to 1,000 requests/minute on Enterprise. See the Rate Limits section for the full breakdown.

## Contact Us

For questions or support, contact the developer at [21truescarystories@gmail.com](mailto:21truescarystories@gmail.com).

Unlock deep food insights with the Flavor DNA & Food Personality API. Analyze taste preferences, discover 10 archetypes, map 15 flavor dimensions, and calculate

Analyze Food Personality, Flavor DNA & Compatibility API

Free