Uber Developers

Uber

Developers

Keyword Identification Report

The Keyword Identification report helps you find additional keywords to target based on historical search activity for your products. It shows how often your products appear in customer search results and how they rank in the top positions.

¶ Report Details

Report Type ID: GR_KEYWORD_IDENTIFICATION

Filters:

brand_owner_id: Brand owner identifier
gtin: Global Trade Item Number
product_brand: Product brand name

Dimensions:

brand_owner_id: Brand owner identifier
search_term: Actual user search query
gtin: Global Trade Item Number
product_brand: Product brand name
product_name: Product name

Supported Time Units: DAILY, SUMMARY

Lookback Limit: 90 days

¶ Available Metrics

Metric	Description
`total_search_appearances_rounded`	Count of customer searches (rounded to the nearest 100) in which your product showed up in the results. A bigger number means the keyword is searched more often.
`total_search_appearances_in_top_4_slots_rounded`	Count of customer searches (rounded to the nearest 100) where your products showed up within the first four results. The higher this figure, the more relevant the keyword is to your brand.
`share_of_top_4_slots_rounded`	Top-4 placements divided by total in-store searches where your products appeared. The lower the percentage, the more opportunity.

¶ Time Range Configuration

Daily and Summary Reports

Start Date: Any valid date
End Date: Any valid date after start date
Example: "start_time": "2026-07-01T00:00:00Z", "end_time": "2026-07-31T00: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": "GR_KEYWORD_IDENTIFICATION",
    "time_range": {
      "start_time": "2026-07-01T00:00:00Z",
      "end_time": "2026-07-31T23:59:59Z"
    },
    "columns": [
      "brand_owner_id",
      "search_term",
      "gtin",
      "product_brand",
      "product_name",
      "total_search_appearances_rounded",
      "total_search_appearances_in_top_4_slots_rounded",
      "share_of_top_4_slots_rounded"
    ],
    "time_unit": "DAILY",
    "file_format": "CSV"
  }'

¶ Example Response

{
  "report_id": "0ef31733-a21a-5a97-a411-565a754e5902"
}

Report Details

Available Metrics

Time Range Configuration

Filter Operators

Example Request

Example Response

Uber

Developers