Skip to main content

Mercado Ads

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable PyAirbyte
Connector type (beta)
Available Data replicationNot available Agent(learn more)
Support Level
Marketplace
Connector Version
0.0.47 (last updated 7 days ago)
Data workers used
0.2 per sync (Learn more)
Definition ID
ada19dae-81e5-4241-8e64-a9b2680b1b35

Get ad analytics from all Mercado Ads placements

Configuration​

InputTypeDescriptionDefault Value
client_idstringClient ID.
client_secretstringClient secret.
client_refresh_tokenstringRefresh token.
lookback_daysnumberLookback Days.7
start_datestringStart Date. Cannot exceed 90 days from current day for Product Ads, and 90 days from "End Date" on Brand and Display Ads
end_datestringEnd Date. Cannot exceed 90 days from current day for Product Ads
access_tokenstringAccess Token. Managed automatically by the connector; leave empty.
token_expiry_datestringToken Expiry Date. Managed automatically by the connector; leave empty.
note

Mercado Libre refresh tokens are single-use: every call to /oauth/token invalidates the refresh token that was used and returns a new one (see Authentication and Authorization). The connector persists the rotated client_refresh_token back into the source configuration after each refresh, so the refresh token you enter must not have been used anywhere else (for example in a manual curl call or another integration) after you obtained it. If you see an invalid_grant error, generate a fresh refresh token and update the source configuration.

Streams​

Stream NamePrimary KeyPaginationSupports Full SyncSupports Incremental
brand_advertisersadvertiser_idNo pagination✅❌
brand_campaignsadvertiser_id.campaign_idNo pagination✅❌
brand_campaigns_metricsdate.advertiser_id.campaign_idDefaultPaginator✅✅
brand_itemsadvertiser_id.campaign_id.item_idNo pagination✅❌
brand_keywordsadvertiser_id.campaign_id.term.match_typeNo pagination✅❌
brand_keywords_metricsdate.advertiser_id.campaign_idDefaultPaginator✅✅
display_advertisersadvertiser_idNo pagination✅❌
display_campaignsadvertiser_id.campaign_idNo pagination✅❌
display_campaigns_metricsdate.advertiser_id.campaign_idNo pagination✅✅
display_line_itemsadvertiser_id.campaign_id.line_item_idNo pagination✅❌
display_line_items_metricsdate.advertiser_id.campaign_id.line_item_idNo pagination✅✅
display_creativesadvertiser_id.campaign_id.line_item_idNo pagination✅❌
product_advertisersadvertiser_idNo pagination✅❌
product_campaignsadvertiser_id.campaign_idDefaultPaginator✅❌
product_campaigns_metricsdate.advertiser_id.campaign_idDefaultPaginator✅✅
product_itemsadvertiser_id.campaign_id.item_idDefaultPaginator✅❌
product_items_metricsdate.advertiser_id.campaign_id.item_idDefaultPaginator✅✅

IP allow list​

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference​

Config fields reference

Field
Type
Property name
Client ID
required
string
client_id
Refresh token
required
string
client_refresh_token
Client secret
required
string
client_secret
number
lookback_days
string
access_token
string
end_date
string
start_date
string
token_expiry_date

Changelog​

Expand to review
VersionDatePull RequestSubject
0.0.482026-10-2089290Update dependencies
0.0.472026-10-1388698Update dependencies
0.0.462026-10-0788243Persist Mercado Libre's rotated single-use refresh token (refresh_token_updater), surface invalid_grant as a config error, fix double slash in brand_keywords_metrics path
0.0.452026-10-0687946Update dependencies
0.0.442026-09-2987245Update dependencies
0.0.432026-09-2286711Update dependencies
0.0.422026-09-1586141Update dependencies
0.0.412026-09-0885568Update dependencies
0.0.402026-08-1884657Update dependencies
0.0.392026-08-1184024Update dependencies
0.0.382026-08-0483536Update dependencies
0.0.372026-07-2882985Update dependencies
0.0.362026-07-2182489Update dependencies
0.0.352026-07-1481897Update dependencies
0.0.342026-06-3081144Update dependencies
0.0.332026-06-2380537Update dependencies
0.0.322026-06-1679954Update dependencies
0.0.312026-06-0979395Update dependencies
0.0.302026-06-0278848Update dependencies
0.0.292026-04-2877296Update dependencies
0.0.282026-04-2176679Update dependencies
0.0.272026-03-3175834Update dependencies
0.0.262026-03-2474582Update dependencies
0.0.252026-02-2473811Update dependencies
0.0.242026-02-1773382Update dependencies
0.0.232026-02-1073186Update dependencies
0.0.222026-02-0372689Update dependencies
0.0.212026-01-2072022Update dependencies
0.0.202026-01-1471531Update dependencies
0.0.192025-12-1870785Update dependencies
0.0.182025-11-2570094Update dependencies
0.0.172025-11-1869576Update dependencies
0.0.162025-10-2969068Update dependencies
0.0.152025-10-2168437Update dependencies
0.0.142025-10-1467833Update dependencies
0.0.132025-10-0767378Update dependencies
0.0.122025-09-3066343Update dependencies
0.0.112025-09-0965839Update dependencies
0.0.102025-08-2365192Update dependencies
0.0.92025-08-1664977Update dependencies
0.0.82025-08-0264270Update dependencies
0.0.72025-07-2663897Update dependencies
0.0.62025-07-1963442Update dependencies
0.0.52025-07-1263257Update dependencies
0.0.42025-07-0562576Update dependencies
0.0.32025-06-2862401Update dependencies
0.0.22025-06-2161136Update dependencies
0.0.12025-05-26Initial release by @joacoc2020 via Connector Builder
Was this page helpful?