These are real calls against the production engine, returning exactly what a subscribed key returns. The only difference is a per-IP rate limit.
GET /v1/pair?q=Pinot+Noir14 demo requests left this hour
Grape
Scoped to Bourgogne, France · still dry red.
Bourgogne Pinot Noir
Can range from elegant and delicate to intense and structured depending on terroir., Acidity varies with vintage.
Verified source-backed pairing evidence. Scope is preserved per item.
bacon (Geography: Napa Valley)
duck (Geography: Napa Valley)
yellowfin tuna (Geography: Napa Valley)
grilled meats (Geography: Napa Valley; most)
mushrooms (Geography: Napa Valley)
pasta (Geography: Napa Valley)
ham (Geography: Napa Valley)
curl -s "https://api.pinpointed.dev/v1/demo/pair?q=Pinot+Noir"
{
"ok": true,
"query": "Pinot Noir",
"state": "resolved",
"pairing": {
"guidance": [
{
"dish": null,
"food_item": "bacon",
"oak_scope": null,
"qualifier": null,
"confidence": 0.8,
"source_key": "napa-valley-vintners-wine-food-guide-pinot-noir-2017",
"source_url": "https://magazine.napavalley.wine/wp-content/uploads/2021/04/NAPA-Issue-4.pdf",
"pairing_key": "bacon",
"preparation": null,
"source_page": null,
"style_scope": null,
"pairing_text": "Napa Valley Pinot Noir pairs with bacon.",
"source_title": "NAPA Wine & Food Pairing Guide",
"food_category": "meat",
"language_code": "en",
"serving_scope": null,
"source_excerpt": "BACON",
"source_section": "Food Pairing with Pinot Noir",
"wine_age_scope": null,
"geography_scope": "Napa Valley",
"sweetness_scope": null,
"evidence_version": "pdi-grape-pairing-v1",
"source_authority": "official_regional_wine_body",
"source_publisher": "Napa Valley Vintners",
"pairing_rationale": null,
"verification_status": "verified",
"pairing_relationship": "recommended"
},
{
"dish": null,
"food_item": "duck",
"oak_scope": null,
"qualifier": null,
"confidence": 0.8,
"source_key": "napa-valley-vintners-wine-food-guide-pinot-noir-2017",
"source_url": "https://magazine.napavalley.wine/wp-content/uploads/2021/04/NAPA-Issue-4.pdf",
"pairing_key": "duck",
"preparation": null,
"source_page": null,
"style_scope": null,
"pairing_text": "Napa Valley Pinot Noir pairs with duck.",
"source_title": "NAPA Wine & Food Pairing Guide",
"food_category": "poultry",
"language_code": "en",
"serving_scope": null,
"source_excerpt": "DUCK",
"source_section": "Food Pairing with Pinot Noir",
"wine_age_scope": null,
"geography_scope": "Napa Valley",
"sweetness_scope": null,
"evidence_version": "pdi-grape-pairing-v1",
"source_authority": "official_regional_wine_body",
"source_publisher": "Napa Valley Vintners",
"pairing_rationale": null,
"verification_status": "verified",
"pairing_relationship": "recommended"
},
{
"dish": "Grilled Yellowfin Tuna",
"food_item": "yellowfin tuna",
"oak_scope": null,
"qualifier": null,
"confidence": 0.8,
"source_key": "napa-valley-vintners-wine-food-guide-pinot-noir-2017",
"source_url": "https://magazine.napavalley.wine/wp-content/uploads/2021/04/NAPA-Issue-4.pdf",
"pairing_key": "grilled_yellowfin_tuna",
"preparation": "grilled",
"source_page": null,
"style_scope": null,
"pairing_text": "Napa Valley Pinot Noir is paired with grilled yellowfin tuna.",
"source_title": "NAPA Wine & Food Pairing Guide",
"food_category": "fish",
"language_code": "en",
"serving_scope": null,
"source_excerpt": "PinoT noir and\ngriLLed YeLLoWFin Tuna",
"source_section": "Pinot Noir and Grilled Yellowfin Tuna",
"wine_age_scope": null,
"geography_scope": "Napa Valley",
"sweetness_scope": null,
"evidence_version": "pdi-grape-pairing-v1",
"source_authority": "official_regional_wine_body",
"source_publisher": "Napa Valley Vintners",
"pairing_rationale": null,
"verification_status": "verified",
"pairing_relationship": "recommended"
},
{
"dish": null,
"food_item": "grilled meats",
"oak_scope": null,
"qualifier": "most",
"confidence": 0.8,
"source_key": "napa-valley-vintners-wine-food-guide-pinot-noir-2017",
"source_url": "https://magazine.napavalley.wine/wp-content/uploads/2021/04/NAPA-Issue-4.pdf",
"pairing_key": "most_grilled_meats",
"preparation": "grilled",
"source_page": null,
"style_scope": null,
"pairing_text": "Napa Valley Pinot Noir pairs with most grilled meats.",
"source_title": "NAPA Wine & Food Pairing Guide",
"food_category": "meat",
"language_code": "en",
"serving_scope": null,
"source_excerpt": "MOST GRILLED MEATS",
"source_section": "Food Pairing with Pinot Noir",
"wine_age_scope": null,
"geography_scope": "Napa Valley",
"sweetness_scope": null,
"evidence_version": "pdi-grape-pairing-v1",
"source_authority": "official_regional_wine_body",
"source_publisher": "Napa Valley Vintners",
"pairing_rationale": null,
"verification_status": "verified",
"pairing_relationship": "recommended"
},
{
"dish": null,
"food_item": "mushrooms",
"oak_scope": null,
"qualifier": null,
"confidence": 0.8,
"source_key": "napa-valley-vintners-wine-food-guide-pinot-noir-2017",
"source_url": "https://magazine.napavalley.wine/wp-content/uploads/2021/04/NAPA-Issue-4.pdf",
"pairing_key": "mushrooms",
"preparation": null,
"source_page": null,
"style_scope": null,
"pairing_text": "Napa Valley Pinot Noir pairs with mushrooms.",
"source_title": "NAPA Wine & Food Pairing Guide",
"food_category": "vegetable",
"language_code": "en",
"serving_scope": null,
"source_excerpt": "MUSHROOMS",
"source_section": "Food Pairing with Pinot Noir",
"wine_age_scope": null,
"geography_scope": "Napa Valley",
"sweetness_scope": null,
"evidence_version": "pdi-grape-pairing-v1",
"source_authority": "official_regional_wine_body",
"source_publisher": "Napa Valley Vintners",
"pairing_rationale": null,
"verification_status": "verified",
"pairing_relationship": "recommended"
},
{
"dish": "pastas with light red sauces",
"food_item": "pasta",
"oak_scope": null,
"qualifier": null,
"confidence": 0.8,
"source_key": "napa-valley-vintners-wine-food-guide-pinot-noir-2017",
"source_url": "https://magazine.napavalley.wine/wp-content/uploads/2021/04/NAPA-Issue-4.pdf",
"pairing_key": "pastas_with_light_red_sauces",
"preparation": null,
"source_page": null,
"style_scope": null,
"pairing_text": "Napa Valley Pinot Noir pairs with pastas with light red sauces.",
"source_title": "NAPA Wine & Food Pairing Guide",
"food_category": "pasta",
"language_code": "en",
"serving_scope": null,
"source_excerpt": "Pastas with light\nred sauces",
"source_section": "Food Pairing with Pinot Noir",
"wine_age_scope": null,
"geography_scope": "Napa Valley",
"sweetness_scope": null,
"evidence_version": "pdi-grape-pairing-v1",
"source_authority": "official_regional_wine_body",
"source_publisher": "Napa Valley Vintners",
"pairing_rationale": null,
"verification_status": "verified",
"pairing_relationship": "recommended"
},
{
"dish": null,
"food_item": "ham",
"oak_scope": null,
"qualifier": null,
"confidence": 0.8,
"source_key": "napa-valley-vintners-wine-food-guide-pinot-noir-2017",
"source_url": "https://magazine.napavalley.wine/wp-content/uploads/2021/04/NAPA-Issue-4.pdf",
"pairing_key": "smoky_ham",
"preparation": "smoky",
"source_page": null,
"style_scope": null,
"pairing_text": "Napa Valley Pinot Noir pairs with smoky ham.",
"source_title": "NAPA Wine & Food Pairing Guide",
"food_category": "meat",
"language_code": "en",
"serving_scope": null,
"source_excerpt": "SMOKY HAM",
"source_section": "Food Pairing with Pinot Noir",
"wine_age_scope": null,
"geography_scope": "Napa Valley",
"sweetness_scope": null,
"evidence_version": "pdi-grape-pairing-v1",
"source_authority": "official_regional_wine_body",
"source_publisher": "Napa Valley Vintners",
"pairing_rationale": null,
"verification_status": "verified",
"pairing_relationship": "recommended"
}
],
"review_status": "verified",
"guidance_version": "pdi-grape-pairing-evidence-v1"
},
"resolved": true,
"ambiguous": false,
"top_score": 100,
"resolution": {
"vivc_id": "9279",
"entity_id": "82257f23-c4fa-44dc-98f5-fae07b067ec2",
"matched_on": "canonical",
"match_score": 100,
"match_value": "Pinot noir",
"wikidata_id": "Q223701",
"canonical_name": "Pinot noir"
},
"sensory_available": true,
"reference_expression": {
"body": "medium",
"tannin": "medium-delicate",
"acidity": "medium-to-high, vintage-dependent",
"confidence": 0.92,
"provenance": [
{
"source": "Bourgogne Wines (BIVB)",
"locator": "https://www.bourgogne-wines.com/wine-and-terroir/our-grape-varietals-our-colors/pinot-noir/the-bourgogne-wine-region-birthplace-of-the-pinot-noir-varietal%2C2798%2C10603.html",
"supports": [
"body",
"tannin",
"acidity",
"aromas",
"development_aromas",
"climate_affinity",
"variation"
]
}
],
"style_scope": "still dry red",
"common_styles": [
"still dry red"
],
"expression_id": 2,
"review_status": "reviewed",
"aroma_families": [
"red_fruit",
"black_fruit",
"spice",
"earthy",
"savoury"
],
"blending_roles": [],
"expression_key": "bourgogne_reference",
"primary_aromas": [
"cherry",
"blackcurrant",
"pepper",
"cinnamon"
],
"expression_name": "Bourgogne Pinot Noir",
"geography_scope": "Bourgogne, France",
"variation_notes": [
"Can range from elegant and delicate to intense and structured depending on terroir.",
"Acidity varies with vintage."
],
"climate_affinity": {
"soils": "limestone-associated terroirs",
"preference": "cool/northerly climate"
},
"aromatic_intensity": "high",
"development_aromas": [
"mushroom",
"truffle",
"leather"
]
},
"domain": "wine",
"pairing_available": true,
"pairing_evidence": {
"customer_guidance_source": "verified_source_backed_pairing_evidence",
"verified_source_backed_available": true,
"generic_fallback_available": true,
"generic_fallback_used": false
},
"pairing_boundary": {
"pairing_is_independent_from_sensory": true,
"verified_source_backed_pairing_overrides_generic_pairing": true,
"generic_pairing_must_not_expand_verified_source_backed_set": true,
"pairing_scope_must_be_preserved": true,
"pairing_requires_separate_promoted_evidence": true
},
"demo": {
"demo": true,
"endpoint": "/v1/pair",
"authenticated_equivalent": "curl -H \"Authorization: Bearer $PDI_API_KEY\" \"https://api.pinpointed.dev/v1/pair?q=Pinot+Noir\"",
"limits": {
"per_ip_per_minute": 8,
"per_ip_per_hour": 20,
"max_query_length": 80,
"resolve_result_limit": 5
},
"note": "Public demo of the Pinpointed Drinks Intelligence API. Same engine and same response contract as a subscribed key, with demo-only rate limits.",
"docs": "https://api.pinpointed.dev/docs",
"plans": "https://api.pinpointed.dev/#plans",
"cached": false,
"remaining_this_hour": 14
}
}Every demo endpoint is a plain GET with no auth. Swap /v1/demo/ for /v1/ and add a bearer key when you subscribe.
curl -s "https://api.pinpointed.dev/v1/demo/explain?q=Barolo"
Demo traffic is rate limited per IP and capped daily, results are capped at 5 for resolution, and responses may be served from a short-lived cache. A Developer key removes all three.