Documentation

Yahoo Gemini API is a new service that provides qualifying developers with RESTful access to mobile search and native advertising results with a simple pricing scheme based on usage.

The service enables you to programmatically buy, manage and optimize mobile search and native advertising for campaigns across Yahoo’s mobile inventory.

As a Yahoo developer or partner, you’ll be able to work with a set of RESTful objects to create, manage and retrieve advertiser data for your ads, ad groups and campaigns.

Key Benefits

The Gemini API lets you:

  • read data for filtered lists of ads
  • specify objects that you can use for targeting
  • customize mobile search ads by using text variables
  • retrieve ad extensions that are grouped by type for a specific parent
  • query reporting at different entity levels and fetch reports in CSV format
  • work with a sandbox environment to test campaigns you’ve created and managed

Video Tutorials

Welcome to the Gemini API. Let’s get started.

In this series of introductory videos, the Gemini Development Team will walk you through some of the basic steps you’ll need to follow before you first begin making API calls and leveraging the Gemini platform for programmatic ad buying.

Begin by viewing the first video in the series: Get Started with Programmatic Gemini API - Episode 1.

In the second video tutorial, learn How To Work With RESTful Objects in Programmatic Gemini API - Episode 2.

In the third video tutorial, learn How To Set up Your Sandbox Environment in the Programmatic Gemini API - Episode 3.

How To Navigate The API

The Gemini API documentation is organized around the topics listed in the Table of Contents.

  1. To begin, explore the section on Navigating the API, which describes topics dealing with Authentication, Creating a Sandbox Account for API testing, Versioning and API v1 Deprecation.
  2. Next, you’ll want to study and understand the Gemini RESTful objects – Ad, Ad Extensions, Ad Group, Advertisers, Campaigns, Keyword, Shared Site Link and Targeting Attribute – and their relationships in the v2 Gemini API data model.
  3. Drill down to topics like Audience Management, which enables you to better target your ads by creating audiences from your website, from your mobile app, from your email lists or from your customer lists, and Reporting, which allows you to query cubes, or pre-defined collections of fields that let you define the context of your report.
  4. If you need to work with Bulk operations, for example, the Gemini API API lets you download and edit all the objects in your advertiser account using a spreadsheet in CSV format and provides you with a Bulk schema for working with bulk files.

Best Practices

To learn about tips and techniques for working with the Gemini API, check out Best Practices. The best practices are grouped into categories that are intended to optimize and advance your efforts in working with the Gemini API.

Most Frequently Asked Questions

The FAQs are grouped into multiple categories for easier navigation and retrieval of topic-specific information. You’ll find them in various sections dedicated to a particular topic.

What’s New

To track the latest changes, updates and enhancements to the Gemini API, you’ll want to read the What’s New section. The What’s New section is updated on a weekly cadence.

Partner Support

The Yahoo Gemini API Partner Support page provides you with a quick snapshot of recent and upcoming releases, and is focused on features supported by the API. You’ll also find a summary of supported functionality.

Partner Support includes product bulletins updated on a monthly cadence for Gemini API partners, account managers and developers.