> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect

> How to connect the Yelp data source to Adriel: enter a Yelp API key and business ID, then verify daily advertising performance.

Yelp is a discovery platform for local businesses and a self-serve advertising surface for service-based and small-business advertisers. Connecting it brings daily advertising performance for a Yelp business listing into Adriel dashboards, including ad impressions, ad clicks, ad spend, and lead events such as phone calls, direction requests, and reservations.

## Before you connect

The following are required:

* A **Yelp API key**.
* A **Yelp Business API ID** — typically a 22-character Yelp Business ID or alias.
* A business with at least one review. Data connection is available only for businesses that meet this condition.

Both the API key and the Business API ID are provided by the assigned Yelp representative, or by contacting `partner-support@yelp.com`. To connect several businesses, request the full list of business IDs from the Yelp representative and create one data source per ID.

## Connect Yelp

<Steps>
  <Step title="Select the data source">
    On the **Data Sources** page, search for **Yelp** and select it.
  </Step>

  <Step title="Enter the API key">
    Enter the **Yelp API key** and click **Submit**.
  </Step>

  <Step title="Enter the business ID">
    Enter the **Yelp Business API ID** and click **Submit**. Enter one business ID per data source; to add more locations, repeat the connection for each ID.
  </Step>
</Steps>

Initial data availability can take one to three business days after the connection is created.

## What gets imported

The connector pulls daily advertising performance for the connected Yelp business location, reported in USD. Metrics include ad impressions, ad clicks, ad spend, phone calls, direction requests, reservations, and review counts.

For the complete list of metrics and breakdowns, see the [Yelp data reference](/data-sources/o-z/yelp/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection fails after entering credentials">
    Yelp API access is gated by Yelp partner approval. Confirm with the Yelp account team that API access has been provisioned for the business and that the API key and Business API ID match the location being connected.
  </Accordion>

  <Accordion title="The business does not appear after connecting">
    Confirm the credentials are scoped to the expected business. Operators with multiple locations need separate credentials for each location, and each location connects as its own data source.
  </Accordion>

  <Accordion title="No data appears right after connecting">
    Initial data availability can take one to three business days. A business must also have at least one review before data can be connected.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Yelp data reference" href="/data-sources/o-z/yelp/data-reference">
    Metrics, breakdowns, and limits for Yelp.
  </Card>

  <Card title="Yelp FAQs" href="/data-sources/o-z/yelp/faqs">
    Common questions and expected behaviors for the Yelp data source.
  </Card>

  <Card title="How to connect Google Business Profile" href="/data-sources/g-n/google-business-profile/how-to-connect">
    Connect an alternative local discovery and reviews platform.
  </Card>
</CardGroup>