diff --git a/overview.mdx b/overview.mdx
index b6d3f7e1..6c613399 100644
--- a/overview.mdx
+++ b/overview.mdx
@@ -73,21 +73,17 @@ Build, analyze, and innovate with X's real-time global data. Access posts, users
The X API uses **pay-per-usage** pricing. No monthly subscriptions—pay only for what you use.
-
- Scale up or down based on your needs. Costs grow with your usage.
+
+ Flexible, credit-based pricing. Scale up or down based on your needs with no commitments or minimum spend.
-
- Lower barriers for small projects. No tier jumps or commitments.
+
+ Dedicated support, complete streams, and custom integrations for high-volume needs.
-
-
-
-
-For enterprise needs with dedicated support, complete streams, and custom integrations:
-
-
+
+Earn free [xAI API](https://docs.x.ai) credits when you purchase X API credits—up to 20% back based on your spend. [Learn more](/x-api/getting-started/pricing#free-xai-api-credits)
+
---
diff --git a/x-api/getting-started/pricing.mdx b/x-api/getting-started/pricing.mdx
index d3db8263..bf3da9f0 100644
--- a/x-api/getting-started/pricing.mdx
+++ b/x-api/getting-started/pricing.mdx
@@ -2,7 +2,7 @@
title: Pricing
sidebarTitle: Pricing
description: Pay-per-usage pricing for the X API
-keywords: ["X API pricing", "API pricing", "pay-per-usage", "API credits", "billing", "deduplication", "API costs", "auto-recharge", "spending limit", "spend cap"]
+keywords: ["X API pricing", "API pricing", "pay-per-usage", "API credits", "billing", "deduplication", "API costs", "auto-recharge", "spending limit", "spend cap", "xAI credits", "free credits", "Grok API"]
---
import { Button } from '/snippets/button.mdx';
@@ -30,6 +30,10 @@ The X API uses **pay-per-usage** pricing. No subscriptions, no monthly caps—pa
+
+Earn free [xAI API](https://docs.x.ai) credits when you purchase X API credits—up to 20% back based on your spend. [Learn more](#free-xai-api-credits)
+
+
---
## Deduplication
@@ -86,6 +90,44 @@ Use spending limits to prevent unexpected charges, especially during development
---
+## Free xAI API Credits
+
+When you purchase X API credits, you can earn free [xAI API](https://docs.x.ai) credits based on your cumulative spend during a billing cycle.
+
+### How it works
+
+Your cumulative spend is tracked throughout each billing cycle. As you cross spending thresholds, you unlock higher reward rates. When a new billing cycle starts, your cumulative spend resets to $0.
+
+| Cumulative spend | Rate |
+|:-----------------|:-----|
+| $0 – $199 | 0% |
+| $200 – $499 | 10% |
+| $500 – $999 | 15% |
+| $1,000+ | 20% |
+
+
+The rate applies to your **entire cumulative balance**, but you only receive the delta—what's newly owed minus what was already credited.
+
+
+### Example
+
+Suppose you make two purchases in the same billing cycle:
+
+| Purchase | Cumulative spend | Rate | Total owed | Already credited | You receive |
+|:---------|:-----------------|:-----|:-----------|:-----------------|:------------|
+| $200 | $200 | 10% | $20 | $0 | **$20** |
+| $300 | $500 | 15% | $75 | $20 | **$55** |
+
+**Total xAI credits received: $75**
+
+This is the same amount you'd receive from a single $500 purchase—the order and size of purchases doesn't affect your total rewards.
+
+
+View your xAI credit balance and manage your account at [console.x.ai](https://console.x.ai). For more details on xAI API billing, see the [xAI billing documentation](https://docs.x.ai/docs/key-information/billing).
+
+
+---
+
## Monitoring usage
Track your API usage programmatically with the [Usage endpoint](/x-api/usage/introduction):
diff --git a/x-api/introduction.mdx b/x-api/introduction.mdx
index 56095e57..681e34e5 100644
--- a/x-api/introduction.mdx
+++ b/x-api/introduction.mdx
@@ -68,6 +68,10 @@ The X API uses **pay-per-usage** pricing. No subscriptions, no monthly caps—pa
+
+Earn free [xAI API](https://docs.x.ai) credits when you purchase X API credits—up to 20% back based on your spend. [Learn more](/x-api/getting-started/pricing#free-xai-api-credits)
+
+