.png?fit=max&auto=format&n=JDfi1OMyRZe9mdjq&q=85&s=3c54eb6b8d2e6b5018f36b4f1a0a6362)
Documentation Index
Fetch the complete documentation index at: https://docs.hireotto.com/llms.txt
Use this file to discover all available pages before exploring further.
How credits work
Think of credits like API call tokens. Each plan comes with a monthly credit allowance that resets at the start of your billing period. Credits don’t carry over.| Plan | Monthly credits |
|---|---|
| Free trial | 200 (one-time) |
| Pro | 5,000 / month |
| Agency | unlimited |
What costs what
Actions are grouped by type. As a general rule: the more data an action pulls or the more complex the write operation, the more it costs.| Action type | Examples | Cost |
|---|---|---|
| Auth & utility | Connect account, check billing, list accounts | Free |
| Discovery & listing | List campaigns, ad groups, keywords, ads | 1 credit |
| Account hygiene | Auto-tagging review, disapproved ads check, negative keyword review | 3 credits each |
| Create / update entities | Create ad group, update keywords, add negatives | 2 credits each |
| Campaign creation | Create a Search/App campaign | 5 credits |
| Change history | Get change status, get change events | 5 credits each |
| Performance reports | Campaign, ad group, keyword, search terms, geo, device, PMax reports | 10 credits each |
| Keyword planner | Keyword ideas, historical metrics | 10 credits each |
| Performance Max (create) | Create PMax campaign or asset group | 10 credits |
| Performance Max (assets/signals) | Add/remove assets, audience signals, search themes | 2–5 credits |
| Daily ops audit | Pacing flags + wasteful search terms combined | 15 credits |
| Custom GAQL query | run_gaql — Agency plan only | 10 credits |
How to check your balance
Ask your AI client at any time:What happens when you run out
Once your credits hit zero, actions that cost credits will stop working until your balance resets at the next billing cycle. Free and listing actions (0–1 credit) continue to work. If you’re hitting the limit regularly, that’s a sign you’ve outgrown your plan. Reach out at [email protected] to discuss options.Tips for getting the most out of your credits
Usesummary mode for quick checks, csv_only for bulk pulls.
- Performance reports let you choose how results come back. If you’re scanning a handful of campaigns,
summary(default) is fine. - If you’re pulling data for 50+ campaigns to drop into a spreadsheet, switch to
csv_only— same credit cost, much cleaner output for downstream use.
campaign_id or adgroup_id filter. If you only care about one campaign’s keywords, pass the campaign ID — it limits what gets fetched and keeps response sizes manageable.
Listing is cheap; reporting isn’t. list_campaigns costs 1 credit. get_campaign_performance costs 10. If you just need to see which campaigns exist (not their metrics), use the listing action.