SpyFu

Log into your SpyFu account at spyfu.com. Click on your account avatar or name in the top-right corner and navigate to Account Settings. Look for an API section or API Access tab — SpyFu displays your secret key here. If you do not see an API option, your current plan does not include API access. SpyFu API access requires the Basic plan or above; check your current subscription level at spyfu.com/account/billing. Copy your secret key — it is a long alphanumeric string. Keep it secure: anyone with this key can make SpyFu API calls that consume your monthly quota. You will not need to rotate or refresh this key on a schedule (unlike OAuth tokens), but if it is ever exposed, you can regenerate it from the same account settings page. The key is the only credential you need for the entire SpyFu integration — no OAuth, no client secret, no token exchange.

In your Bubble editor, go to the Plugins tab in the left sidebar and click Add plugins. Search for API Connector (by Bubble) and install it. Click API Connector in your installed plugins list, then click Add another API. Name this first group SpyFu Domain API and set the base URL to https://www.spyfu.com/apis/domain_api. In the Shared parameters section (not Shared headers — SpyFu uses URL parameters, not headers, for auth), click Add a shared parameter. Set the key to secret_key, set the value to your copied SpyFu API key, and check the Private checkbox. This is the critical step: the Private flag on a URL parameter tells Bubble's server to append it to every outgoing request without it being visible in any browser-side network call or Bubble client-side workflow. Click Add another API again to create the second group. Name it SpyFu Keyword API and set the base URL to https://www.spyfu.com/apis/keyword_api. Add the same secret_key Private parameter to this group. The reason for two groups is that SpyFu's domain and keyword modules live at different base URLs — a single API Connector group can only have one base URL, so mixing endpoints from both modules in a single group is not reliably supported. Two groups keeps the configuration clean and avoids fragile per-call base URL overrides.

1// API Connector group 1: SpyFu Domain API
2// Base URL: https://www.spyfu.com/apis/domain_api
3// Shared URL parameter (NOT header):
4//   secret_key = YOUR_SPYFU_API_KEY  <-- mark Private
5
6// API Connector group 2: SpyFu Keyword API
7// Base URL: https://www.spyfu.com/apis/keyword_api
8// Shared URL parameter:
9//   secret_key = YOUR_SPYFU_API_KEY  <-- mark Private

Within the SpyFu Domain API group, click Add a call. Name it Get Top Paid Keywords. Set the method to GET. Set the endpoint to /v2/domain/getTopPaidKeywords. Add a URL parameter named domain with a test value of apple.com for initialization purposes. Optionally add pageSize (value: 10) and startingRow (value: 0) for pagination control. Click Initialize call — Bubble makes a live request to SpyFu using your secret_key. When the Initialize succeeds, Bubble detects the response fields: you will see fields like keyword, searchVolume, avgAdWords, totalMonthlyClicks, and estimatedMonthlyCost. Set Use as to Data. Now add a second call named Get Domain Info. Set the method to GET and endpoint to /v2/domain/getTopCosPaidKeywordsOverlap. Add domain1 and domain2 as URL parameters (use apple.com and microsoft.com for initialization). Initialize this call too. The overlap endpoint shows keywords shared between two competing domains — one of the most requested features in competitive intelligence dashboards. Both calls inherit the secret_key parameter automatically from the group, so you do not need to add it again at the call level.

1// GET https://www.spyfu.com/apis/domain_api/v2/domain/getTopPaidKeywords
2// URL parameters (secret_key appended automatically from group):
3{
4  "domain": "apple.com",   // bind to Bubble Text Input in production
5  "pageSize": "10",
6  "startingRow": "0"
7}
8
9// Expected response:
10{
11  "results": [
12    {
13      "keyword": "macbook pro",
14      "searchVolume": 450000,
15      "avgAdWords": 1.8,
16      "totalMonthlyClicks": 180000,
17      "estimatedMonthlyCost": 850000.00,
18      "position": 1
19    }
20  ],
21  "totalAvailableResults": 487
22}

On your Bubble page, add a Text Input element and label it 'Enter competitor domain'. Set the placeholder to 'e.g. competitor.com'. Add a Button element labeled 'Analyze'. Add a Repeating Group below it, set its Type of content to SpyFu Domain Result (a Data Type you create with fields: keyword TEXT, searchVolume NUMBER, estimatedMonthlyCost NUMBER, totalMonthlyClicks NUMBER). Design each Repeating Group cell to show the keyword, monthly search volume, estimated monthly clicks, and estimated monthly cost. Now build the Button's workflow: add an action Make API call → Get Top Paid Keywords. In the domain parameter, bind it to the Text Input's value. Store the result in a Custom State named spyfuResults (Type: SpyFu Domain Result, or use Bubble's API response directly in the Repeating Group by setting the data source to Get Top Paid Keywords's results list). For pagination, add a Number Custom State named currentPage (initial value 0). Add a 'Load More' button whose click workflow calls Get Top Paid Keywords again with startingRow bound to currentPage × 10, then appends results. Display estimated monthly cost as a formatted currency value using Bubble's :formatted as currency operator. Do NOT trigger the API call on the text input's 'is changed' event — doing so sends a SpyFu request on every keystroke, burning your monthly API quota. The 'Analyze' button click pattern is the correct approach.

1// Bubble Workflow: Button 'Analyze' is clicked
2// Action 1: Make API call → Get Top Paid Keywords
3//   domain = Text Input Domain's value
4//   pageSize = 10
5//   startingRow = 0
6
7// Repeating Group data source:
8// Result of step 1's results list
9
10// Cell display:
11// Keyword:         Current cell's keyword
12// Monthly Searches: Current cell's searchVolume :formatted as number
13// Monthly Clicks:   Current cell's totalMonthlyClicks :formatted as number
14// Est. Monthly Cost: Current cell's estimatedMonthlyCost :formatted as currency
15
16// Load More button workflow:
17// Action 1: Set Custom State currentPage + 1
18// Action 2: Make API call → Get Top Paid Keywords
19//   startingRow = currentPage × 10

Switch to the SpyFu Keyword API group and add a call named Get Keyword Stats. Set the method to GET and endpoint to /v2/keyword/getKsData. Add URL parameters: keyword (test value: 'project management software') and countryCode (value: US). Initialize the call — Bubble detects keyword-level data including monthly US searches, CPC estimates, difficulty scores, and advertiser counts. This call lets you look up a specific keyword rather than pulling all keywords for a domain — useful for a 'keyword research' tab in your Bubble tool. Add a second Keyword API call named Get Related Keywords with endpoint /v2/keyword/getRelatedKeywords, parameter keyword. Initialize it. Now assemble a two-tab Bubble interface: Tab 1 shows domain competitive analysis (top paid keywords, estimated spend) from the Domain API calls, and Tab 2 shows keyword research (stats and related terms) from the Keyword API calls. Use Bubble's Custom States to manage which tab is active and show/hide the relevant Repeating Groups. This gives you a complete competitive intelligence tool built entirely on SpyFu data, with no backend server code, no OAuth management, and no token expiry concerns. If you want to extend this into a client-facing SaaS tool with per-user history and saved analyses, RapidDev specializes in exactly this pattern — book a free scoping call at rapidevelopers.com/contact.

1// Keyword API group calls:
2
3// GET https://www.spyfu.com/apis/keyword_api/v2/keyword/getKsData
4// URL params:
5{
6  "keyword": "project management software",
7  "countryCode": "US"
8}
9
10// Expected response:
11{
12  "results": [
13    {
14      "keyword": "project management software",
15      "monthlySearchVolume": 60500,
16      "broadCostPerClick": 12.50,
17      "difficultyScore": 74,
18      "totalAdvertisers": 89
19    }
20  ]
21}
22
23// GET https://www.spyfu.com/apis/keyword_api/v2/keyword/getRelatedKeywords
24// URL params:
25{
26  "keyword": "project management software"
27}