> ## Documentation Index
> Fetch the complete documentation index at: https://birdeye-0229a3ce-responsetools.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Listings Overview

> Tools for managing and analyzing your business listings across Google, Facebook, Bing, Apple, and other platforms.

## Tools in this category

<CardGroup cols={1}>
  <Card title="get_listing" icon="address-card" href="/mcp/tools/listings/get-listing">
    Full listing profile for a single location — hours, categories, photos, per-site status
  </Card>

  <Card title="get_listing_location_status_report" icon="circle-check" href="/mcp/tools/listings/get-listing-location-status-report">
    Synced/Submitted/Action Required counts for all listing sites at a location
  </Card>

  <Card title="get_listing_insights" icon="chart-line" href="/mcp/tools/listings/get-listing-insights">
    Aggregated Google (and other) listing analytics — map views, calls, directions, website visits
  </Card>

  <Card title="get_listing_category_list" icon="tags" href="/mcp/tools/listings/get-listing-category-list">
    Available listing categories for a given site (Google, Bing, Facebook, etc.) and country
  </Card>

  <Card title="get_product_listing_list" icon="box" href="/mcp/tools/listings/get-product-listing-list">
    Google Merchant product listings linked to your account
  </Card>

  <Card title="fix_listing" icon="rotate" href="/mcp/tools/listings/fix-listing">
    Publish / sync business information to 50+ online listing directories for a location
  </Card>

  <Card title="deactivate_listing" icon="circle-xmark" href="/mcp/tools/listings/deactivate-listing">
    Stop publishing business information to online listing directories for a location
  </Card>

  <Card title="create_product" icon="plus" href="/mcp/tools/listings/create-product">
    Create a new Google Merchant product listing for the business account
  </Card>

  <Card title="update_product" icon="pen" href="/mcp/tools/listings/update-product">
    Update an existing Google Merchant product listing
  </Card>

  <Card title="add_products" icon="cart-plus" href="/mcp/tools/listings/add-products">
    Add one or more products to the business's active Google listing
  </Card>

  <Card title="remove_products" icon="cart-arrow-down" href="/mcp/tools/listings/remove-products">
    Remove (unlist) one or more products from the business's Google listing
  </Card>

  <Card title="delete_products" icon="trash" href="/mcp/tools/listings/delete-products">
    Permanently delete one or more Google Merchant products from the account
  </Card>
</CardGroup>

## Location-Level Tools

<Warning>
  `get_listing`, `get_listing_location_status_report`, `fix_listing`, and `deactivate_listing` are **location-level tools** — they require a `locationId` parameter.

  Call [`get_child_locations`](/mcp/tools/business/get-child-locations) first to get the list of valid location IDs.
</Warning>

## Tips

* `get_listing_insights` defaults to the last 12 months if no date range is provided.
* `get_listing_category_list` is useful before updating a listing — use it to find the correct category ID for a given platform.
* `get_product_listing_list` only returns data if your Google Merchant account is connected in Birdeye.
* After calling `deactivate_listing`, use `fix_listing` to resume publishing to directories.
