# SpyFu Developer Docs Documentation

## Guides
- [SpyFu API Pricing](https://developer.spyfu.com/docs/api-pricing.md)
- [Rate Limits](https://developer.spyfu.com/docs/rate-limits.md)

## API Reference
- [API monthly usage](https://developer.spyfu.com/reference/accountapi_getapiusageformonth_get.md): Returns stats for API usage.
- [API daily usage](https://developer.spyfu.com/reference/accountapi_getapiusageformonthbyday_get.md): Returns stats for API usage.
- [API monthly usage by method](https://developer.spyfu.com/reference/accountapi_getapiusageformonthbymethod_get.md): Returns stats for API usage.
- [Get Domain Ad History](https://developer.spyfu.com/reference/adhistoryapi_getdomainadhistory_get.md): Returns historical ad variations and copy for a specific domain. This endpoint focuses on ads from a particular advertiser across all their keywords and campaigns, unlike term-based endpoints that focus on specific keywords.  [Visualize this API live on SpyFu](https://www.spyfu.com/ppc/ad-history/domain?query=example.com)
- [Get Keyword Ad History](https://developer.spyfu.com/reference/adhistoryapi_gettermadhistory_get.md): Returns historical advertisers and ad variations for a specific keyword. This endpoint focuses on ads that have appeared for a particular keyword, unlike domain-based endpoints that focus on ads from specific advertisers. [Visualize this API live on SpyFu](https://www.spyfu.com/keyword/ad-history?query=running%20shoes)
- [Get Keyword Ad History With Stats](https://developer.spyfu.com/reference/adhistoryapi_gettermadhistorywithstats_get.md): Returns historical ad variations and advertiser performance statistics for a specific keyword. This endpoint includes domain-level metrics alongside ad copy data, unlike the basic ad history endpoint that focuses purely on ad variations.  [Visualize this API live on SpyFu](https://www.spyfu.com/keyword/ad-history?query=example%20keyword)
- [Get Combined Top Competitors](https://developer.spyfu.com/reference/competitorsapi_getcombinedtopcompetitors_get.md): Returns the top competitors for a domain combining both paid search (PPC) and organic search (SEO) data. This endpoint identifies domains that compete across both advertising and organic rankings to reveal comprehensive competitive landscape insights.  [Visualize this API live on SpyFu](https://www.spyfu.com/competitors?query=example.com)
- [Get Top PPC Competitors](https://developer.spyfu.com/reference/competitorsapi_gettopppccompetitors_get.md): Returns the top paid search (PPC) competitors for a domain based on shared keyword advertising overlap. This endpoint identifies domains that compete for the same paid keywords to reveal direct advertising competition and bidding opportunities.  [Visualize this API live on SpyFu](https://www.spyfu.com/ppc/competitors?query=example.com)
- [Get Top SEO Competitors](https://developer.spyfu.com/reference/competitorsapi_gettopseocompetitors_get.md): Returns the top organic search (SEO) competitors for a domain based on shared keyword ranking overlap. This endpoint identifies domains that compete for the same organic keywords to reveal direct SEO competition and content opportunities.  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/competitors?query=example.com)
- [Get Active Dates For Domain](https://developer.spyfu.com/reference/domainstatsapi_getactivedatesfordomain_get.md): Returns a chronological list of dates for which SpyFu has collected domain statistics data. This endpoint helps identify data coverage periods and historical tracking availability for domain analysis and competitive research.  [Visualize this API live on SpyFu](https://www.spyfu.com/domain-overview?query=example.com)
- [Get All Domain Stats](https://developer.spyfu.com/reference/domainstatsapi_getalldomainstats_get.md): Returns comprehensive domain statistics for all available historical periods. This endpoint provides time-series data showing SEO and PPC performance trends to analyze domain growth, competitive positioning, and marketing effectiveness over time.  [Visualize this API live on SpyFu](https://www.spyfu.com/domain-overview?query=example.com)
- [Bulk Domain Statistics (Snapshot or History)](https://developer.spyfu.com/reference/domainstatsapi_getbulkdomainstats_get.md): Returns SEO and PPC metrics for multiple domains in one request. Suitable for batch enrichment, benchmarking, and portfolio monitoring.
- [Get Domain Stats For Exact Date](https://developer.spyfu.com/reference/domainstatsapi_getdomainstatsforexactdate_get.md): Returns domain statistics for a specific month and year. This endpoint provides point-in-time snapshots of SEO and PPC performance metrics to analyze historical domain activity and compare performance across different time periods.  [Visualize this API live on SpyFu](https://www.spyfu.com/domain-overview?query=example.com)
- [Get Latest Domain Stats](https://developer.spyfu.com/reference/domainstatsapi_getlatestdomainstats_get.md): Returns the most recent domain statistics available in SpyFu's database. This endpoint provides current SEO and PPC performance metrics to analyze the domain's latest competitive position and marketing activity.  [Visualize this API live on SpyFu](https://www.spyfu.com/domain-overview?query=example.com)
- [Find Domains by Pattern and Metrics](https://developer.spyfu.com/reference/domainstatsapi_getmatchingdomains_get.md): Discovers domains matching wildcard patterns and performance criteria for lead generation and competitive prospecting. Use wildcards like `*car*` to find automotive domains or filter by traffic, budget, and ranking metrics to identify high-value prospects.
- [Country Code Enum](https://developer.spyfu.com/reference/country-code-enum.md): Most SpyFu APIs have a countryCode parameter that is an enumerator that takes a two character country code.
- [Get Also Buys Ads For Keywords](https://developer.spyfu.com/reference/relatedkeywordsv2api_getalsobuysadsforkeywords_get.md): Returns related keywords that top advertisers also buy when targeting your seed keyword. This endpoint reveals cross-advertising patterns and keyword expansion opportunities by analyzing what other successful campaigns target alongside your keyword.  [Visualize this API live on SpyFu](https://www.spyfu.com/keyword/related?query=running+shoes)
- [Get Also Ranks For Keywords](https://developer.spyfu.com/reference/relatedkeywordsv2api_getalsoranksforkeywords_get.md): Returns related keywords that top-ranking domains for your seed keyword also rank for organically. This endpoint reveals SEO content opportunities and keyword expansion ideas by analyzing what successful sites target alongside your keyword.  [Visualize this API live on SpyFu](https://www.spyfu.com/keyword/related?query=running+shoes)
- [Get Keywords, All Sorts](https://developer.spyfu.com/reference/relatedkeywordsv2api_getkeywordexpansions_get.md): Performs 5 types of keyword research via keywordSearchType parameter: PhraseMatch (thematic similarities), Questions (interrogative queries), AlsoBuysAdsFor (co-targeted PPC terms), AlsoRanksFor (co-ranking SEO terms), Transactions (commercial intent). Set keywordSearchType to select method.
- [Get Keyword Information Bulk](https://developer.spyfu.com/reference/relatedkeywordsv2api_getkeywordsbybulksearch_get.md): Returns comprehensive keyword metrics and intelligence for a list of exact keywords. This endpoint provides search volume, competition data, cost estimates, and performance insights for specific keywords you want to analyze in bulk.  [Visualize this API live on SpyFu](https://www.spyfu.com/keyword/overview?query=running+shoes)
- [Post Keyword Information Bulk](https://developer.spyfu.com/reference/relatedkeywordsv2api_getkeywordsbybulksearchpost_post.md): Returns comprehensive keyword metrics and intelligence for a large list of exact keywords via POST request. This endpoint supports larger keyword lists and provides search volume, competition data, cost estimates, and performance insights for bulk keyword analysis.  [Visualize this API live on SpyFu](https://www.spyfu.com/keyword/overview?query=running+shoes)
- [Get Question Keywords](https://developer.spyfu.com/reference/relatedkeywordsv2api_getquestionkeywords_get.md): Returns question-based keywords related to your seed topic to inspire content creation and FAQ development. This endpoint identifies what people are asking about your subject matter, revealing content opportunities that answer common user questions and drive organic traffic.  [Visualize this API live on SpyFu](https://www.spyfu.com/keyword/related?query=running+shoes)
- [Get Related Keywords](https://developer.spyfu.com/reference/relatedkeywordsv2api_getrelatedkeywords_get.md): Returns thematically related keywords that share similar categories and themes with your seed keyword. This endpoint helps expand your keyword reach with relevant, competitive terms to broaden your content strategy and advertising opportunities.  [Visualize this API live on SpyFu](https://www.spyfu.com/keyword/related?query=running+shoes)
- [Get Transactional Keywords](https://developer.spyfu.com/reference/relatedkeywordsv2api_gettransactionkeywords_get.md): Returns high-intent keywords with strong buying signals related to your seed topic. This endpoint identifies commercial keywords that indicate users are ready to purchase, perfect for targeting conversion-focused campaigns and capturing bottom-funnel traffic.  [Visualize this API live on SpyFu](https://www.spyfu.com/keyword/related?query=running+shoes)
- [Get Competing PPC Keywords](https://developer.spyfu.com/reference/kombatapi_getcompetingppckeywords_get.md): Returns paid search keywords shared across multiple competitor domains. The process selects keywords from the includedDomains, then removes any keywords that belong to domains in the excludedDomains list.  [Visualize this API live on SpyFu](https://www.spyfu.com/kombat?query=example.com,example.org)
- [Get Competing SEO Keywords](https://developer.spyfu.com/reference/kombatapi_getcompetingseokeywords_get.md): Returns organic search keywords shared across multiple competitor domains. The process selects keywords from the includedDomains, then removes any keywords that belong to domains in the excludedDomains list.  [Visualize this API live on SpyFu](https://www.spyfu.com/kombat?query=example.com,example.org)
- [My SpyFu - Project Management API](https://developer.spyfu.com/reference/my-spyfu-project-management-api.md)
- [Get Most Successful PPC Keywords](https://developer.spyfu.com/reference/paidserpapi_getmostsuccessful_get.md): Returns the most successful paid search keywords for a domain based on search volume and competitive strength. This endpoint provides the highest-performing PPC keywords from the past year to identify proven advertising opportunities and optimize keyword strategy.  [Visualize this API live on SpyFu](https://www.spyfu.com/ppc/keywords?query=example.com)
- [Get New PPC Keywords](https://developer.spyfu.com/reference/paidserpapi_getnewkeywords_get.md): Returns newly acquired paid search keywords that a domain has started advertising on for the first time. This endpoint identifies recent keyword expansions and emerging advertising strategies to reveal new market opportunities and competitive moves.  [Visualize this API live on SpyFu](https://www.spyfu.com/ppc/keywords?query=example.com)
- [Get Ads for Domain](https://developer.spyfu.com/reference/paidserpapi_getpaidserps_get.md): Returns paid search results (ads) that a domain appears in across Google search. This endpoint reveals the competitive paid landscape to identify advertising opportunities and understand competitor PPC strategies.  [Visualize this API live on SpyFu](https://www.spyfu.com/ppc/keywords/domain?query=example.com)
- [Find domains historic rankings for a date range](https://developer.spyfu.com/reference/historicranking_gethistoricrankingsfordomain_get.md): Find domains historic rankings for a date range.
- [Find historic rankings for a domain on various keywords for a date range](https://developer.spyfu.com/reference/historicranking_gethistoricrankingsfordomainonkeywords_get.md): Find domains historic rankings for a date range
- [Find historic rankings for a keyword on various domains for a date range](https://developer.spyfu.com/reference/historicranking_gethistoricrankingsforkeywordondomains_get.md): Find domains historic rankings for a date range
- [Get Gained Clicks Keywords](https://developer.spyfu.com/reference/organicserpapi_getgainedclickskeywords_get.md): Returns keywords where a domain, path, subdomain, page or full URL experienced increased organic clicks compared to the previous month. This endpoint identifies the biggest click improvements to reveal rising content opportunities and successful SEO changes.  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/keywords/domain?includeAnyTerm=true&includeAnyUrl=true&searchType=gainedclicks&sidebarContext=filters&query=example.com)
- [Get Gained Ranks Keywords](https://developer.spyfu.com/reference/organicserpapi_getgainedrankskeywords_get.md): Returns keywords where a domain, path, subdomain, page or full URL improved its organic search ranking positions compared to the previous month. This endpoint identifies the biggest ranking gains to reveal successful SEO efforts and content optimizations.  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/keywords/domain?includeAnyTerm=true&includeAnyUrl=true&searchType=gainedranks&sidebarContext=filters&query=example.com)
- [Get Just Fell Off Keywords](https://developer.spyfu.com/reference/organicserpapi_getjustfelloffkeywords_get.md): Returns keywords where a domain dropped from the first page (top 10 results) compared to the previous month. This endpoint identifies recent ranking losses to reveal content that needs attention or competitive threats.  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/keywords/domain?includeAnyTerm=true&includeAnyUrl=true&searchType=justfelloff&sidebarContext=filters&query=example.com)
- [Get Just Made It Keywords](https://developer.spyfu.com/reference/organicserpapi_getjustmadeitkeywords_get.md): Returns keywords where a domain achieved first page rankings (top 10 results) this month after not ranking there previously. This endpoint identifies new ranking successes to reveal effective content strategies and emerging opportunities.  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/keywords/domain?includeAnyTerm=true&includeAnyUrl=true&searchType=justmadeit&sidebarContext=filters&query=example.com)
- [Get Where They Just Surpassed You Keywords](https://developer.spyfu.com/reference/organicserpapi_getkeywordswheretheyjustsurpassedyou_get.md): Returns keywords where the query domain recently surpassed the comparison domain in organic search rankings. This endpoint identifies competitive shifts where one domain has overtaken another, either through ranking improvements, competitor declines, or both.  The response includes both domains' ranking data, with the comparison domain's metrics appearing in the 'your' fields (yourRank, yourRankChange, yourUrl). Use this to monitor competitive threats or analyze successful competitor strategies.  **Common Usage Patterns:** - Put competitor in `query` and your domain in `compareDomain` to see where they're overtaking you - Put your domain in `query` and competitor in `compareDomain` to see where you're gaining ground  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/keywords/domain?query=example.com)
- [Get Where They Outrank You Keywords](https://developer.spyfu.com/reference/organicserpapi_getkeywordswheretheyoutrankyou_get.md): Returns keywords where the query domain currently outranks the comparison domain in organic search results. This endpoint identifies competitive gaps where one domain holds a better position than another, providing insights into competitor strengths and opportunities for improvement.  The response includes both domains' ranking data, with the comparison domain's metrics appearing in the 'your' fields (yourRank, yourRankChange, yourUrl). Use this to analyze competitive positioning, identify content gaps, and discover opportunities where competitors are winning.  **Common Usage Patterns:** - Put competitor in `query` and your domain in `compareDomain` to see where they outrank you - Put your domain in `query` and competitor in `compareDomain` to see where you outrank them  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/keywords/domain?query=example.com) _(TODO - verify)_
- [Get Live SEO Stats](https://developer.spyfu.com/reference/organicserpapi_getliveseostats_get.md): Returns live, aggregated SEO metrics for a given domain, subdomain, path, or URL. Results summarize current organic visibility and traffic estimates derived from up-to-date SERP data. Updated continuously (~every 15 seconds), 24/7/365.
- [Get Lost Clicks Keywords](https://developer.spyfu.com/reference/organicserpapi_getlostclickskeywords_get.md): Returns keywords where a domain experienced decreased organic clicks compared to the previous month. This endpoint identifies the biggest click losses to reveal content that needs attention or competitive pressure points.  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/keywords/domain?includeAnyTerm=true&includeAnyUrl=true&searchType=lostclicks&sidebarContext=filters&query=example.com)
- [Get Lost Ranks Keywords](https://developer.spyfu.com/reference/organicserpapi_getlostrankskeywords_get.md): Returns keywords where a domain's organic search ranking positions declined compared to the previous month. This endpoint identifies ranking losses that remain within the top 100 results to reveal content that needs SEO attention.  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/keywords/domain?includeAnyTerm=true&includeAnyUrl=true&searchType=lostranks&sidebarContext=filters&query=example.com)
- [Get Most Valuable Keywords](https://developer.spyfu.com/reference/organicserpapi_getmostvaluablekeywords_get.md): Returns keywords that generate the highest organic click volume for a domain. This endpoint identifies the most traffic-driving keywords to reveal a domain's most valuable SEO assets and content opportunities.  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/keywords/domain?includeAnyTerm=true&includeAnyUrl=true&searchType=mostvaluable&sidebarContext=filters&query=example.com)
- [Get Newly Ranked Keywords](https://developer.spyfu.com/reference/organicserpapi_getnewlyrankedkeywords_get.md): Returns keywords where a domain recently achieved rankings in the top 100 organic search results. This endpoint identifies fresh ranking opportunities to reveal new content successes and emerging SEO momentum.  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/keywords/domain?includeAnyTerm=true&includeAnyUrl=true&searchType=newlyranked&sidebarContext=filters&query=example.com)
- [Get Organic Outranking Keywords](https://developer.spyfu.com/reference/organicserpapi_getorganicoutrankingkeywords_get.md): Compare two domains' organic rankings in one call. Returns keywords where one domain outranks the other or has just overtaken it, with both sites' ranks, changes, clicks, and URLs. The comparison domain's metrics appear in the your* fields. Choose the mode with keywordSearchType.
- [Get SEO Keywords](https://developer.spyfu.com/reference/organicserpapi_getseokeywords_get.md): Unified endpoint for SEO keyword analyses. Select an analysis via `searchType` to return gains/losses in clicks, rank movers, page-one entries/exits, newly ranked terms, or top-value keywords -- without switching endpoints.
- [Get SERP Analysis for Keyword ](https://developer.spyfu.com/reference/organicserpapi_getserpanalysiskeywords_get.md): Returns detailed search engine results page (SERP) analysis for a specific keyword, showing all domains ranking in positions 1-100. This endpoint provides comprehensive ranking data updated monthly to reveal the competitive landscape for any keyword.  [Visualize this API live on SpyFu](https://www.spyfu.com/keyword/serp-analysis?query=example%20keyword)
- [Get Highest Traffic Top Pages](https://developer.spyfu.com/reference/toppagesapi_getmosttraffictoppages_get.md): Returns the pages that generate the most organic traffic for a domain. This endpoint identifies the highest-performing content by estimated monthly organic clicks, revealing which pages drive the most SEO value and traffic to the site.  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/top-pages?query=example.com)
- [Get New Top Pages](https://developer.spyfu.com/reference/toppagesapi_getnewtoppages_get.md): Returns pages that have recently started generating significant organic traffic for a domain. This endpoint identifies newly discovered high-performing content, revealing fresh opportunities and emerging content strategies that are driving SEO success.  [Visualize this API live on SpyFu](https://www.spyfu.com/seo/top-pages/domain?query=example.com) _(TODO - verify)_
- [Get Top Performing Pages](https://developer.spyfu.com/reference/toppagesapi_gettoppages_get.md): Returns top organic pages for a domain, subdomain, path, or full URL. Use searchType to choose: MostTraffic (highest estimated SEO clicks) or New (newly gaining traffic). Results include page URL and monthly SEO clicks; optional keywordFilter narrows by ranked keywords.