GraphQL Explorer
Interactive API for querying Golden Products and Supplier Data
Example Queries
Click to copy query, then paste in GraphQL Playground below
Search All Products
query SearchProducts {
searchGoldenProducts(query: "hotel", limit: 10) {
aokey
name
productType
location { latitude longitude }
qualityScore
completenessScore
supplierCou...List All Products
query ListProducts {
goldenProducts(limit: 20) {
totalCount
edges {
node {
aokey
name
productType
qualityScore
supplierCount
}
}
}
}...Get Hotel with Rooms (requires valid UUID)
query GetHotelWithRooms($aokey: String!) {
goldenProduct(aokey: $aokey) {
aokey
name
location { latitude, longitude }
qualityScore
rooms(minQuality: 80) {
aokey
room...Get Supplier-Specific Data
query GetSupplierProduct($supplierId: String!, $externalId: String!) {
supplierProduct(supplierId: $supplierId, externalId: $externalId) {
bronzeRecordId
supplierId
externalId
name
...Filter by Quality
query HighQualityProducts {
goldenProducts(
minQuality: 80.0,
productType: "hotel",
limit: 10,
sortBy: "QUALITY_SCORE",
sortOrder: "DESC"
) {
totalCount
edges {
n...Search Hotels Near Location
query SearchNearby {
searchGoldenProducts(
query: "hotel"
productType: "hotel"
nearLocation: { latitude: 51.5074, longitude: -0.1278 }
radiusMeters: 1000
limit: 10
) {
aoke...Get Hotel with Translations
query GetHotelTranslations($aokey: String!) {
goldenProduct(aokey: $aokey) {
aokey
name
location { latitude, longitude }
translations {
languageCode
translatedFields
...Get Hotel with Key Facts
query GetHotelKeyFacts($aokey: String!) {
goldenProduct(aokey: $aokey) {
aokey
name
location { latitude, longitude }
keyFacts {
facts
extractionTimestamp
confidenc...Compare Multiple Suppliers for Hotel
query CompareSuppliers($externalIds: [SupplierInput!]!) {
compareSupplierData(externalIds: $externalIds) {
supplierId
externalId
name
bronzeData
goldenProduct {
aokey
...Hotels by Supplier ID
query HotelsBySupplier($supplierId: String!) {
supplierProducts(supplierId: $supplierId, limit: 20) {
bronzeRecordId
supplierId
externalId
name
goldenProduct {
aokey
...Hotels with Complete Enrichments
query FullyEnrichedHotels {
goldenProducts(
minQuality: 80.0,
hasTranslations: true,
hasKeyFacts: true,
limit: 10
) {
totalCount
edges {
node {
aokey
...Search with Filters (Advanced)
query AdvancedSearch {
searchGoldenProducts(
query: "luxury hotel"
productType: "hotel"
minQuality: 85.0
minCompleteness: 80.0
hasRooms: true
hasTranslations: true
sortBy...GraphQL Features:
- Golden Products: Query AOKEY-based canonical products with rooms, suppliers
- Supplier Data: View Bronze normalized data from specific suppliers (before merging)
- Data Comparison: Compare how different suppliers describe the same hotel
- Geographic Search: Find products near coordinates with PostGIS
Query Editor
Quick Reference
Golden Product Queries
goldenProduct(aokey)- Fetch single productgoldenProducts(...)- List with filterssearchGoldenProducts(...)- Geographic search
Supplier Data Queries
supplierProduct(...)- Get Bronze datasupplierProducts(...)- List supplier's productscompareSupplierData(...)- Compare suppliers
Documentation
Full API documentation: GraphQL Usage Guide