What is an API? Beginner

An API is how programs talk to each other. Understanding it is the first step to having your bot work with real services like shipping carriers and online stores.

Before you start

• The Grok Bot app, installed and signed in. New? See where to download it and installing and signing in.

1. The restaurant picture

Think of a restaurant. You (a program) don't walk into the kitchen (the service). You give your order to a waiter (the API), who brings back your food (the data). An API, short for application programming interface, is that waiter.

2. A request and a response

Every API call has two halves. The request is what you send. It has:

1. A URL: the web address of the thing you want, like a tracking endpoint.
2. A method: what you want to do. GET reads, POST creates, PUT/PATCH update, DELETE removes.
3. Headers: extra labels, such as your key that proves who you are.
4. Sometimes a body: the details, often in JSON.

The response comes back with a status code (200 means OK) and usually some JSON, a simple text format of names and values like {"status": "Delivered"}.

3. How a bot uses APIs

In Your First Bot you learn the loop: receive, think, respond. APIs plug into it. The bot receives "Where's order 1001?", thinks "I need the tracking API", sends a request, and responds with the answer in plain words.

4. APIs vs connectors

For many popular apps, Grok Bot has ready-made connectors, so you never touch an API. APIs matter when there's no connector, or you want your own code to do the job.

Facts about the Grok Bot app come from Cursor's official Grok Bot documentation. See also MDN: An overview of HTTP. Menus and services change; if something looks different, check the official docs or ask your bot.