Nextdoor
N
Nextdoor

tap-nextdoor (meltanolabs variant)

Nextdoor is a neighbourhood social network. Nextdoor Ads Manager (NAM) is its self-serve advertising platform, where businesses run campaigns targeted at specific neighbourhoods, postal codes or radii, and measure them with the Nextdoor conversion pixel.

This tap extracts the objects an advertiser manages in NAM - advertisers, campaigns, ad groups, ads, creatives and custom audiences - plus performance reporting, through the Nextdoor Ads API.

Some NAM actions remain UI-only (initial sign-up, payment methods, adding or archiving custom audiences, archiving media assets), so they cannot be extracted.

Available Streams

StreamReplicationReplication Key
usersFull Table—
profilesFull Table—
advertisersFull Table—
campaignsIncrementalupdated_at
ad_groupsIncrementalupdated_at
adsIncrementalupdated_at
creativesIncrementalupdated_at
reportsFull Table—
ad_statsFull Table—
performance_reportFull Table—
custom_audiencesIncrementalupdated_at

users

The NAM user that owns the access token, and which advertisers they can reach.

FieldTypeDescription
idstringThe user's ads ID
namestringUser's display name
emailstringUser's email address
email_confirmedbooleanWhether the user has confirmed their email
advertisers_with_accessarrayAdvertisers this user can access, with their role on each

profiles

The advertising profile behind the token, including its billing profile and whether it is an agency.

FieldTypeDescription
idstringThe profile's ads ID
namestringProfile name
associated_user_idsarrayUsers attached to this profile
payment_profile_idstringBilling profile backing this advertising profile
is_ad_agencybooleanWhether the profile represents an agency

advertisers

Advertiser accounts the token can access. Read from the /me endpoint, since the Ads API has no advertiser list endpoint, and optionally narrowed with Advertiser IDs.

FieldTypeDescription
advertiser_idstringAdvertiser ID. Sourced from id in the API response, which the reference docs call advertiser_id.
rolestringThe token holder's role on this advertiser, e.g. CLIENT_ADMIN

campaigns

Campaigns, with objective, status and flight dates.

Supports incremental replication using updated_at.

FieldTypeDescription
idstringCampaign ID
advertiser_idstringID of the advertiser that owns the campaign
namestringCampaign name
statusstringEffective delivery status, e.g. ACTIVE, PAUSED, ARCHIVED. May differ from user_status when a parent is paused.
user_statusstringStatus explicitly set by the advertiser
objectivestringCampaign objective, e.g. CONVERSION, TRAFFIC
sub_objectivestringObjective refinement, e.g. WEBSITE_CONVERSIONS. Undocumented.
special_ad_categorybooleanWhether the campaign is in a regulated category (housing, credit, employment). Undocumented.
created_atdatetimeWhen the campaign was created
updated_atdatetimeWhen the campaign was last modified — replication key
start_timedatetimeScheduled start of delivery
end_timedatetimeScheduled end of delivery; absent if open-ended

ad_groups

Ad groups, carrying the bid, budget, placements, frequency caps and all targeting.

Supports incremental replication using updated_at.

FieldTypeDescription
idstringAd group ID
advertiser_idstringOwning advertiser ID
campaign_idstringParent campaign ID
namestringAd group name
statusstringEffective delivery status, e.g. ACTIVE, PAUSED_DUE_TO_CAMPAIGN_PAUSE
user_statusstringStatus explicitly set by the advertiser
placementsarrayWhere ads may serve, e.g. FEED, FSF, RHR
audience_network_is_onbooleanWhether off-Nextdoor audience network delivery is enabled
bidobjectBid settings for the ad group
budgetobjectBudget settings for the ad group
start_timedatetimeScheduled start of delivery
end_timedatetimeScheduled end of delivery; absent if open-ended
frequency_capsarrayLimits on how often one neighbour sees these ads
targetingobjectGeographic, audience, interest and daypart targeting
custom_audience_idsarrayCustom audience IDs. Documented as a top-level field but not returned by the live API, which nests them under targeting.custom_audience_targeting; both are read.
created_atdatetimeWhen it was created
updated_atdatetimeWhen it was last modified — replication key

ads

Individual ads, linking an ad group to the creative it renders.

Supports incremental replication using updated_at.

FieldTypeDescription
idstringAd ID
advertiser_idstringOwning advertiser ID
adgroup_idstringParent ad group ID
creative_idstringCreative rendered by this ad; joins to the creatives stream
namestringAd name
statusstringEffective delivery status, e.g. ACTIVE, INACTIVE, ARCHIVED, INELIGIBLE
user_statusstringStatus explicitly set by the advertiser
created_atdatetimeWhen the ad was created
updated_atdatetimeWhen the ad was last modified — replication key

creatives

Creative assets - headline, body, call to action, image and logo URLs, and click and impression trackers.

Supports incremental replication using updated_at.

FieldTypeDescription
idstringCreative ID
advertiser_idstringOwning advertiser ID
namestringCreative name
statusstringReview status, e.g. APPROVED
placementstringPlacement this creative targets
creative_typestringCreative format, e.g. IMAGE_NATIVE_V3. Undocumented.
text_overlaysarrayText rendered over the image. Undocumented.
advertiser_namestringAdvertiser name shown to neighbours
headlinestringHeadline text
body_textstringBody copy
offer_textstringOffer text, if any
pricestringDisplayed price, if any
ctastringCall to action, e.g. Learn more
canvas_image_urlstringMain creative image
logo_image_urlstringAdvertiser logo
clickthrough_urlstringDestination URL
impression_tracking_urlsarrayThird-party impression pixels
click_tracking_urlsarrayThird-party click trackers
created_atdatetimeWhen it was created
updated_atdatetimeWhen it was last modified — replication key

reports

Saved and scheduled report definitions with their CSV download URLs. Definitions only - this stream carries no metrics.

FieldTypeDescription
idstringReport ID
advertiser_idstringOwning advertiser ID
namestringReport name
download_urlstringPresigned S3 URL for the report CSV. Short-lived, and carries embedded AWS credentials - treat as a secret.

ad_stats

Aggregate performance per ad over the configured window. One row per ad, not a daily time series, and one request per ad, which makes this the slowest stream.

FieldTypeDescription
ad_idstringAd these metrics are for
advertiser_idstringOwning advertiser ID
start_timedatetimeStart of the reporting window
end_timedatetimeEnd of the reporting window, inclusive
billable_spendstringBillable spend, currency-prefixed, e.g. "GBP 12.50"
cpcstringCost per click, currency-prefixed
cpmstringCost per thousand impressions, currency-prefixed
cost_per_resultstringCost per result, currency-prefixed
impressionsintegerImpressions served
clicksintegerClicks received
ctrnumberClick-through rate as a percentage value, e.g. 0.557 means 0.557%. Verified against clicks/impressions on live data.
resultnumberResults against the campaign objective
total_conversionsintegerAll conversions, summing the breakdown below
purchase_conversionsintegerPurchase conversions
lead_conversionsintegerLead conversions
sign_up_conversionsintegerSign-up conversions
add_to_cart_conversionsintegerAdd-to-cart conversions
initiate_checkout_conversionsintegerCheckout-initiated conversions
search_conversionsintegerSearch conversions
view_content_conversionsintegerView-content conversions
add_to_wishlist_conversionsintegerAdd-to-wishlist conversions
subscribe_conversionsintegerSubscribe conversions
other_conversionsintegerConversions not in the categories above

performance_report

A custom performance report, defined entirely by the Ad Performance Report setting and built via the reporting API. Its fields are therefore not fixed: the schema is generated from your config, with one column per requested dimension, one per requested metric, plus advertiser_id, report_id and date. See Setup step 4 below for the available metrics and dimensions, and for the caveats - this is the one stream that writes to your account.

Leave the setting unset to skip this stream and use ad_stats instead.

custom_audiences

Custom audiences referenced by ad groups. There is no list endpoint, so audiences are fetched by the IDs found on their ad groups.

Supports incremental replication using updated_at.

FieldTypeDescription
idstringCustom audience ID
advertiser_idstringOwning advertiser ID
adgroup_idstringThe ad group this audience was discovered from
namestringAudience name
descriptionstringAdvertiser's own notes
audience_typestringHow the audience was built, e.g. emails
created_atdatetimeWhen it was created
updated_atdatetimeWhen it was last modified — replication key

Setup

1. Generate an access token

Sign in to Nextdoor Ads Manager and generate an Ads API access token. Set it as Access Token - it is sent as a bearer token on every request.

2. Choose which advertisers to extract (optional)

Leave Advertiser IDs empty to extract every advertiser the token can reach. Set it to narrow extraction to specific advertiser accounts, along with their child campaigns, ad groups and ads.

3. Set the reporting window

Start Date and End Date bound the ad_stats and performance_report streams only. Both accept an ISO-8601 date (2026-01-01) or date-time (2026-01-01T00:00:00Z), and both default to today. End Date is inclusive.

Every other stream replicates on its own updated_at bookmark or in full, and ignores these two settings.

4. Define a performance report (optional)

The performance_report stream builds an ad hoc report from the Ad Performance Report setting:

report:
  metrics: [IMPRESSIONS, CLICKS, CTR, SPEND, BILLABLE_SPEND, CPM, CPC, CONVERSIONS]
  dimension_granularity: [AD]           # CAMPAIGN, AD_GROUP, AD, PLACEMENT
  time_granularity: [DAY]               # DAY, WEEK, MONTH
  name: tap-nextdoor performance report # report name in NAM
  stream_name: performance_report       # rename the stream if you like
  recipient_emails: []                  # every sync emails these
  campaign_ids: []                      # optional filters
  adgroup_ids: []
  ad_ids: []

Every key except the three granularity/metric lists is optional. The same definition as JSON, for the Ad Performance Report setting field or the TAP_NEXTDOOR_REPORT environment variable:

{
  "metrics": ["IMPRESSIONS", "CLICKS", "CTR", "SPEND", "BILLABLE_SPEND", "CPM", "CPC", "CONVERSIONS"],
  "dimension_granularity": ["AD"],
  "time_granularity": ["DAY"],
  "name": "ad performance report",
  "recipient_emails": []
}

All three enum lists are validated before any request is made, so a typo fails with the supported values listed rather than a bare API error.

Caveats - unlike every other stream, this one writes. Each sync creates a report object in the advertiser's account, and those accumulate; the reports stream lists every one created so far. Each sync also emails everyone in recipient_emails - leave it empty to skip the email. Report rows carry no IDs, only Campaign Name, Ad Group Name and Ad Name, so they join to the campaigns, ad_groups and ads streams by name only; renaming an entity in NAM breaks that join.

Leave the setting unset to skip the stream and use ad_stats instead, which is side-effect free but returns a single aggregate row per ad rather than a daily time series, at a cost of one request per ad.

5. Tune pagination (optional)

Page Size sets how many records are requested per page from the list endpoints. It defaults to 100.

Data notes

Money is always returned currency-prefixed ("GBP 3.35") on bids, budgets and all stats spend fields, so those fields are typed as strings rather than parsed, and no currency information is lost.

CTR is expressed as a percentage value in both performance streams - 1.05 means 1.05%.

Campaign and ad group timestamps arrive with a bracketed zone ID (2025-08-26T00:01:34+01:00[Europe/London]), which is invalid against the JSON Schema date-time format. The tap strips the zone ID and keeps the UTC offset, so the instant is unchanged.

Settings

Access Token

Ads API access token, generated in Nextdoor Ads Manager. Sent as a bearer token on every request.

Advertiser IDs

Advertisers to extract data for, by ID, along with their child campaigns, ad groups and ads. Leave empty to extract every advertiser the access token can reach.

Start Date

Start of the reporting window for the performance_report and ad_stats streams. Accepts an ISO-8601 date-time (2026-01-01T00:00:00Z) or a plain date (2026-01-01); the API takes whole days, so any time component is truncated. Defaults to today.

End Date

End of the reporting window, inclusive. Accepts an ISO-8601 date-time (2026-01-31T23:59:59Z) or a plain date (2026-01-31). Defaults to today.

Ad Performance Report

Definition of the custom report built by the performance_report stream. Keys: metrics, dimension_granularity, time_granularity, name, stream_name, recipient_emails, campaign_ids, adgroup_ids, ad_ids. Set stream_name to match the chosen granularity, e.g. campaign_performance_report. NOTE: each sync creates a report in the advertiser's account and emails it to recipient_emails.

Meltano Cloud Connector

Nextdoor connector is available on Meltano. It is built, maintained, supported, and tested by Meltano.

Why Meltano Cloud?
Expert supportDirect access to the team that built and maintains Meltano Cloud. Same-day responses during UK business hours. When something breaks, we fix it fast because we know exactly how it works.
Rigorously testedEvery connector goes through comprehensive testing and quality checks before production. Daily monitoring catches issues before they hit your pipelines. We don't just wrap open-source taps and hope for the best. We validate, we test, we maintain.
No maintenance overheadAPI changes. Connector updates. Schema drift. Breaking changes from upstream sources. We handle it all. Your team focuses on using data. Our team focuses on making sure it's there when you need it.
Ingest & transform data with AIConnect Claude or any MCP-compatible assistant to Meltano Cloud. Add connectors, run pipelines, build dbt models and diagnose failed runs in plain English, against the same Git-backed project your team works in.
Access to Meltano Slack communityJoin 5,500+ data engineers and analytics practitioners. The community is active, helpful, and always on. Good for quick questions, sharing patterns, and learning what others are building.