Google Ads History API Documentation (v3)

Access the complete Google Ads campaign history for any website. We have every ad run on any keyword any time in the last 10+ years.

Authentication

Basic Auth Token

Security scheme type:	HTTP
HTTP Authorization Scheme	basic

api_key

Secret Key Authentication

Security scheme type:	API Key
Query parameter name:	api_key

AdHistoryApi

Find the most successful copy from 9 years of ad evolution. Google won't tell you that some keywords are time-wasting money pits. Here, you can spot patterns of many advertisers dropping keywords that haven't been profitable for anyone.

Get ad history by domain Deprecated

get /domain_ad_history_json

https://www.spyfu.com:80/apis/ad_history_api/domain_ad_history_json

query Parameters

d required	string Domain query
m	integer <int32> Maximum number of returned results
r	integer <int32> Maximum number of domains
s	integer <int32> Starting row (0 based)
isUs	boolean Flag for US vs UK data
api_key	string User's secret key

Responses

200

500

InternalServerError

Request samples

cURL
JS
C#
PHP

Copy

curl "https://www.spyfu.com/apis/ad_history_api/domain_ad_history_json?d=spyfu.com&r=10&s=0&isUs=true&api_key=SECRET_KEY"

Response samples

Content type

Copy

Expand all Collapse all

[

{
- "keywords":
  [
  - "competitors adwords",
  - "adwords competition",
  - "find competitor adwords",
  - "adwords competitor",
  - "adwords spy tool",
  - "check competitors adwords",
  - "find out competitors adwords",
  - "find competitors keywords adwords",
  - "Adword spy",
  - "google adwords competitors",
  - "free adwords advertising",
  - "adwords competitor tool",
  - "keywords for adwords",
  - "competitors adwords campaigns",
  - "find adwords competitors",
  - "what keywords competitors are usingadwords keyword planner tool",
  - "competions adword",
  - "track competitors adwords",
  - "view competitors adwords",
  - "competitor adwords",
  - "google adwords competitors keywords",
  - "adwords competitor spy",
  - "free adword spy",
  - "competitors adwords ads",
  - "competitors of google adwords",
  - "adwords competitor clicking my ads",
  - "your competitorstargetedkeywords ppc",
  - "adword keyword cost",
  - "competitions adword",
  - "adwords help analyze competition",
  - "adwords competitors",
  - "your competitors seopayadwords competitors keywords",
  - "how to find competitors adwords keywords",
  - "adword competitor analysis",
  - "comptitions adword",
  - "adword spy tool",
  - "google adwords competitor",
  - "spy adwords competitors",
  - "google adwords spy",
  - "analyse competitor keywords"
  ],
- "position": 1,
- "searchDateId": 20180301,
- "title": "Spy On AdWords Competitors | Download Their Keywords Now",
- "body": "Discover The Most Profitable Keywords& Ads For PPC & SEO. No CC Required.",
- "url": "http://spyfu.com/",
- "adId": -112055996
},
{
- "keywords":
  [
  - "competitor keyword analysis tool",
  - "competitor keyword analysis",
  - "competitors keywords",
  - "find good keywords",
  - "keywords spy",
  - "key word search",
  - "keyword research and competition analysis",
  - "keyword spying",
  - "keywords competitors",
  - "keyword competition research tool",
  - "keyword research",
  - "free keyword research tool",
  - "generate keywords free",
  - "competitors keyword tool",
  - "keyword competitor tool",
  - "keywordsanalyzer",
  - "key word tool",
  - "research competitor keywords",
  - "free keyword search tools for windows 7 with competition research",
  - "your competitorstargetedkeywords ppc",
  - "best keyword spy tool",
  - "find longtail keywords",
  - "research competitor keywordsa keyword research",
  - "best keyword spy too",
  - "competitor keyword tracking",
  - "check keyword competition",
  - "analyse competitor keywords"
  ],
- "position": 1,
- "searchDateId": 20180301,
- "title": "#1 Free Keyword Research Tool | Download Competitor Keywords",
- "body": "Build The Most Profitable Keyword Lists. Track Rankings & Spy On Competitor Data",
- "url": "http://spyfu.com/",
- "adId": 410684974
}

]

Get ad history by domain with keyword metrics Deprecated

get /domain_ad_history_with_metrics

https://www.spyfu.com:80/apis/ad_history_api/domain_ad_history_with_metrics

query Parameters

d required	string Domain query
m	integer <int32> Maximum number of returned results
r	integer <int32> Maximum number of rows
isUs	boolean Flag for US vs UK data
api_key	string User's secret key

Responses

200

500

InternalServerError

Request samples

cURL
JS
C#
PHP

Copy

curl "https://www.spyfu.com/apis/ad_history_api/domain_ad_history_with_metrics?d=spyfu.com&api_key=SECRET_KEY"

Response samples

Content type

Copy

Expand all Collapse all

{

"keywords":
[
- {
  - "ads":
    [
    {
    "ad_id": "-1758441585",
    "body": "Discover The Most Profitable Keywords& Ads. Download Data Now. No CC Required.",
    "position": 14,
    "search_date_id": 20151101,
    "title": "#1 Competitor Analysis",
    "url": "http://www.spyfu.com/?c=1&g=409&a=1"
    },
    {
    "ad_id": "1701959258",
    "body": "Discover The Most Profitable Keywords& Ads. Download Data Now. No CC Required.",
    "position": 11,
    "search_date_id": 20111201,
    "title": "SpyFu® Official Site",
    "url": "http://www.spyfu.com/lp/us/default.aspx"
    }
    ],
  - "broad_cpc": 11.48,
  - "broad_daily_clicks": 0.12,
  - "coverage": 1,
  - "cpc": 11.48,
  - "daily_clicks": 0.12,
  - "exact_cpc": 11.48,
  - "exact_daily_clicks": 0.12,
  - "keyword": "competitors adwords",
  - "phrase_cpc": 11.48,
  - "phrase_daily_clicks": 0.12,
  - "term_id": 29972184
  }
],
"top_ads":
[
- {
  - "ad_id": "584822763",
  - "avg_ad_pos": 1.6474358974358974,
  - "avg_total_ads": 8.600427350427351,
  - "body": "Discover The Most Profitable Keywords & Ads. Free To Try. No CC Required.",
  - "coverage": 0.2955390334572491,
  - "histogram": "",
  - "leaderboard_count": 422,
  - "leaderboard_percent": 0.9017094017094017,
  - "title": "Spy On AdWords Competitors - Download Their Keywords Now.",
  - "url": "http://spyfu.com/"
  },
- {
  - "ad_id": "-1395533934",
  - "avg_ad_pos": 1.0687022900763359,
  - "avg_total_ads": 3.366412213740458,
  - "body": "Search for any competitor. Download their keywords. It's that simple.",
  - "coverage": 0.08921933085501858,
  - "histogram": "",
  - "leaderboard_count": 131,
  - "leaderboard_percent": 1,
  - "title": "spyfu.com - SpyFu Official Site - Download Competitor Keywords",
  - "url": "http://spyfu.com/"
  }
],
"keyword_count": 4721,
"resultCount": 200

}

Get ad history CSV by domain Deprecated

get /domain_ad_history

https://www.spyfu.com:80/apis/ad_history_api/domain_ad_history

query Parameters

d required	string Domain query
m	integer <int32> Maximum number of returned results
r	integer <int32> Maximum number of domains
isUs	boolean Flag for US vs UK data
api_key	string User's secret key

Responses

200

500

InternalServerError

Request samples

cURL
JS
C#
PHP

Copy

curl "https://www.spyfu.com/apis/ad_history_api/domain_ad_history?d=spyfu.com&api_key=SECRET_KEY"

Response samples

Content type

Copy

Expand all Collapse all

[

[
- "Position",
- "Search_Date_Id",
- "Keywords",
- "Title",
- "Body",
- "Url"
],
[
- "1",
- "=\\\"20170201\\\"",
- "\\\"keyword tool,keyword tool,keyword tool,keyword tool,keyword tool,keyword tool,keyword tool,keyword tool,keyword tool,keyword tool\\\"",
- "=\\\"#1 Free Keyword Tool\\\"",
- "=\\\"Discover Most Profitable Keywords10 Years Competitor Data\\\"",
- "=\\\"http://spyfu.com/\\\""
],
[
- "2",
- "=\\\"20161101\\\"",
- "\\\"keyword tool,keyword tools,keyword tools,keyword search tool,keywords search tool,keword tool,keword tool,keword tool,KEYWORDS CHECK,search keywords tool,keywords tool,keywords tool,keyword tools review\\\"",
- "=\\\"SpyFu Keyword Research Tools\\\"",
- "=\\\"The Official Keyword SpyDiscover The Most Profitable Keywords & Ads\\\"",
- "=\\\"http://spyfu.com/\\\""
]

]

Get ad history by term Deprecated

get /term_ad_history_json

https://www.spyfu.com:80/apis/ad_history_api/term_ad_history_json

query Parameters

t required	string Term query
m	integer <int32> Maximum number of returned results
maxSearchDateId	integer <int32> Maximum search date (YYYYMMDD)
minSearchDateId	integer <int32> Minimum search date (YYYYMMDD)
isUs	boolean Flag for US vs UK data
api_key	string User's secret key

Responses

200

500

InternalServerError

Request samples

cURL
JS
C#
PHP

Copy

curl "https://www.spyfu.com/apis/ad_history_api/term_ad_history_json?t=bunny slippers&api_key=SECRET_KEY"

Response samples

Content type

Copy

Expand all Collapse all

[

{
- "domainName": null,
- "urls":
  [
  ],
- "position": 1,
- "searchDateId": 20170701,
- "title": "BunnySlippers.com",
- "body": "High Quality - Classic Style - Bunny Slippers for the Whole family",
- "adId": -658092963
},
{
- "domainName": null,
- "urls":
  [
  - "http://www.bunnyslippers.com/shop/Bunny-Slippers.html",
  - "http://bunnyslippers.com/"
  ],
- "position": 1,
- "searchDateId": 20170301,
- "title": "BunnySlippers.com - High Quality - Classic Style",
- "body": "Bunny Slippers for the Whole family",
- "adId": -370169151
}

]

Get ad history by term with domain metrics Deprecated

get /term_ad_history_with_metrics

https://www.spyfu.com:80/apis/ad_history_api/term_ad_history_with_metrics

query Parameters

t required	string Term query
m	integer <int32> Maximum number of returned results
maxSearchDateId	integer <int32> Maximum search date (YYYYMMDD)
minSearchDateId	integer <int32> Minimum search date (YYYYMMDD)
isUs	boolean Flag for US vs UK data
api_key	string User's secret key

Responses

200

500

InternalServerError

Request samples

cURL
JS
C#
PHP

Copy

curl "https://www.spyfu.com/apis/ad_history_api/term_ad_history_with_metrics?t=bunny slippers&api_key=SECRET_KEY"

Response samples

Content type

Copy

Expand all Collapse all

{

"domainCount": 153,
"domains":
[
- {
  - "histogramData": 0,
  - "ads":
    [
    {
    "adId": -658092963,
    "searchDateId": 20170701,
    "position": 1,
    "title": "BunnySlippers.com",
    "body": "High Quality - Classic Style - Bunny Slippers for the Whole family",
    "extendedBody": "Sizes 4 the Whole Family - For Men, Women & Kids Types: Classic Bunny Slippers, Bunny Rabbit Slippers, Bunny Slouch Slippers… Novelty Slippers - Bunny Slippers - FAQs - Animal Slippers - Home - Contac",
    "domainName": "bunnyslippers.com",
    "fullUrl": "http://bunnyslippers.com/",
    "term": "bunny slippers",
    "termId": 2300426,
    "adCount": 1,
    "isLeaderboardAd": false,
    "isThrottled": false
    },
    {
    "adId": -370169151,
    "searchDateId": 20170301,
    "position": 1,
    "title": "BunnySlippers.com - High Quality - Classic Style",
    "body": "Bunny Slippers for the Whole family",
    "extendedBody": "Features: Cotton Ball Tail, Fluffy Footbed… Animal Slippers - Home - Bunny Slippers - Novelty Slippers - Contact Us - FAQs",
    "domainName": "bunnyslippers.com",
    "fullUrl": "http://bunnyslippers.com/",
    "term": "bunny slippers",
    "termId": 2300426,
    "adCount": 3,
    "isLeaderboardAd": false,
    "isThrottled": false
    }
    ],
  - "budget": 2730.039,
  - "coverage": 0.08333333333333333,
  - "domainId": 8290935754279865000,
  - "domainName": "bunnyslippers.com",
  - "percentageLeaderboard": 0,
  - "totalAdsPurchased": 32,
  - "isThrottled": false,
  - "potentialViews": 12,
  - "adCount": 1
  }
],
"topAds":
[
- {
  - "adId": -658092963,
  - "averagePosition": 1.45,
  - "averageAdCount": 9.025,
  - "body": "High Quality - Classic Style - Bunny Slippers for the Whole family",
  - "extendedBody": "",
  - "title": "BunnySlippers.com",
  - "fullUrl": "http://bunnyslippers.com/",
  - "leaderboardCount": 22,
  - "percentageLeaderboard": 0.55,
  - "percentageAdsServed": 1
  }
],
"resultCount": 152

}

Get ad history CSV by term Deprecated

get /term_ad_history

https://www.spyfu.com:80/apis/ad_history_api/term_ad_history

query Parameters

t required	string Term query
maxSearchDateId	integer <int32> Maximum search date (YYYYMMDD)
minSearchDateId	integer <int32> Minimum search date (YYYYMMDD)
isUs	boolean Flag for US vs UK data
m	integer <int32> Maximum number of returned results
api_key	string User's secret key

Responses

200

500

InternalServerError

Request samples

cURL
JS
C#
PHP

Copy

curl "https://www.spyfu.com/apis/ad_history_api/term_ad_history?t=bunny slippers&api_key=SECRET_KEY"

Response samples

Content type

Copy

Expand all Collapse all

{

"domainCount": 153,
"domains":
[
- {
  - "histogramData": 0,
  - "ads":
    [
    {
    "adId": -658092963,
    "searchDateId": 20170701,
    "position": 1,
    "title": "BunnySlippers.com",
    "body": "High Quality - Classic Style - Bunny Slippers for the Whole family",
    "extendedBody": "Sizes 4 the Whole Family - For Men, Women & Kids Types: Classic Bunny Slippers, Bunny Rabbit Slippers, Bunny Slouch Slippers… Novelty Slippers - Bunny Slippers - FAQs - Animal Slippers - Home - Contac",
    "domainName": "bunnyslippers.com",
    "fullUrl": "http://bunnyslippers.com/",
    "term": "bunny slippers",
    "termId": 2300426,
    "adCount": 1,
    "isLeaderboardAd": false,
    "isThrottled": false
    },
    {
    "adId": -370169151,
    "searchDateId": 20170301,
    "position": 1,
    "title": "BunnySlippers.com - High Quality - Classic Style",
    "body": "Bunny Slippers for the Whole family",
    "extendedBody": "Features: Cotton Ball Tail, Fluffy Footbed… Animal Slippers - Home - Bunny Slippers - Novelty Slippers - Contact Us - FAQs",
    "domainName": "bunnyslippers.com",
    "fullUrl": "http://bunnyslippers.com/",
    "term": "bunny slippers",
    "termId": 2300426,
    "adCount": 3,
    "isLeaderboardAd": false,
    "isThrottled": false
    }
    ],
  - "budget": 2730.039,
  - "coverage": 0.08333333333333333,
  - "domainId": 8290935754279865000,
  - "domainName": "bunnyslippers.com",
  - "percentageLeaderboard": 0,
  - "totalAdsPurchased": 32,
  - "isThrottled": false,
  - "potentialViews": 12,
  - "adCount": 1
  }
],
"topAds":
[
- {
  - "adId": -658092963,
  - "averagePosition": 1.45,
  - "averageAdCount": 9.025,
  - "body": "High Quality - Classic Style - Bunny Slippers for the Whole family",
  - "extendedBody": "",
  - "title": "BunnySlippers.com",
  - "fullUrl": "http://bunnyslippers.com/",
  - "leaderboardCount": 22,
  - "percentageLeaderboard": 0.55,
  - "percentageAdsServed": 1
  }
],
"resultCount": 152

}