LookSmart® API v4.0 Developer Implementation Guide
  Introduction
  Accounts Service
  Campaigns Service
  Ad Groups Service
  Ads Service
  Keywords Service
  Reports Service
  Geo Locations
Frequently Asked Questions
Implementation Guide

version 3
 

Reports Service

Please note that neither impression nor conversion data is available before 03/22/2008. API requests for campaign, ad or keyword impression or conversion data before that date will result in an error.

WSDL

Campaign Reporting Methods

getCampaignConvReportsForAccount

Get a conversion report for all campaigns in an account for a given date range.

Parameters

token String API authentication token
account_id int The account for which campaign report data is being requested
start_date Date Desired start date for the report.
end_date Date Desired end date for the report

Response

CampaignConvReportStruct[] An array of data structures containing campaign conversion report information for all campaigns in the specified account for the given date range

getCampaignGeoReportsForAccount

Get a click and cost report for all campaigns in the specified account for the given geo location type and date range.

Parameters

token String API authentication token
account_id int The account for which campaign report data is being requested
start_date Date Desired start date for the report.
end_date Date Desired end date for the report
location String Desired geo location type. Valid values are:
  • country
  • state
  • dma
  • city
  • postal

Response

CampaignGeoReportStruct[] An array of data structures containing campaign traffic report information for the specified account, geographic location type and date range.

getCampaignImpReportsForAccount

Get an impression report information for all campaigns in the specified account for the given date range.

Parameters

token String API authentication token
account_id int The account for which campaign report data is being requested
start_date Date Desired start date for the report.
end_date Date Desired end date for the report

Response

CampaignImpReportStruct[] An array of data structures containing campaign impression report information for all campaigns in the specified account for the given date range

getCampaignReportsForAccount

Get a traffic report for all campaigns in the specified account for the given date range.

Parameters

token String API authentication token
account_id int The account for which campaign report data is being requested
start_date Date Desired start date for the report
end_date Date Desired end date for the report

Response

CampaignImpReportStruct[] An array of data structures containing campaign traffic report information for all campaigns in the specified account for the given date range

getCampaignConvReport

Get a conversion report for the specified campaign and date range.

Parameters

token String API authentication token
campaign_id int The target campaign
start_date Date Desired start date for the report
end_date Date Desired end date for the report

Response

CampaignConvReportStruct A data structure containing campaign conversion report information for the specified date range

getCampaignGeoReport

Get a traffic report for the specified campaign and the given geo location type and date range.

Parameters

token String API authentication token
campaign_id int The target campaign
start_date Date Desired start date for the report
end_date Date Desired end date for the report
location String Desired geo location type. Valid values are:
  • country
  • state
  • dma
  • city
  • postal

Response

CampaignGeoReportStruct A data structure containing campaign traffic report information for the specified date range and geographic location.

getCampaignImpReport

Get an impression report for the specified campaign and date range.

Parameters

token String API authentication token
campaign_id int The target campaign
start_date Date Desired start date for the report
end_date Date Desired end date for the report

Response

CampaignImpReportStruct A data structure containing campaign impression report information for the specified date range

getCampaignReport

Get a traffic report for a given campaign and date range.

Parameters

token String API authentication token
campaign_id int System assigned unique ID of the campaign for which report data is requested
start_date Date Desired start date for the report.
end_date Date Desired end date for the report

Response

CampaignReportStruct A data structure containing campaign traffic report information for the specified date range