GraphQL vs REST comparison - Visual Side-by-Side Comparison

Concept Flow - GraphQL vs REST comparison

Client sends request

↓

REST: Fixed endpoints

↓

Server returns fixed data

↓

Client may need multiple requests

↓

Client sends request

↓

GraphQL: Single endpoint

↓

Client specifies data shape

↓

Server returns exactly requested data

Shows how REST uses fixed endpoints returning fixed data, often requiring multiple requests, while GraphQL uses a single endpoint where client specifies exactly what data it wants.

Execution Sample

GraphQL

query {
  user(id: "1") {
    name
    posts {
      title
    }
  }
}

GraphQL query requesting a user's name and their posts' titles in one request.

Execution Table

Step	Request Type	Endpoint	Data Requested	Server Response	Notes
1	REST	/users/1	User data	{"id": "1", "name": "Alice", "email": "[e-mail]"}	Fixed data, includes email not needed
2	REST	/users/1/posts	User's posts	[{"id": "101", "title": "Hello World"}, {"id": "102", "title": "GraphQL Intro"}]	Separate request for posts
3	GraphQL	/graphql	{ user(id: "1") { name posts { title } } }	{"data": {"user": {"name": "Alice", "posts": [{"title": "Hello World"}, {"title": "GraphQL Intro"}]}}}	Single request, exact data
4	GraphQL	/graphql	{ user(id: "1") { name } }	{"data": {"user": {"name": "Alice"}}}	Single request, less data
5	REST	/users/1	User data	{"id": "1", "name": "Alice", "email": "[e-mail]"}	No way to limit fields in REST
6	REST	/users/1/posts	User's posts	[{"id": "101", "title": "Hello World"}, {"id": "102", "title": "GraphQL Intro"}]	Multiple requests needed
7	End	-	-	-	Requests complete

💡 All needed data retrieved; REST requires multiple requests, GraphQL uses one with precise data.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4	Final
REST_UserData	null	{"id": "1", "name": "Alice", "email": "[e-mail]"}	{"id": "1", "name": "Alice", "email": "[e-mail]"}	{"id": "1", "name": "Alice", "email": "[e-mail]"}	{"id": "1", "name": "Alice", "email": "[e-mail]"}	{"id": "1", "name": "Alice", "email": "[e-mail]"}
REST_UserPosts	null	null	[{"id": "101", "title": "Hello World"}, {"id": "102", "title": "GraphQL Intro"}]	[{"id": "101", "title": "Hello World"}, {"id": "102", "title": "GraphQL Intro"}]	[{"id": "101", "title": "Hello World"}, {"id": "102", "title": "GraphQL Intro"}]	[{"id": "101", "title": "Hello World"}, {"id": "102", "title": "GraphQL Intro"}]
GraphQL_Response	null	null	null	{"data": {"user": {"name": "Alice", "posts": [{"title": "Hello World"}, {"title": "GraphQL Intro"}]}}}	{"data": {"user": {"name": "Alice"}}}	{"data": {"user": {"name": "Alice", "posts": [{"title": "Hello World"}, {"title": "GraphQL Intro"}]}}}

Key Moments - 3 Insights

Why does REST require multiple requests to get user and posts data?

REST endpoints return fixed data per URL. To get user info and posts, separate URLs must be called (see execution_table rows 1 and 2).

How does GraphQL return exactly the data requested?

GraphQL queries specify fields needed. Server returns only those fields in one response (see execution_table row 3).

Can REST limit fields returned in a response like GraphQL?

No, REST endpoints usually return fixed fields. To limit fields, APIs must support query parameters, which is not standard (see execution_table rows 1 and 5).

Visual Quiz - 3 Questions

Look at the execution_table, at which step does GraphQL return both user name and posts in one response?

A Step 2

B Step 3

C Step 4

D Step 1

💡 Hint

Check the 'Server Response' column for GraphQL requests in execution_table rows.

According to variable_tracker, what is the value of REST_UserPosts after Step 2?

A [{"id": "101", "title": "Hello World"}, {"id": "102", "title": "GraphQL Intro"}]

B null

C User data JSON

D Empty array

💡 Hint

Look at REST_UserPosts row and After Step 2 column in variable_tracker.

If the GraphQL query in Step 4 requested posts titles only, what would the server response include?

A User name and posts titles

B User name only

C Posts titles only

D User email and posts titles

💡 Hint

GraphQL returns exactly requested fields as shown in execution_table rows 3 and 4.

Concept Snapshot

GraphQL vs REST:
- REST uses multiple fixed endpoints.
- REST returns fixed data per endpoint.
- GraphQL uses single endpoint.
- Client specifies exact data shape in GraphQL.
- GraphQL reduces multiple requests to one.
- REST may over-fetch or under-fetch data.

Full Transcript

This visual compares GraphQL and REST by showing how each handles data requests. REST uses fixed URLs returning fixed data, often requiring multiple requests to get related data like user info and posts. GraphQL uses a single endpoint where the client specifies exactly what data it wants, returning only that data in one response. The execution table traces requests and responses step-by-step, showing REST needing two requests for user and posts, while GraphQL gets both in one. The variable tracker shows how data variables change after each step. Key moments clarify why REST requires multiple calls and how GraphQL returns precise data. The quiz tests understanding of these differences by referencing the tables. The snapshot summarizes the main points for quick recall.