The Ad Keyword Identification report provides search term insights to identify keyword opportunities and understand how your brand appears in search results.

¶ Report Details

Report Type ID: AD_KEYWORD_IDENTIFICATION

Use Cases:

• Opportunistic keyword identification
• Search term analysis
• Brand visibility insights

Dimensions:

• ad_account_id: Account identifier
• search_term: Actual user search query

Supported Time Units: DAILY, WEEKLY, MONTHLY, SUMMARY

¶ Available Metrics

• total_location_count
• total_searches_where_brand_shows_up_rounded
• brand_appearances_in_top_2_slots_rounded
• brand_share_of_top_2_slots

¶ Time Range Configuration

When configuring time ranges, follow these guidelines for proper aggregation:

Daily and Summary Reports

• Start Date: Any valid date
• End Date: Any valid date after start date
• Example: "start_time": "2025-07-15T00:00:00Z", "end_time": "2025-07-20T00:00:00Z"

Weekly Reports

• Start Date: Must be a Monday
• End Date: Must be the next Monday
• Example: "start_time": "2025-07-21T00:00:00Z", "end_time": "2025-07-28T00:00:00Z"

Monthly Reports

• Start Date: Must be the first day of a month
• End Date: Must be the first day of the next month
• Example: "start_time": "2025-07-01T00:00:00Z", "end_time": "2025-08-01T00:00:00Z"

¶ Filter Operators

Supported operators: EQUAL, NOT_EQUAL, IN

¶ Example Request

curl -X POST "https://api.uber.com/v1/ads/{account_id}/reporting/report" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Accept: application/json" \
  -d '{
    "report_type": "AD_KEYWORD_IDENTIFICATION",
    "time_range": {
      "start_time": "2024-01-01T00:00:00Z",
      "end_time": "2024-01-31T00:00:00Z"
    },
    "columns": [
      "ad_account_id",
      "search_term",
      "total_location_count",
      "total_searches_where_brand_shows_up_rounded",
      "brand_appearances_in_top_2_slots_rounded",
      "brand_share_of_top_2_slots"
    ],
    "time_unit": "SUMMARY",
    "file_format": "CSV"
  }'

¶ Example Response

{
  "report_id": "8a2e38b2-59fb-5242-a0ec-e913a42150b5"
}

¶ Related Reports

• Ad Performance by Keyword - Keyword-level performance insights