Use these APIs to identify products suitable for Search Engine Marketing (SEM) campaigns.

Catalog management APIs help sellers:

• Retrieve high-performing recommended items
• Validate campaign eligibility
• Prepare products for SEM onboarding
• Avoid campaign creation failures
• Improve campaign quality before launch

These APIs are commonly used before creating or updating campaigns.

How catalog management APIs work together

Use the catalog APIs together to identify and validate products suitable for SEM campaigns.

Step 1: Retrieve recommended items

Use the Get top recommended items API to retrieve products likely to perform well in SEM campaigns.

The API returns up to 200 eligible products recommended for SEM campaigns.

The API automatically excludes:

• Items already associated with active campaigns
• Items that are not eligible for SEM advertising

Step 2: Validate item eligibility

Use the Check eligibility of items API to validate whether specific SKUs meet SEM campaign requirements.

Items are eligible only when they:

• Are published
• Are in stock
• Have no GMC errors
• Are not already associated with an active or scheduled campaign

Only eligible items are returned in the response.

Step 3: Use validated items in campaigns

Use eligible SKUs when:

• Creating new campaigns
• Updating existing campaigns
• Expanding campaign catalog coverage

Recommendation behavior

The Get top recommended items API:

• Returns a maximum of 200 items
• Does not support pagination
• Returns a ranked recommendation set
• Automatically excludes items already associated with active campaigns

Recommendation results may change as catalog data, inventory availability, or campaign associations change.

Eligibility behavior

The eligibility API validates whether items can currently participate in SEM campaigns.

Eligibility may change over time based on:

• Inventory availability
• Product publication status
• GMC validation status
• Existing campaign associations

Sellers should periodically revalidate eligibility before campaign updates.

Best practices

• Validate SKU eligibility before campaign creation.
• Use recommendation APIs to prioritize high-performing products.
• Recheck eligibility before adding products to active campaigns.
• Exclude low-quality or low-inventory products from campaigns.
• Periodically refresh recommendation results as catalog performance changes.

Next steps

Learn more about each endpoint scenario, including a basic API integration with example requests and responses.

• Get top recommended items
• Check eligibility of items