Mercado Ads

Availability

Core Standard Plus Pro Enterprise Flex Self-Managed Enterprise PyAirbyte

Support Level

Marketplace

Connector Version

0.0.29 (last updated a month 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

Input	Type	Description	Default Value
client_id	string	Client ID.
client_secret	string	Client secret.
client_refresh_token	string	Refresh token.
lookback_days	number	Lookback Days.	7
start_date	string	Start Date. Cannot exceed 90 days from current day for Product Ads, and 90 days from "End Date" on Brand and Display Ads
end_date	string	End Date. Cannot exceed 90 days from current day for Product Ads

Streams

Stream Name	Primary Key	Pagination	Supports Full Sync	Supports Incremental
brand_advertisers	advertiser_id	No pagination	✅	❌
brand_campaigns	advertiser_id.campaign_id	No pagination	✅	❌
brand_campaigns_metrics	date.advertiser_id.campaign_id	DefaultPaginator	✅	✅
brand_items	advertiser_id.campaign_id.item_id	No pagination	✅	❌
brand_keywords	advertiser_id.campaign_id.term.match_type	No pagination	✅	❌
brand_keywords_metrics	date.advertiser_id.campaign_id	DefaultPaginator	✅	✅
display_advertisers	advertiser_id	No pagination	✅	❌
display_campaigns	advertiser_id.campaign_id	No pagination	✅	❌
display_campaigns_metrics	date.advertiser_id.campaign_id	No pagination	✅	✅
display_line_items	advertiser_id.campaign_id.line_item_id	No pagination	✅	❌
display_line_items_metrics	date.advertiser_id.campaign_id.line_item_id	No pagination	✅	✅
display_creatives	advertiser_id.campaign_id.line_item_id	No pagination	✅	❌
product_advertisers	advertiser_id	No pagination	✅	❌
product_campaigns	advertiser_id.campaign_id	DefaultPaginator	✅	❌
product_campaigns_metrics	date.advertiser_id.campaign_id	DefaultPaginator	✅	✅
product_items	advertiser_id.campaign_id.item_id	DefaultPaginator	✅	❌
product_items_metrics	date.advertiser_id.campaign_id.item_id	DefaultPaginator	✅	✅

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

end_date

string

start_date

Changelog

Expand to review

Version	Date	Pull Request	Subject
0.0.29	2026-04-28	77296	Update dependencies
0.0.28	2026-04-21	76679	Update dependencies
0.0.27	2026-03-31	75834	Update dependencies
0.0.26	2026-03-24	74582	Update dependencies
0.0.25	2026-02-24	73811	Update dependencies
0.0.24	2026-02-17	73382	Update dependencies
0.0.23	2026-02-10	73186	Update dependencies
0.0.22	2026-02-03	72689	Update dependencies
0.0.21	2026-01-20	72022	Update dependencies
0.0.20	2026-01-14	71531	Update dependencies
0.0.19	2025-12-18	70785	Update dependencies
0.0.18	2025-11-25	70094	Update dependencies
0.0.17	2025-11-18	69576	Update dependencies
0.0.16	2025-10-29	69068	Update dependencies
0.0.15	2025-10-21	68437	Update dependencies
0.0.14	2025-10-14	67833	Update dependencies
0.0.13	2025-10-07	67378	Update dependencies
0.0.12	2025-09-30	66343	Update dependencies
0.0.11	2025-09-09	65839	Update dependencies
0.0.10	2025-08-23	65192	Update dependencies
0.0.9	2025-08-16	64977	Update dependencies
0.0.8	2025-08-02	64270	Update dependencies
0.0.7	2025-07-26	63897	Update dependencies
0.0.6	2025-07-19	63442	Update dependencies
0.0.5	2025-07-12	63257	Update dependencies
0.0.4	2025-07-05	62576	Update dependencies
0.0.3	2025-06-28	62401	Update dependencies
0.0.2	2025-06-21	61136	Update dependencies
0.0.1	2025-05-26		Initial release by @joacoc2020 via Connector Builder