---
title: "Returns the advertiser information"
method: GET
path: "/api/v3/advertisers/{advertiserId}"
tags: ["Advertiser"]
---

# Returns the advertiser information

`GET /api/v3/advertisers/{advertiserId}`

## Request

- Base URL: `https://ads.nextdoor.com`
- URL: `https://ads.nextdoor.com/api/v3/advertisers/{advertiserId}`
- Auth: HTTP bearer

## Path parameters

- `advertiserId` string, required

## Response `200`

The advertiser profile with the id specified in the URL

- object
  - `account_balance` string: The current account balance for this advertiser. represented as a string with an ISO-4217 currency code, followed by a space, followed by the numerical amount (e.g. "USD 25.00").
  - `address` object, nullable: The address set for this advertiser.
    - `street_address` string
    - `street_address_2` string
    - `city` string
    - `state` string
    - `postal_code` string
    - `country` string
    - `coordinates` object
      - `latitude` number, double
      - `longitude` number, double
  - `bill_to_payment_profile_id` string, nullable: The bill to payment profile id set for this advertiser.
  - `billing_limit` string: The billing limit set for this advertiser.
  - `categories` string[]: The business categories, if available, set for this advertiser.
  - `country` 'US' | 'CA' | 'GB': The ISO country code string set for this advertiser.
  - `currency` string: The ISO currency code set for this advertiser.
  - `id` string: The id of this advertiser
  - `name` string: The name of this advertiser
  - `payment_profile_id` string, nullable: The payment profile id for this advertiser.
  - `profile_id` string: The id of the profile that owns this advertiser
  - `timezone` string: The timezone identifier string set for this advertiser
  - `web_scraping_opt_info` object, nullable: Web scraping opt info for this advertiser
    - `last_web_scraping_opt_out_timestamp` integer, nullable: User web scraping image feature last opt out time (epoch millis)
    - `web_scraping_opt_in` boolean, nullable: User web scraping image feature opt in status
  - `website_url` string, nullable: The website url set for this advertiser

## Other responses

- `400`: Bad Request. Indicates that the server cannot process the request due to client-side error. For example invalid input.
- `401`: Unauthorized. The API key is invalid and needs to be re-generated.
- `403`: Forbidden. The token passed in has been successfully authenticated, but can’t perform the given action due to not having sufficient permissions.
- `500`: Internal server error.
- `503`: The server is temporarily unable to handle the request due to maintenance or overload.

---

[API](https://skmtc.dev/nextdoor/apis/advertising.md) - [All operations](https://skmtc.dev/nextdoor/apis/advertising/llms.txt) - [OpenAPI document](https://skmtc.dev/nextdoor/apis/advertising/revisions/cdbbecabcffc?raw)