Etarget Api

Methods:

Agency

customersStats
getAccessToken
getCustomers

Customer

extraReach
getAccessToken
getPPCCampaignDailyStats
getPPCCampaignStats
getPPCCampaigns
getPPCCampaignsFull
getRTBCampaignCreatives
getRTBCampaignDailyStats
getRTBCampaignStats
getRTBCampaigns
getRTBCreativeDailyStats
getRTBCreativeStats
getRTBSiteDailyStats
getRTBSiteStats

Excel

getActiveCampaignStats
getCreditSpend
getCustomerSpend

Partner

createPartner
getAccessToken
getExternalPublisherStats
getPartner
getPartnerDashboardData
getPartnerPaymentStats
getPortalStats
updatePartner

Agency

customersStats

Path: https://api.etarget.bg/agency/customersStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of Customers
Error Response:
Status CodeError BodyDescription
400stringError description
customersStats

getAccessToken

Path: https://api.etarget.bg/agency/getAccessToken
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
loginstringY
pswstringY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
getAccessToken

getCustomers

Path: https://api.etarget.bg/agency/getCustomers
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of Customers
Error Response:
Status CodeError BodyDescription
400stringError description
getCustomers

CampaignFullStats

Path: https://api.etarget.bg/CampaignFullStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
include_versionsintegerNSet to 1 to retrieve camapign versinon stats. Default 0
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of PPC Campaign stats
Error Response:
Status CodeError BodyDescription
400stringError description
CampaignFullStats

CustomOMGStats

Path: https://api.etarget.bg/CustomOMGStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
include_versionsintegerNSet to 1 to retrieve camapign versinon stats. Default 0
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of PPC Campaign stats
Error Response:
Status CodeError BodyDescription
400stringError description
CustomOMGStats

Customer

extraReach

Path: https://api.etarget.bg/customer/extraReach
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
campaign_namestringY
actionstringY
sourcestringY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
extraReach

getAccessToken

Path: https://api.etarget.bg/customer/getAccessToken
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
loginstringY
pswstringY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
getAccessToken

getPPCCampaignDailyStats

Path: https://api.etarget.bg/customer/getPPCCampaignDailyStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
include_versionsintegerNSet to 1 to retrieve camapign versinon stats. Default 0
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of PPC Campaign stats
Error Response:
Status CodeError BodyDescription
400stringError description
getPPCCampaignDailyStats

getPPCCampaignStats

Path: https://api.etarget.bg/customer/getPPCCampaignStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
include_versionsintegerNSet to 1 to retrieve camapign versinon stats. Default 0
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of PPC Campaign stats
Error Response:
Status CodeError BodyDescription
400stringError description
getPPCCampaignStats

getPPCCampaigns

Path: https://api.etarget.bg/customer/getPPCCampaigns
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of Campaigns (Basic view)
Error Response:
Status CodeError BodyDescription
400stringError description
getPPCCampaigns

getPPCCampaignsFull

Path: https://api.etarget.bg/customer/getPPCCampaignsFull
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of PPC Campaigns (Full view)
Error Response:
Status CodeError BodyDescription
400stringError description
getPPCCampaignsFull

getRTBCampaignCreatives

Path: https://api.etarget.bg/customer/getRTBCampaignCreatives
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idintegerYCampaign ID.
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of Creatives
Error Response:
Status CodeError BodyDescription
400stringError description
getRTBCampaignCreatives

getRTBCampaignDailyStats

Path: https://api.etarget.bg/customer/getRTBCampaignDailyStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of RTB Campaign stats
Error Response:
Status CodeError BodyDescription
400stringError description
getRTBCampaignDailyStats

getRTBCampaignStats

Path: https://api.etarget.bg/customer/getRTBCampaignStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of RTB Campaign stats
Error Response:
Status CodeError BodyDescription
400stringError description
getRTBCampaignStats

getRTBCampaigns

Path: https://api.etarget.bg/customer/getRTBCampaigns
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of Campaigns (Basic view)
Error Response:
Status CodeError BodyDescription
400stringError description
getRTBCampaigns

getRTBCreativeDailyStats

Path: https://api.etarget.bg/customer/getRTBCreativeDailyStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
creative_idsstringNComma-separated list of integers.
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of RTB Campaign stats
Error Response:
Status CodeError BodyDescription
400stringError description
getRTBCreativeDailyStats

getRTBCreativeStats

Path: https://api.etarget.bg/customer/getRTBCreativeStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
creative_idsstringNComma-separated list of integers.
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of RTB Campaign stats
Error Response:
Status CodeError BodyDescription
400stringError description
getRTBCreativeStats

getRTBSiteDailyStats

Path: https://api.etarget.bg/customer/getRTBSiteDailyStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
site_refsstringNComma-separated list of integers.
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of RTB Campaign stats
Error Response:
Status CodeError BodyDescription
400stringError description
getRTBSiteDailyStats

getRTBSiteStats

Path: https://api.etarget.bg/customer/getRTBSiteStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
site_refsstringNComma-separated list of integers.
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of RTB Campaign stats
Error Response:
Status CodeError BodyDescription
400stringError description
getRTBSiteStats

excel

getActiveCampaignStats

Path: https://api.etarget.bg/excel/getActiveCampaignStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
excel_tokenstringYContact us to get your token
time_fromtimestampNStart date of the statistics.(d.m.Y or timestamp)
lastintegerNLast X days of stats
exportTostringNAccepted values are: html, json. Default html
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
getActiveCampaignStats

excel

getCreditSpend

Path: https://api.etarget.bg/excel/getCreditSpend
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
excel_tokenstringYContact us to get your token
time_fromtimestampNStart date of the statistics.(d.m.Y or timestamp)
group_bystringNGroup by customer/campaign type/campaign/creative
lastintegerNLast X days of stats
exportTostringNAccepted values are: html, json. Default html
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
getCreditSpend

excel

getCustomerSpend

Path: https://api.etarget.bg/excel/getCustomerSpend
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
excel_tokenstringYContact us to get your token
time_fromtimestampNStart date of the statistics.(d.m.Y or timestamp)
group_bystringNGroup by customer/campaign type/campaign/creative
lastintegerNLast X days of stats
exportTostringNAccepted values are: html, json. Default html
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
getCustomerSpend

KeywordFullStats

Path: https://api.etarget.bg/KeywordFullStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
customer_idintegerYCustomer ID.
campaign_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
include_versionsintegerNSet to 1 to retrieve camapign versinon stats. Default 0
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of PPC Campaign stats
Error Response:
Status CodeError BodyDescription
400stringError description
KeywordFullStats

MarvaxCleanDB

Path: https://api.etarget.bg/MarvaxCleanDB
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxCleanDB

MarvaxCreateBanner

Path: https://api.etarget.bg/MarvaxCreateBanner
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
urlstringY
namestringN
marvax_customer_idintegerN
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxCreateBanner

MarvaxCreateCampaign

Path: https://api.etarget.bg/MarvaxCreateCampaign
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idintegerY
banner_idintegerY
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
schedulestringN
amountintegerY
country_codestringY
region_codesstringN
content_categroy_idintegerN
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxCreateCampaign

MarvaxCreateCustomer

Path: https://api.etarget.bg/MarvaxCreateCustomer
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idintegerY
emailstringN
sexintegerN
telephonestringN
urlstringN
first_namestringN
last_namestringN
streetstringN
zipstringN
citystringN
countrystringN
icostringN
icdphstringN
dicstringN
languagestringN
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxCreateCustomer

MarvaxGetBanner

Path: https://api.etarget.bg/MarvaxGetBanner
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
banner_idintegerY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetBanner

MarvaxGetBannerInteractionStats

Path: https://api.etarget.bg/MarvaxGetBannerInteractionStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idsstringNComma-separated list of integers.
banner_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetBannerInteractionStats

MarvaxGetBanners

Path: https://api.etarget.bg/MarvaxGetBanners
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idsstringNComma-separated list of integers.
banner_idsstringNComma-separated list of integers.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetBanners

MarvaxGetCustomer

Path: https://api.etarget.bg/MarvaxGetCustomer
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idintegerY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetCustomer

MarvaxGetCustomerInteractionStats

Path: https://api.etarget.bg/MarvaxGetCustomerInteractionStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetCustomerInteractionStats

MarvaxGetCustomerInvoices

Path: https://api.etarget.bg/MarvaxGetCustomerInvoices
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idintegerY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetCustomerInvoices

MarvaxGetCustomerRemainingFreeImpressions

Path: https://api.etarget.bg/MarvaxGetCustomerRemainingFreeImpressions
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idintegerY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetCustomerRemainingFreeImpressions

MarvaxGetCustomers

Path: https://api.etarget.bg/MarvaxGetCustomers
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idsstringNComma-separated list of integers.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetCustomers

MarvaxGetDailyBannerInteractionStats

Path: https://api.etarget.bg/MarvaxGetDailyBannerInteractionStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idsstringNComma-separated list of integers.
banner_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetDailyBannerInteractionStats

MarvaxGetDailyCustomerInteractionStats

Path: https://api.etarget.bg/MarvaxGetDailyCustomerInteractionStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetDailyCustomerInteractionStats

MarvaxGetFeed

Path: https://api.etarget.bg/MarvaxGetFeed
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
feed_idintegerY
limitintegerN
no_videointegerN
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetFeed

MarvaxGetFeeds

Path: https://api.etarget.bg/MarvaxGetFeeds
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
feed_idsstringNComma-separated list of integers.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxGetFeeds

MarvaxLinkBannerToCustomer

Path: https://api.etarget.bg/MarvaxLinkBannerToCustomer
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
banner_idintegerY
marvax_customer_idintegerY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxLinkBannerToCustomer

MarvaxNoteCardAddedToCustomer

Path: https://api.etarget.bg/MarvaxNoteCardAddedToCustomer
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idintegerY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxNoteCardAddedToCustomer

MarvaxNoteCardRemovedFromCustomer

Path: https://api.etarget.bg/MarvaxNoteCardRemovedFromCustomer
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idintegerY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxNoteCardRemovedFromCustomer

MarvaxStartCampaign

Path: https://api.etarget.bg/MarvaxStartCampaign
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idintegerY
campaign_idintegerYCampaign ID.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxStartCampaign

MarvaxStopCampaign

Path: https://api.etarget.bg/MarvaxStopCampaign
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idintegerY
campaign_idintegerYCampaign ID.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxStopCampaign

MarvaxUpdateBanner

Path: https://api.etarget.bg/MarvaxUpdateBanner
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
banner_idintegerY
marvax_customer_idintegerY
namestringN
is_fixedboolN
post_idsstringNComma-separated list of integers.
show_last_post_cntintegerN
show_post_without_imgboolN
statusintegerN1 - active, 2 - inactive
click_urlstringN
show_max_daysintegerN
new_post_notifyboolN
new_post_notify_emailstringN
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxUpdateBanner

MarvaxUpdateCampaign

Path: https://api.etarget.bg/MarvaxUpdateCampaign
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idintegerY
campaign_idintegerYCampaign ID.
time_fromtimestampNStart date of the statistics.(d.m.Y or timestamp)
time_totimestampNEnd date of the statistics.(d.m.Y or timestamp)
schedulestringN
amountintegerN
country_codestringN
region_codesstringN
content_categroy_idintegerN
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxUpdateCampaign

MarvaxUpdateCustomer

Path: https://api.etarget.bg/MarvaxUpdateCustomer
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
marvax_customer_idintegerY
emailstringN
sexintegerN
telephonestringN
urlstringN
first_namestringN
last_namestringN
streetstringN
zipstringN
citystringN
countrystringN
icostringN
icdphstringN
dicstringN
languagestringN
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxUpdateCustomer

MarvaxUpdateUserInteraction

Path: https://api.etarget.bg/MarvaxUpdateUserInteraction
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
banner_idintegerY
marvax_customer_idintegerY
interaction_typeintegerY1 - VIEW, 2 - MOUSE_OVER, 3 - ARROW, 4 - CLICK, 5 - MEASURABLE_VIEW, 6 - MEASURED_VIEW
interaction_urlstringY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
MarvaxUpdateUserInteraction

Partner

createPartner

Path: https://api.etarget.bg/partner/createPartner
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
emailstringY
loginstringY
passstringY
s_contact_telephonestringY
o_namestringY
typ_klientaintegerY
namestringN
reg_numstringN
s_streetstringY
s_citystringY
s_zipstringY
s_countrystringY
s_bank_account_numberstringY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonjson data
Error Response:
Status CodeError BodyDescription
400stringError description
createPartner

getAccessToken

Path: https://api.etarget.bg/partner/getAccessToken
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
loginstringY
pswstringY
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonstring
Error Response:
Status CodeError BodyDescription
400stringError description
getAccessToken

getExternalPublisherStats

Path: https://api.etarget.bg/partner/getExternalPublisherStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
partner_idintegerNPartner ID
publisher_idintegerN
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonExternal Publisher stats
Error Response:
Status CodeError BodyDescription
400stringError description
getExternalPublisherStats

getPartner

Path: https://api.etarget.bg/partner/getPartner
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
partner_idintegerNPartner ID
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonjson data
Error Response:
Status CodeError BodyDescription
400stringError description
getPartner

getPartnerDashboardData

Path: https://api.etarget.bg/partner/getPartnerDashboardData
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
partner_idintegerNPartner ID
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonjson data
Error Response:
Status CodeError BodyDescription
400stringError description
getPartnerDashboardData

getPartnerPaymentStats

Path: https://api.etarget.bg/partner/getPartnerPaymentStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
partner_idintegerNPartner ID
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonjson data
Error Response:
Status CodeError BodyDescription
400stringError description
getPartnerPaymentStats

getPortalStats

Path: https://api.etarget.bg/partner/getPortalStats
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
partner_idintegerNPartner ID
portal_idsstringNComma-separated list of integers.
time_fromtimestampYStart date of the statistics.(d.m.Y or timestamp)
time_totimestampYEnd date of the statistics.(d.m.Y or timestamp)
pageintegerNPage number. If not provided, defaults to 1.
page_sizeintegerNNumber of records per page. If not provided, defaults to 100. Maximum value is 1000.
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonPaginated List of Portal stats
Error Response:
Status CodeError BodyDescription
400stringError description
getPortalStats

updatePartner

Path: https://api.etarget.bg/partner/updatePartner
HTTP Method: GET
Accept: application/json
Query Parameters:
ParameterTypeRequiredDescription
access_tokenstringYObtained by getAccessToken call
partner_idintegerYPartner ID
s_passwordstringN
s_contact_namestringN
s_contact_telephonestringN
s_emailstringN
s_namestringN
s_icostringN
s_ic_dphstringN
s_streetstringN
s_citystringN
s_zipstringN
s_countrystringN
s_iban_numberstringN
Successful Response:
Status CodeContent-TypeRepresentation
200application/jsonjson data
Error Response:
Status CodeError BodyDescription
400stringError description
updatePartner

Representation:

Paginated List

FieldTypeDescription
totalCountintegerTotal number of items in the list, for all pages
paginationPaginationPagination information
resultsArray of Entity StatisticsArray of returned statistics paired with respective entities

Pagination

FieldTypeDescription
pageintegerPage number
page_sizeintegerNumber of items per page

PPC Campaign stats

FieldTypeDescription
timetimestampOnly in daily stats.
customer_idintegerCustomer ID
campaign_idintegerCampaign ID
viewsinteger
clicksinteger
ctrfloatClick-Through Rate
cpmfloatCost per 1000 views
cpcfloatCost per click
amountfloatCost in local currency
version_statsarrayCampaign version stats

RTB Campaign stats

FieldTypeDescription
timetimestampOnly in daily stats.
customer_idintegerCustomer ID
campaign_idintegerCampaign ID
creative_idintegerCreative ID. Only in Creative stats.
site_reftextSite ID.Only in Site stats.
domaintextDomian, only in Site stats.
impressions_bidintegerNumber of bids
impressions_wonintegerNumber of won bids(views)
clicksinteger
ctrfloatClick-Through Rate
cpmfloatCost per 1000 views
cpcfloatCost per click
amountfloatCost in local currency

Customer

FieldTypeDescription
customer_idintegerCustomer ID
namestringCustomer name.
statusintegerCustomer status 1-online, 2-offline, 3-banned, 255-deleted

Campaign (Basic view)

FieldTypeDescription
campaign_idintegerCampaign ID
namestringCampaign name.
statusintegerCampaign status 1-online, 2-offline, 3-banned, 4-deleted

Creative

FieldTypeDescription
creative_idintegerCreative ID
statusintegerCreative status 1-online, 2-offline, 3-banned, 4-deleted
widthinteger
heightinteger
img_urlstringURL of the image, Flash movie

PPC Campaign (Full view)

FieldTypeDescription
campaign_idintegerCampaign ID
namestringCampaign name.
campaign_bodyarrayArray of Campaign Ads
statusintegerCampaign status 1-online, 2-offline, 3-banned, 4-deleted
targeting_typeintegerCampaign targeting type, 1-broad, 2-retarget, 3-keyword, 4-category

Campaign Ad

FieldTypeDescription
titlestringAd title
line1stringFirst line of the Ad.
line2stringSecond line of the Ad.
urlstringShown url
real_urlstringClick url
version_statusintegerAd status 1-online, 2-offline
logoarrayArray containing Logo data.

Logo

FieldTypeDescription
logo_idintegerId
urlstringImage url

Portal Stats

FieldTypeDescription
partner_idintegerPartner ID
portal_idintegerPortal ID
nameintegerPortal name
urlintegerPortal url
viewsinteger
clicksinteger
ctrfloatClick-Through Rate
cpcfloatCost per click
cpmfloatCost per 1000 views
amountfloatCost in local currency

External Publisher Stats

FieldTypeDescription
statusstringPending/Ready
messagestring
reportcsvstats
контакт

ЕТАРГЕТ 30-32’ Gen. E.I.Totleben blvd., fl. 2* 1606 София, България

business@etarget.bg

0877 694 366