Rewrite beginning

Author: MichaelMacaulay

website/src/pages/en/subgraphs/querying/graphql-api.mdx

@@ -2,7 +2,22 @@
 title: GraphQL API
 ---
 
-Learn about the GraphQL Query API used in The Graph.
+Explore the GraphQL Query API for interacting with Subgraphs on The Graph Network.
+
+## Introduction
+
+GraphQL serves as the query language for retrieving data from Subgraphs. This reference covers the syntax, parameters, and features available for querying Subgraph data. For foundational concepts, see [Subgraph Development](/subgraphs/developing/introduction/) and [Creating a Subgraph](/developing/creating-a-subgraph/).
+
+## Core Concepts
+
+### Entities
+- **Definition**: Types annotated with `@entity` in your schema represent queryable data objects.
+- **Structure**: Each entity requires an `id: ID!` field as its primary identifier.
+
+### Schema
+- **Role**: Defines the data structure and relationships via GraphQL's Interface Definition Language (IDL).
+- **Query Type**: Auto-generated from your Subgraph schema. Supports only read operations (`queries`).
+
 
 ## What is GraphQL?