- Streamline your development workflow with the official SDKs of the X API!
+ Pay only for what you use. Plus, earn free xAI API credits when you purchase X API credits!
-
+
@@ -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/style.css b/style.css
index 262596e2..32ea0243 100644
--- a/style.css
+++ b/style.css
@@ -162,4 +162,4 @@ td[data-label="Free Limit"] strong {
.dark #usage-slider::-moz-range-thumb {
background: #0B0C0E;
-}
\ No newline at end of file
+}
diff --git a/x-api/getting-started/pricing.mdx b/x-api/getting-started/pricing.mdx
index d3db8263..056b8499 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,48 @@ 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 several purchases throughout a billing cycle:
+
+| Purchase | Rate | Total owed | Already credited | You receive |
+|:---------|:-----|:-----------|:-----------------|:------------|
+| $100 | 0% | $0 | $0 | **$0** |
+| $100 | 10% | $20 | $0 | **$20** |
+| $150 | 10% | $35 | $20 | **$15** |
+| $150 | 15% | $75 | $35 | **$40** |
+| $250 | 15% | $112.50 | $75 | **$37.50** |
+| $250 | 20% | $200 | $112.50 | **$87.50** |
+| | | | | |
+| **$1,000** | | | | **$200** |
+
+This is the same amount you'd receive from a single $1,000 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)
+
+
+ 