# 🌍 Grundis GraphQL API Documentation Welcome to the **Grundis API** — an AI-powered **GraphQL service** providing **personalized environmental, local context, news, weather, alerts, and AI lifestyle insights** with **super-fast response times**. --- ## 📌 Endpoint **POST** `https://your-api-hostname.com/graphql` --- ## 🔐 Authentication Add headers: - `X-RapidAPI-Key: YOUR_RAPIDAPI_KEY` - `X-RapidAPI-Host: your-api-hostname.com` - `Content-Type: application/json` Replace `YOUR_RAPIDAPI_KEY` with your RapidAPI key. --- ## 🚀 Query: `getContext` Fetch **real-time weather, news, alerts, and AI insights** for a **location**. ### Example Query ```graphql { getContext(location: "Los Angeles", intent: "Breakfast", slice: 1) { weather { temperature windSpeed weatherDescription humidity pressure visibility feelsLike airQuality { carbonMonoxide ozone sulfurDioxide nitrogenDioxide } } news { title source link pubDate } alerts { title description severity } ai_insight } } ``` ### Parameters | Field | Type | Required | Description | | -------- | ------ | -------- | ----------------------------------------- | | location | String | ✅ | Target city/region (e.g., "Los Angeles") | | intent | String | ❌ | User's intent (e.g., "Breakfast") | | slice | Int | ❌ | Number of news items | --- ## 💻 Usage Examples ### Using Apollo Client (React.js) ```bash npm install @apollo/client graphql ``` ```jsx import React from "react"; import { ApolloClient, InMemoryCache, ApolloProvider, gql, useQuery } from "@apollo/client"; const client = new ApolloClient({ uri: "https://your-api-hostname.com/graphql", cache: new InMemoryCache(), headers: { "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY", "X-RapidAPI-Host": "your-api-hostname.com", "Content-Type": "application/json", }, }); const GET_CONTEXT = gql` { getContext(location: "Dhaka", intent: "Rain", slice: 3) { weather { temperature weatherDescription } ai_insight } } `; function ContextComponent() { const { loading, error, data } = useQuery(GET_CONTEXT); if (loading) return

; if (error) return

Error: {error.message}

; return (

Weather in Dhaka

{data.getContext.weather.weatherDescription} - {data.getContext.weather.temperature}°C

AI Insight

{data.getContext.ai_insight}

); } export default function App() { return ( <ApolloProvider client={client}> <ContextComponent /> </ApolloProvider> ); } ``` --- ### Using Fetch (JavaScript) ```js const url = "https://your-api-hostname.com/graphql"; const options = { method: "POST", headers: { "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY", "X-RapidAPI-Host": "your-api-hostname.com", "Content-Type": "application/json", }, body: JSON.stringify({ query: ` { getContext(location: "Dhaka", intent: "Rain", slice: 3) { weather { temperature weatherDescription } ai_insight } } `, }), }; fetch(url, options) .then(res => res.json()) .then(data => console.log(data)) .catch(err => console.error(err)); ``` --- ## ✅ Ideal Use Cases - AI travel/lifestyle assistants - Smart dashboards - City-focused weather and news apps - Personalized notifications --- > **"Every attempt, even if it fails, is a step toward mastery."** **Created with ❤️ by Ehan Islam for the world.**