Settings Dashboard
The Settings dashboard provides access to all configuration options for your property. It's organized into tabs for different setting categories.
What You'll Learn
In this guide, you'll learn:
- How to access and use your API key
- How to configure report settings
- How to set billing limits
- What experimental features are available
API Tab
Your API Key
Your Spyglasses API key is required to connect the tracking plugin to your property. The key is displayed with a copy button for easy access.
You'll need this key to:
- Install the Spyglasses plugin on your website
- Configure middleware for Next.js, Nuxt, etc.
- Set up server-side tracking
See AI Traffic Analytics for more about what the plugin enables.
Platform Documentation Links
The API tab includes links to platform-specific documentation:
Choose your platform for detailed installation instructions.
Regenerating Your API Key
If your API key is compromised:
- Click "Regenerate Key"
- Confirm the action
- Update your site integration with the new key
Warning: Regenerating invalidates the old key immediately. Your site integration will stop working until updated.
Reports Tab
Report Scheduling
Instead of running reports manually, you can schedule them to run automatically:
| Frequency | Description |
|---|---|
| Weekly | Reports run every 7 days |
| Monthly | Reports run every 30 days |
| Quarterly | Reports run every 90 days |
| Off | Manual reports only |
Choose a frequency based on:
- How often your content changes
- Your recrawl frequency
- Credit budget
- How actively you're optimizing
Default Location
Set a default location for all reports run for this property:
- City: Specific city name
- Region/State: State, province, or region
- Country: Country code
Why set location? Location-aware queries return different results. For local businesses, this ensures AI platforms return locally relevant recommendations.
Example: A restaurant in Austin, TX should set location to "Austin, Texas, US" so queries like "best restaurants near me" return relevant competitors.
When Location Matters
- Local businesses: Essential—set your service area
- Regional services: Important—set your primary market
- National/global businesses: Optional—may set for specific market focus
- SaaS/digital products: Usually not needed
Billing Tab
AI Visit Monthly Cap
Set a maximum limit on tracked AI visits per month. This ensures you don't receive an unexpected bill for AI traffic overage.
How it works:
- Set a cap (e.g., 10,000 visits)
- When limit is reached, tracking continues but overage charges stop
- Resets at the start of each billing period
Why use a cap:
- Budget predictability
- Protection against unexpected traffic spikes
- Control over costs during testing
Organization Billing Link
Billing is handled at the organization level, not per property. The link takes you to organization billing where you can:
- View current plan
- Update payment method
- See usage across all properties
- Upgrade or downgrade
Experimental Tab
This tab contains features that are not yet ready for full release. These may include:
- Beta features in testing
- Advanced options for power users
- Features gathering feedback
If you want to use experimental features: Contact us at support@spyglasses.io so we can help you get started and provide guidance.
Note: Experimental features may change or be removed without notice.
Danger Zone
The Danger Zone contains destructive actions that cannot be undone.
Delete Property
Permanently deletes this property and all associated data:
- All AI Visibility Reports
- All analytics data
- All discovery queries
- All competitor data
- All historical metrics
Deletion is permanent and cannot be undone.
Use delete only if:
- You created the property by mistake
- You're canceling your account
- You want to completely remove all data
Before deleting, consider:
- Exporting any reports you need
- Confirming this is the right property
- Understanding all data will be lost
How to Delete
- Click "Delete Property"
- Type the property name to confirm
- Click "Delete Permanently"
Tab Navigation
Settings are organized into tabs for easy access:
- API: Keys and integration documentation
- Reports: Scheduling and location settings
- Billing: Usage caps and organization billing
- Experimental: Beta features (if available)
- Danger Zone: Destructive actions
Best Practices
Secure Your API Key
- Don't commit API keys to public repositories
- Use environment variables
- Rotate keys if potentially compromised
Set Location Early
If you're a local business, set location before running your first report. This ensures your initial data is relevant.
Configure Caps Before High Traffic
Set billing caps before launching marketing campaigns or expecting traffic spikes. This prevents surprise charges.
Review Settings Periodically
As your needs change, revisit settings:
- Update location if you expand to new markets
- Adjust report frequency based on optimization activity
- Review billing caps as your traffic grows
Related
- Getting Started - Initial property setup
- AI Visibility Reports - Using scheduled reports
- AI Traffic Analytics - What the plugin tracks
- Platform Docs - Installation guides