FAQ

About Getty Images search

How can I pull back an image where a celebrity is the primary focus of an image, as opposed to merely related to the image?
Can I disambiguate celebrity names?
How do I search for a celebrity or other known figure?
Can I get a list of events Getty Images is covering?
How do I find the images associated with an event?
How do I find out information about the Events?
Can images belong to more than one Event?
What are Events?
How do I find the newest images?
Why are there different results on gettyimages.com vs. my own API results?
Can I limit my editorial searches to just one geographic region?
Why should I specify an ImageFamily in my search?

 

How can I pull back an image where a celebrity is the primary focus of an image, as opposed to merely related to the image?

In order to pull back a clean-shot suitable to accompany biography info, for example, we recommend that you structure your search to use the following keywords:

  • Provide a keyword ID for the celebrity you are searching for, or provide the celebrity name in the SpecifiedPersons field.
  • Provide the following keywords in the SearchPhrase field:
    • One Person
    • Head Shot or Waist Up

Back to top

Can I disambiguate celebrity names?

We do not yet offer a service for this.  You can either combine a celebrity name with other related keywords (for example, Aaron Brooks and “Basketball” or Aaron Brooks and “American Football”) or you can use our list of Specific Person IDs to create a mapping on your side to external URIs or another database.

Back to top

How do I search for a celebrity or other known figure?

First, make sure the value for the ImageFamily filter is set to Editorial.  Then, choose one of the following methods to search for a celebrity:

  • Provide the name of the celebrity in the SearchPhrase field.  This will execute a free text search and return broad results related to the celebrity.
  • Provide the name in the SpecifiedPersons field.  This will execute a search with a more narrow focus of images that include the specific person.
  • Provide the corresponding Keyword ID for the celebrity in the KeywordID field.

Back to top

Can I get a list of events Getty Images is covering?

We do not publish lists of events where we will have photographers present.

Back to top

How do I find the images associated with an event?

The API returns EventIds per image in the SearchForImages and GetImageDetails responses. These EventIds can be passed into SearchForImages via the Query section of the SearchForImages request body under "EventId" to restrict results to images from that event.

Back to top

How do I find out information about the Events?

You can provide a list of EventIDs to the GetEventDetails Operation to return information such as Event Name, Editorial Product (basically, a categorization of the type of event) and Representative image from the Event.

Back to top

Can images belong to more than one Event?

Yes. Images can belong to both a Parent Event (e.g. "2012 Oscars"), a Child Event (e.g. "Vanity Fair Oscar Party") as well as other groupings created by our editorial team (e.g. "Dresses from the 2012 Oscars").

Back to top

What are Events?

Getty Images news, sports and entertainment photographers and videographers cover editorially relevant events occurring around the world.  All images or video clips produced in association with an event, are assigned the same EventID. EventIDs are part of the meta-data returned in SearchForImages Results. Only content produced under a Getty Images brand name (Getty Images News, Getty Images Sports, Getty Images Entertainment, Film Magic, Wire Image) will be consistently assigned an EventID. The Event framework may also be used to group similar content, such as "Hats from the Royal Wedding" or "Odd-ballOffbeat images of the week".

Back to top

How do I find the newest images?

Editorial images are automatically sorted by recency, with the newest images at the top. You can also filter on Date Created to restrict the result set to a specific date range.

<<Revise>> Creative images are automatically sorted by relevancy based on the SearchPhrase term, as generally this is more important that recency. We are looking forward to adding an additional sort option for recency, later in 2012.

Back to top

Why are there different results on gettyimages.com vs. my own API results?

When you search on gettyimages.com, unless you restrict your query via the advanced search page, you are searching across all of our images. When you search using the API, though, you are automatically restricted to the images outlined in your licensing agreement.

Back to top

Can I limit my editorial searches to just one geographic region?

Yes. You can specify an ID for EditorialSourceId to restrict your results to a specific region.

Back to top

Why should I specify an ImageFamily in my search?

Because our search engine looks at different portions of metadata for editorial and creative images, a serach that combines both will lead to unexpected results. To avoid this, specify creative or editorial for ImageFamily. This will limit your results to the images from the family for which you have called.

Back to top