Adgooroo API v2.0
Client Login
SEM Insight
MethodDescription
GetGroupsThis method retrieves basic data about a keyword group. The name and IDs for the keyword group, target (search engine/region monitored) and keywords in the group are retrieved.
GetKeywordDataThis method retrieves PPC data for a keyword, displayed by advertiser. This is the equivalent of the PPC Keyword Detail Report/Show Advertisers Tab in SEM Insight. Coverage, average position, ranking, captured impressions, clicks, CTR, spend and missed impressions for the keyword are retrieved. The currency used in calculate Cost and CPC is set by the user in the website.
GetNaturalGroupDataThis method retrieves natural data for a keyword group, displayed by advertiser. This is the equivalent to the Natural Keyword Group Detail Report/Overall Rankings tab in SEM Insight. The domain, coverage, average position, estimateed monthly impressions, and estimated monthly clicks for each keyword group are retrieved.
GetNaturalKeywordDataThis method retrieves Natural data for a keyword, displayed by domain. This is the equivalent of the SEO Keyword Detail Report in SEM Insight. The landing page, rank, clicks, weekly/monthly change in rank, and maximum rank for each keyword are retrieved.
GetGroupDataThis method retrieves PPC data for a keyword group, displayed by advertiser. This is the equivalent of the PPC Group Detail Report/Show Advertisers tab in SEM Insight. Coverage, average position, ranking, captured impressions, clicks, CTR, spend and missed impressions and impression share for the keyword group are retrieved. The currency used in calculate Cost and CPC is set by the user in the website.
SetGroupsThis method creates and deletes keyword groups. This method can also add or delete keywords in an existing keyword group.
GetAdvertiserDataThis method retrieves PPC data for an advertiser, displayed by keyword. This is the equivalent to the PPC Advertiser Detail Report/Show Keywords tab in SEM Insight. Coverage, average position, total search volume, impressions, missed impressions, clicks, CTR and spend for each keyword are retrieved. The currency used in calculate Cost and CPC is set by the user in the website.
GetGroupAdDataThis method retrieves PPC ad data for a group. This is the equivalent of the PPC Keyword Group Report/Show Ads Tab in SEM Insight. Ad, ad coverage, average position, destination url, and keywords for the keyword group are retrieved.
GetKeywordAdDataThis method retrieves PPC ad data for a keyword. This is the equivalent of the PPC Keyword Detail Report/Show Ads Tab in SEM Insight. Ad, ad coverage, average position, and destination url for the keyword are retrieved.
GetBulkAdvertiserDataThis method retrieves the same data as the GetAdvertiserData method, but returns data for the top 20 advertisers for the selected keyword group(s). After you select your inputs, call the API and retrieve a ReportID. Use the ReportID in the CheckBulkAdvertiserDataProgress method to retrieve the data. The currency used in calculate Cost and CPC is set by the user in the website.
CheckBulkAdvertiserDataProgressThis method retrives data for the ReportID retrieved from the GetBulkAdvertiserMethod. A "percent done" will be retrieved until the report is completed. Once the report is completed, the "file path" will return a URL where a .ZIP file can be downloaded which contains the report in the output specified.
GetHistoricalCoverageAndRankThis method retrieves an advertiser's coverage and rank for a keyword, displayed by day.
GetNaturalAdvertiserDataThis method retrieves natural data for an advertiser, displayed by keyword. This is the equivalent to the SEO Advertiser Detail Report/Keyword Rankings tab in SEM Insight. The landing page, rank, clicks, weekly/monthly change in rank, and maximum rank for each keyword are retrieved.
Trademark Insight
MethodDescription
GetTMGroupsThis method retrieves basic data for a trademark group. The name and IDs for the group, target (search engine/region monitored) and keyword are retrieved.
SetTMGroupsThis method creates and deletes trademark groups. This method can also add or delete keywords in an existing keyword group.
AdCopyIncidentsByAdvertiserThis method retrieves AdCopy Incidents by advertiser. This is the equivalent to the Incidents By Advertiser report/Ad Copy Incidents tab in TM Insight. The advertiser, search term, keyword, ad, ad display URL, ad destination URL, search engine, eearch volume, keyword CPC, keyword coverage and keyword avg rank are retrieved. The currency used in calculate CPC is set by the user in the website.
BiddingIncidentsByAdvertiserThis method retrieves Bidding Incidents by advertiser. This is the equivalent to the Incidents By Advertiser report/Bidding Incidents tab in TM Insight. The advertiser, keyword, ad, ad display URL, ad destination URL, search engine, search volume, keyword CPC, keyword coverage and keyword avg rank are retrieved. The currency used in calculate CPC is set by the user in the website.
GetTMFiltersThis method retrives a list of filtered URLs for a Trademark Insight account.
SetTMFiltersThis method updates the filtered URLs for a Trademark Insight account.
Utilities
MethodDescription
GetKeywordGroupsThis method retrieves SEM Insight keyword group names and IDs.
GetSearchEnginesThis method retrieves search engine names and IDs.
GetRegionsThis method retrieves region names and IDs.
GetMonthlyQuotaInfoThis method retrieves the amount of API points left in your monthly quota.
GetTargetsThis method retrieves information about targets. A target is a combination of search engine and region. Every unique combination of search engine and region is assigned a target ID. This method retrieves all target IDs, which also includes the search engine name and ID, and region name and ID for the target.
GetInfoThis method retrieves information an AdGooroo account. Information for sub-accounts is also displayed. The username(s), user ID, number of keywords used/subscribed to number of TM/Display/Link licenses used/subscribed to is retrieved.