API unit balance

Jump to Check API unit balanceCheck API unit balance

Traffic & Market API v4 uses the same API units as other Semrush APIs.

Check your remaining API units in My Profile → Subscription info → API units.

Make sure you have enough API units before sending requests. To buy more units, use the Subscription info page or contact Sales. For access requirements, refer to API access.

Jump to Limits consumptionLimits consumption

Jump to How API units are consumedHow API units are consumed

Unit costs vary by endpoint. Check the endpoint reference for its price and whether requests are charged per request or per line of returned data.

Jump to Optimize unit consumptionOptimize unit consumption

  • Check the endpoint’s unit cost before making requests.
  • Request only the data you need. Use filters and limit where supported to reduce the number of returned lines.
  • Account for the total cost when a workflow requires several requests.

Jump to API Query logAPI Query log

The API Queries report shows API unit deductions for your v4 requests. To open it, go to My Profile → Query log → API Queries.

For each logged request, you can review:

  • Query: What was the domain, subdomain, subfolder, URL, or keyword queried (when applicable).
  • Time: When the request was sent.
  • User IP address: IP that initiated the request.
  • DB: Database selected for the query (when applicable).
  • Report type: Specific API report requested.
  • Historical: Whether the request retrieved historical data (when applicable).
  • Requested rows: Number of rows queried.
  • Offset: Number of rows skipped before the returned results (when applicable).
  • Report cost: Number of API units spent for the data returned.
  • API units: API unit balance remaining after the request.

This information helps you monitor API usage, troubleshoot unexpected unit consumption, and analyze request history.

Jump to Export your API request log dataExport your API request log data

You can export your API request log in CSV directly from the API Queries report. Use the Export button in the top-right corner of the table. You can choose to export:

  • All available records (up to 50,000).
  • Only the first N rows, selecting a limit of 100, 500, 1,000, 3,000, 10,000, 30,000, or 50,000.

If your API Queries log has more than 50,000 entries, request an export via Semrush Customer Support.

You can use the exported file for internal reports, sharing with your team, or analyzing in Excel or Google Sheets.

Jump to FAQFAQ

Jump to Where can I check my remaining API units?Where can I check my remaining API units?

Go to My Profile → Subscription info → API units.

Jump to How many API units do I need?How many API units do I need?

Calculate the cost using the endpoints you call, the number of requests, and any per-line charges. For details, refer to How API units are consumed.

Jump to What happens if I run out of API units?What happens if I run out of API units?

Refer to the endpoint’s error responses for its behavior when your balance is insufficient. For general error guidance, refer to Troubleshooting.

Last updated: November 20, 2026

Was this page helpful?