--- updatedAt: 2026-07-23T15:19:44.000Z agentTools: projectIndex: https://developer.nextdoor.com/llms.txt --- # Returns a list of region level targeting paginated # OpenAPI definition ```json { "openapi": "3.1.1", "info": { "title": "Advertising", "termsOfService": "http://localhost/terms", "contact": { "name": "Your Nextdoor Account Manager, or contact Nextdoor for more information", "email": "ads-api@nextdoor.com" }, "version": "V3" }, "externalDocs": { "description": "This Nextdoor Ads API is used to create and run campaigns on Nextdoor through the Nextdoor Ads Manager (NAM)", "url": "https://ads.nextdoor.com/api/v3" }, "security": [ { "Authentication": [] } ], "paths": { "/api/v3/targeting/geo/countries/{countryId}/regions": { "get": { "tags": [ "Targeting" ], "summary": "Returns a list of region level targeting paginated", "parameters": [ { "name": "countryId", "in": "path", "description": "The country id for which to fetch the info", "required": true, "deprecated": false, "style": "simple", "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "description": "The starting index to return a subset of results.", "required": false, "deprecated": false, "style": "form", "schema": { "type": "string", "minLength": 11, "pattern": "[A-Za-z0-9+/=]+" } }, { "name": "pageSize", "in": "query", "description": "The maximum number of results to return. Must be between 1 and 500 inclusive.", "required": true, "deprecated": false, "style": "form", "schema": { "type": "integer", "format": "int32", "maximum": 500, "minimum": 1 } } ], "responses": { "200": { "description": "The list of regions available for ad group targeting in the specified country", "content": { "application/json": { "schema": { "type": "object", "properties": { "geo_targeting": { "type": "array", "deprecated": false, "description": "The list of targeting regions", "items": { "type": "object", "properties": { "cursor": { "type": "string", "deprecated": false, "description": "The cursor of the targeting entity" }, "data": { "type": "object", "deprecated": false, "description": "The targeting data", "properties": { "id": { "type": "string", "deprecated": false, "description": "The id of the targeting entity" }, "name": { "type": "string", "deprecated": false, "description": "The name of the targeting entity" }, "type": { "type": "string", "deprecated": false, "description": "The type of the targeting entity" } } } } } }, "page_info": { "type": "object", "deprecated": false, "description": "The pagination info for the api caller to get the rest of the targeting entities", "properties": { "end_cursor": { "type": [ "string", "null" ], "deprecated": false, "description": "The end cursor of the current page result, typically this is the cursor of the last object." }, "page_size": { "type": "integer", "format": "int32", "deprecated": false, "description": "The number of results returned in this page." } } } } } } } }, "400": { "description": "Bad Request. Indicates that the server cannot process the request due to client-side error. \nFor example invalid input.", "content": { "application/json": { "schema": { "type": "object", "examples": [ { "apiErrorCode": "BAD_REQUEST", "message": "Invalid Id" } ], "properties": { "api_error_code": { "type": "string" }, "message": { "type": [ "string", "null" ] } } } } } }, "401": { "description": "Unauthorized. The API key is invalid and needs to be re-generated.", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_error_code": { "type": "string", "const": "UNAUTHORIZED" }, "message": { "type": [ "string", "null" ] } } } } } }, "403": { "description": "Forbidden. The token passed in has been successfully authenticated, \nbut can’t perform the given action due to not having sufficient permissions.", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_error_code": { "type": "string", "const": "FORBIDDEN" }, "message": { "type": [ "string", "null" ] } } } } } }, "500": { "description": "Internal server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_error_code": { "type": "string", "const": "INTERNAL_ERROR" }, "message": { "type": [ "string", "null" ] } } } } } }, "503": { "description": "The server is temporarily unable to handle the request due to maintenance or overload.", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_error_code": { "type": "string", "const": "SERVICE_UNAVAILABLE" }, "message": { "type": [ "string", "null" ] } } } } } } } } } }, "components": { "securitySchemes": { "Authentication": { "type": "http", "description": "The NAM API uses Bearer Authentication to authorize requests. As such, you must provide the following HTTP header \non all requests, with your API token:\n\n`--header 'Authorization: Bearer '`\nTo obtain the API access token for a logged in user and a given account, \nplease login to Nextdoor Ads Manager and head to the [settings page](https://ads.nextdoor.com/v2/manage/api) \nto obtain an API token. A user may only have one API token at a given time; the token can also be revoked \nin the UI from the same settings page. API tokens expire after one year.\n\nThe API token gives API callers the ability to take action on behalf of all advertisers that are tied to\n the NAM account. It also gives the ability to add new advertisers, of which the API based user will \nautomatically be an admin for.", "scheme": "Bearer", "bearerFormat": "JWT" } } }, "servers": [ { "url": "https://ads.nextdoor.com" } ], "tags": [ { "name": "Targeting" } ], "x-tagGroups": [ { "name": "User", "tags": [ "User" ] }, { "name": "Advertiser", "tags": [ "Advertiser" ] }, { "name": "Campaign", "tags": [ "Campaign" ] }, { "name": "AdGroup", "tags": [ "AdGroup" ] }, { "name": "Ad", "tags": [ "Ad" ] }, { "name": "Creative", "tags": [ "Creative" ] }, { "name": "Media", "tags": [ "Media" ] }, { "name": "Audiences", "tags": [ "Audiences" ] }, { "name": "Business Categories", "tags": [ "Business Categories" ] }, { "name": "Reporting", "tags": [ "Reporting" ] }, { "name": "Targeting", "tags": [ "Targeting" ] }, { "name": "Conversion Tracking", "tags": [ "Universal Pixel", "Conversions API" ] } ] } ```