Rate Limits & Credits

The Appeeky API uses a credit-based rate limiting system. Each plan has monthly allowances for normal API work and, on eligible plans, dedicated AI Visibility and creative buckets. Every API call deducts credits from the bucket that matches the endpoint’s cost profile.

Plans

You pick one billing track. A web subscription and an API-only plan are not stacked. Do not buy both.

Web (appeeky.com) — dashboard, ASO, co-founder, and (on Startup / Agentic Scale) included API & MCP credits. Extra credits are an add-on on the same subscription.
API-only (dashboard.appeeky.com) — REST and MCP credits only. No web dashboard. Use this if you do not need appeeky.com UI.

Web subscriptions

Managed in Settings → Subscription on appeeky.com. The API console cannot switch you to these plans.

Plan	Plan ID	Included API credits	Creative credits	Price (monthly)
Indie Dev	—	none (add-on)	—	$10/mo
Startup	`web_startup`	1,000	40	$24/mo
Agentic Scale	`web_agentic_scale`	1,000	120	$79/mo

Indie Dev is the dashboard plan. It does not include API/MCP credits until you add them. Startup and Agentic Scale already include the allowance above. Need more credits while staying on web? Buy an API & MCP add-on in Settings. That is extra credits, not a second plan:

Add-on	Plan ID	Extra API credits	Price (monthly)
1,000 credits	`web_indie`	1,000	$5/mo
5,000 credits	`web_api_indie`	5,000	$9/mo
10,000 credits	`web_api_small`	10,000	$19/mo

On Startup and Agentic Scale, add-on credits stack on top of the included 1,000. On Indie Dev, the add-on is the credit allowance (nothing to stack on).

API-only plans

Managed at dashboard.appeeky.com/dashboard/billing. These are not listed on the appeeky.com pricing page.

Plan	Plan ID	API credits	Creative credits	Price (monthly)	Price (yearly)
Starter	`small`	10,000	40	$19/mo	$190/yr
Growth	`growth`	50,000	120	$39/mo	$390/yr
Pro	`medium`	100,000	250	$69/mo	$690/yr
Enterprise	`large`	1,000,000	500	$149/mo	$1,490/yr

X-Plan and /v1/auth/usage report the Plan ID: API-only small / growth / medium / large, or web web_startup / web_agentic_scale. Add-ons may report as web_indie, web_api_indie, or web_api_small. Grandfathered API Indie keys still report indie.

Need more than Enterprise, or a custom volume? Email hey@appeeky.com.

Credit Costs Per Endpoint

Credits are charged based on the computational cost of each endpoint. Heavier endpoints that aggregate multiple data sources cost more. Dedicated buckets are used for AI Visibility (credits.aiVisibility) and creative generation (credits.creative).

Free (0 credits)

Endpoint	Credits	Description
`GET /v1/health`	0	Service health check — always free

Light (1 credit)

Endpoint	Credits	Description
`GET /v1/search`	1	Search apps by keyword or App ID
`POST /v1/keywords/track`	1	Add keyword to your tracking list
`GET /v1/keywords/suggestions`	1	Apple Search autocomplete suggestions
`GET /v1/categories`	1	List all App Store categories

Standard (2 credits)

Endpoint	Credits	Description
`GET /v1/categories/:id/top`	2	Top charts for a category
`GET /v1/apps/:id`	2	Full app metadata (iTunes Lookup)
`GET /v1/apps/:id/reviews`	2	User reviews (Apple RSS feed)
`GET /v1/apps/:id/screenshots`	2	App screenshots by device type
`GET /v1/keywords/ranks`	2	Apps ranking for a specific keyword
`GET /v1/keywords/metrics`	2	Search volume and difficulty scores
`GET /v1/apps/:id/keywords/trends`	2	Historical rank trend for a keyword
`GET /v1/new-releases`	2	Recently released apps
`GET /v1/discover`	2	Trending and noteworthy apps
`GET /v1/discover/new-number-1`	2	Apps that just reached #1

Heavy (3 credits)

Endpoint	Credits	Description
`GET /v1/apps/:id/keywords`	3	All keyword rankings for an app
`GET /v1/keywords/compare`	3	Competitor keyword overlap analysis
`GET /v1/keywords/visibility`	3	App visibility score across tracked keywords
`GET /v1/keywords/movers`	3	Per-app keyword rank gainers / losers
`GET /v1/apps/:id/country-rankings`	3	Chart positions across countries
`GET /v1/apps/:id/screenshots/competitors`	3	Competitor screenshot comparison
`GET /v1/categories/:id/top/screenshots`	3	Screenshots for top apps in a category

Advanced (4 credits)

Endpoint	Credits	Description
`GET /v1/keywords/compare-cluster`	4	Multi-competitor keyword lifecycle buckets
`GET /v1/keywords/gap`	4	Top opportunity-ranked competitor keyword gaps

Premium (5 credits)

Endpoint	Credits	Description
`GET /v1/apps/:id/intelligence`	5	Full intelligence report: revenue, downloads, IAPs, sentiment

Standard (2 credits) — continued

Endpoint	Credits	Description
`GET /v1/apps/:id/similar`	2	Similar and competing apps (3-layer matching)

Credits are only deducted on successful responses (2xx status codes). Failed requests (4xx, 5xx) do not consume credits.

Creative credits

Endpoint	Bucket	Credits	Description
`POST /v1/app-ad-creatives/generate` with `mode: "analyze"` or `generateImage: false`	API	1	Listing analysis and paste-ready copy only
`POST /v1/app-ad-creatives/generate` with platform-funded image generation or editing	Creative	`low`: 1, `medium`: 2, `high`: 5	Generate or edit one square image creative
`POST /v1/app-ad-creatives/generate` with `X-OpenAI-Key`	API	1	BYOK image job; does not consume creative credits

Response Headers

Every authenticated response includes rate limit headers so you can track consumption programmatically:

Header	Description	Example
`X-RateLimit-Limit`	General API monthly credits for your plan	`10000`
`X-RateLimit-Remaining`	General API credits remaining this month	`4995`
`X-RateLimit-Reset`	Unix timestamp when credits reset (first of next month)	`1743465600`
`X-Credit-Cost`	Credits consumed by this request	`2`
`X-Credit-Category`	Bucket charged for this request	`general`
`X-AiVisibility-Limit`	Monthly AI Visibility bucket limit	`3000`
`X-AiVisibility-Remaining`	AI Visibility credits remaining when the route uses that bucket	`2991`
`X-Creative-Limit`	Monthly creative bucket limit	`10`
`X-Creative-Remaining`	Creative credits remaining when the route uses that bucket	`8`
`X-Plan`	Your current plan identifier	`small`

Example response headers:

HTTP/2 200
Content-Type: application/json
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9993
X-RateLimit-Reset: 1743465600
X-Credit-Cost: 2
X-Credit-Category: general
X-Creative-Limit: 40
X-Plan: small

Use X-RateLimit-Remaining in your code to implement graceful throttling before hitting the limit.

Check Your Usage

Use the usage endpoint to see a detailed breakdown of your current month’s consumption:

curl "https://api.appeeky.com/v1/auth/usage" \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch("https://api.appeeky.com/v1/auth/usage", {
  headers: { "X-API-Key": "YOUR_API_KEY" },
});
const { data } = await res.json();

console.log(`Plan: ${data.plan}`);
console.log(`Used: ${data.used} / ${data.monthlyCredits}`);
console.log(`Remaining: ${data.remaining}`);
console.log(`Resets: ${data.resetDate}`);

import requests

res = requests.get(
    "https://api.appeeky.com/v1/auth/usage",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
data = res.json()["data"]

print(f'Plan: {data["plan"]}')
print(f'Used: {data["used"]} / {data["monthlyCredits"]}')
print(f'Remaining: {data["remaining"]}')
print(f'Resets: {data["resetDate"]}')

Response (200 OK):

{
  "data": {
    "plan": "small",
    "monthlyCredits": 10000,
    "used": 127,
    "remaining": 9873,
    "resetDate": "2026-03-01T00:00:00.000Z",
    "credits": {
      "general": { "limit": 10000, "used": 127, "remaining": 9873 },
      "aiVisibility": { "limit": 8000, "used": 0, "remaining": 8000 },
      "creative": { "limit": 40, "used": 0, "remaining": 40 },
      "resetDate": "2026-03-01T00:00:00.000Z"
    },
    "usageByEndpoint": [
      { "endpoint": "GET /apps/:id", "totalCredits": 40, "requestCount": 20 },
      { "endpoint": "GET /apps/:id/intelligence", "totalCredits": 50, "requestCount": 10 },
      { "endpoint": "GET /keywords/ranks", "totalCredits": 20, "requestCount": 10 },
      { "endpoint": "GET /search", "totalCredits": 12, "requestCount": 12 },
      { "endpoint": "GET /apps/:id/keywords", "totalCredits": 3, "requestCount": 1 },
      { "endpoint": "POST /keywords/track", "totalCredits": 2, "requestCount": 2 }
    ]
  }
}

Field	Type	Description
`plan`	string	Plan ID: API-only `small` / `growth` / `medium` / `large`; web `web_startup` / `web_agentic_scale`; add-ons `web_indie` / `web_api_indie` / `web_api_small`; grandfathered `indie`
`monthlyCredits`	number	General API credits for the billing period
`used`	number	Total credits consumed across all buckets, kept for backward compatibility
`remaining`	number	General API credits left until reset
`credits.general`	object	General API bucket limit, used, and remaining
`credits.aiVisibility`	object	Dedicated AI Visibility bucket limit, used, and remaining
`credits.creative`	object	Dedicated creative bucket limit, used, and remaining
`resetDate`	string	ISO 8601 date when credits reset
`usageByEndpoint`	array	Breakdown by endpoint with credit totals and request counts

When the Limit Is Reached

When your monthly credits are exhausted, all credit-consuming endpoints return 429 Too Many Requests:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Monthly credit limit reached (10000/10000). Upgrade plan for more credits."
  }
}

The response still includes rate limit headers so you can check the reset time:

HTTP/2 429
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1743465600
X-Plan: small

The /v1/health endpoint (0 credits) always works, even when your credit limit is exhausted. Use it to verify the service is up before investigating 429 errors.

Monthly Reset

Unused credits do not carry over.

Event	Timing
Monthly Stripe (web or API-only)	Credits reset on your renewal day
Yearly plans and free keys	1st of each calendar month, 00:00 UTC
Carry-over	No — unused credits expire
Plan changes	Take effect immediately; new credit allowance applies

Check your X-RateLimit-Reset response header or the resetDate field from /v1/auth/usage to see the exact reset timestamp for your current billing period.

Getting Started

Apps

My Data - Appeeky Web

Keywords

ASO Tools

AI Visibility

Search & Discovery

Market Intelligence

RevenueCat

Superwall

App Store Connect

Google Play Console

Apple Search Ads

Growth Channels

Reference

Plans

Web subscriptions

API-only plans

Credit Costs Per Endpoint

Free (0 credits)

Light (1 credit)

Standard (2 credits)

Heavy (3 credits)

Advanced (4 credits)

Premium (5 credits)

Standard (2 credits) — continued

Creative credits

Response Headers

Check Your Usage

When the Limit Is Reached

Monthly Reset

​Plans

​Web subscriptions

​API-only plans

​Credit Costs Per Endpoint

​Free (0 credits)

​Light (1 credit)

​Standard (2 credits)

​Heavy (3 credits)

​Advanced (4 credits)

​Premium (5 credits)

​Standard (2 credits) — continued

​Creative credits

​Response Headers

​Check Your Usage

​When the Limit Is Reached

​Monthly Reset

Plans

Web subscriptions

API-only plans

Credit Costs Per Endpoint

Free (0 credits)

Light (1 credit)

Standard (2 credits)

Heavy (3 credits)

Advanced (4 credits)

Premium (5 credits)

Standard (2 credits) — continued

Creative credits

Response Headers

Check Your Usage

When the Limit Is Reached

Monthly Reset