Introduction - Search APIThe Search

Introduction - Search API

The Search API is the easiest advanced affiliate tool to start using and is the logical next step for sites looking to implement an automated way to generate links. This affiliate tool works by submitting a query into Apple as a specially designed URL, the page that then loads are the results from your query in JSON (JavaScript Object Notation) format. The Search API doesn't require an account to use so after a quick review of the Search API documentation you can immediately start working with it.

Two different types of searches are possible using the Search API. These are done using a set of parameters to do a search or using an ID to do a look up.

You can pass in different parameters to define a search; such as type of entity you are looking for, the media type, related attributes, related terms, etc. A full list of these parameters can be found inside the Search API documentation. These types of searches are done using the wsSearch service. The base URL for a wsSearch looks like this: http://ax.itunes.apple.com/WebObjects/MZStoreServices.woa/wa/wsSearch?

If you already have an iTunes Adam ID, an AMG ID or a UPC you can also use the Search API to find relevant information from iTunes for item you are looking up. This is done by adding amgArtistId, upc, id, amgAlbumId, etc. to the base of a wsLookup URL: http://ax.itunes.apple.com/WebObjects/MZStoreServices.woa/wa/wsLookup?

While the results that are given will vary depending on what type of content is being returned there are a few important things to look out for. Here is a breakdown of the results based off of a search for a specific song. - The most important is the URL into the iTunes store for the relevant artist (artistViewUrl), collection (album [collectionViewUrl]) and track (song [trackViewUrl]). It is important to note that these are raw iTunes URLs and must be properly affiliate encoded before they will generate a commission. - Also of interest is the artist (artistName), collection (collectionName) and track names (trackName), as recognized in the iTunes Store. - The pricing associated with the collection (collectionPrice) and track (trackPrice) is also available in the data as well as the relevant currency (currency). - The genre (primaryGenreName) is also identified in the Search API results as well as relevant cover art in two different sizes (artworkUrl60 and artworkUrl100). - Finally, 30 second sound samples are available to use for songs (trackViewUrl) but must only be played in on US based websites and when a buy on iTunes button is associated with them.

Here are a few tips to help you get acquainted to the Search API. - Reading through unformatted JSON results can be a challenge. Use a formatter to help. - The default country is US. If you are looking up IDs for non-US items make sure and include the "country=" and the ISO 2 digit code in the URL. - Adam Ids are easily found as the last set of numbers on a standard iTunes link and used with the wsLookup can provide a loot of good information. - To find all the parameters that are acceptable to be included in the Search API query you can cause the query to "dump." You do this by sending in an improperly built query. Try this: http://ax.itunes.apple.com/WebObjects/MZStoreServices.woa/wa/wsSearch?term=jack+johnson&country=UK (The ISO two code for the UK is actually 'GB').

While the Search API is relatively easy to use and get started with it is important to note it's limitations. Because it is web based results can sometimes be slow. In order to deal with this we recommend building a caching system to reduce the number of calls you make to the service or to look into building your own server side service using our Enterprise Partner Feed.

If you find you are a heavy user of the iTunes Link Maker tool or are looking for a way to start automating some of your affiliate link generation I highly recommend you first take at look at the Search API documentation and then jump right in!

Результаты (русский) 1:

Введение - API для поискаAPI поиска является простой инструмент расширенные Партнерская начать использовать и следующий логический шаг для сайтов, желающих осуществлять автоматизированный способ создания ссылки. Эта партнерская программа работает путем представления запроса в Apple как специально разработанный URL, страница, которая загружает являются результаты вашего запроса в формате JSON (JavaScript Object Notation). API поиска не требует учетной записи для использования поэтому после краткий обзор документации API поиска вы можете сразу начать работать с ним.Два различных типа поиска можно с помощью API поиска. Это делается с помощью набора параметров, выполнять поиск или ID сделать взгляд.Можно передать различные параметры для определения Поиск; Например, тип сущности, вы ищете, тип носителя, связанных атрибутов, связанных с ним терминов и т.д. Полный список этих параметров можно найти в документации API поиска. Эти типы поиска сделали с помощью службы wsSearch. Базовый URL-адрес для wsSearch выглядит так: http://ax.itunes.apple.com/WebObjects/MZStoreServices.woa/wa/wsSearch?Если у вас уже есть iTunes Адам ID, идентификатор AMG или СКП вы можно также использовать API поиска чтобы найти соответствующую информацию от iTunes для элемента, который вас интересует. Это делается путем добавления amgArtistId, СКП, id, amgAlbumId, и т.д. на базе wsLookup URL: http://ax.itunes.apple.com/WebObjects/MZStoreServices.woa/wa/wsLookup?В то время как результаты, которые даются будет варьироваться в зависимости от того, какой тип содержимого возвращается, есть несколько важных вещей, чтобы искать. Вот разбивка результатов основан офф Поиск для конкретной песни. -Наиболее важных URL-адрес в iTunes store для соответствующих художник (artistViewUrl), коллекции (альбом [collectionViewUrl]) и трек (песня [trackViewUrl]). Важно отметить, что эти необработанные iTunes URL и должна быть правильно закодированы до того, как они будут генерировать комиссии филиала. -Также интерес представляет художник (artistName), коллекции (collectionName) и отслеживать имена (trackName), как это признано в iTunes Store. -Цены связанные с коллекцией (collectionPrice) и трек (trackPrice) также доступна в данных, а также соответствующей валюты (валюты). -Жанр (primaryGenreName) также определены в результаты поиска API, а также соответствующих обложки в двух разных размеров (artworkUrl60 и artworkUrl100). -Наконец 30 второй звуковые образцы доступны для использования для песни (trackViewUrl), но должны воспроизводиться только США на основе веб-сайтов и когда купить на кнопку iTunes связан с ними.Вот несколько советов, которые помогут вам познакомиться с API поиска. -Чтение через неформатированный результаты JSON может быть сложной задачей. Используйте модуль форматирования, чтобы помочь. -По умолчанию страны — это мы. Если вы ищете вверх идентификаторы элементов в Неамериканских убедитесь и включают в себя «страна =» и ISO 2 значный код в URL-адресе. -Адам идентификаторы можно легко найти, как последний набор чисел на стандартные iTunes ссылке и используется с wsLookup может обеспечить добычу хорошей информации. -Чтобы найти все параметры, которые являются приемлемыми для включения в запрос поиска API может вызвать запрос «сбросить». Вы сделать это, отправив в запросе неправильно построенный. Попробуйте это: (код ISO два для Великобритании является на самом деле «ГБ») http://ax.itunes.apple.com/WebObjects/MZStoreServices.woa/wa/wsSearch?term=jack+johnson&country=UK.Хотя API поиска относительно легко использовать и начать работу с важно отметить его ограничения. Потому что это веб-основе результаты иногда может быть медленным. Для того, чтобы справиться с этим, мы рекомендуем создание кэширования системы сократить количество звонков, внесенные вами в службе или заглянуть в здание собственный сервер стороне службы с помощью нашего предприятия партнера кормить.Если вы найдете вы тяжелых пользователей iTunes ссылка чайник инструмент или ищет способ, чтобы начать автоматизировать некоторые из вашей партнерской ссылке поколения, которую я настоятельно рекомендую, что вы сначала принять на Посмотрите в документации API поиска и затем прыгать прямо в!

Результаты (русский) 2:

Введение - API поиска Поиски API это самый простой расширенный филиал инструмент, чтобы начать использовать и является следующим логическим шагом для сайтов, которые хотят реализовать автоматизированный способ генерации ссылки. Это партнерская программа работает, подав запрос в Apple, как специально разработанной URL, страница, которая затем загружает результаты от вашего запроса в JSON формате (JavaScript Object Notation). В поисках API не требует учетную запись для использования, так после быстрого обзора API документации Поиск можно сразу начать с ней работать. Два различных типов поисков возможно при использовании API поиска. Это делается с помощью набора параметров, чтобы сделать поиск или с помощью ID, чтобы сделать взгляд вверх. Вы можете передать несколько параметров для определения поиска; такие как тип лица, которого вы ищете, типа носителя, связанные атрибуты, связанных с ним терминов, и т.д. Полный список этих параметров можно найти в документации API поиска. Эти типы поисков сделали с помощью сервиса wsSearch. Базовый адрес для wsSearch выглядит так: http://ax.itunes.apple.com/WebObjects/MZStoreServices.woa/wa/wsSearch Если у вас уже есть ITunes Адам ID, в AMG ID или UPC вы также можете использовать API поиска, чтобы найти соответствующую информацию от Itunes по пункту вы, глядя вверх. Это делается путем добавления amgArtistId, UPC, ID amgAlbumId и т.д. до основания в wsLookup URL:? Http://ax.itunes.apple.com/WebObjects/MZStoreServices.woa/wa/wsLookup Хотя результаты, которые учитывая будет варьироваться в зависимости от типа контента возвращается Есть несколько важных вещей, чтобы высматривать. Вот разбивка результатов, основанных офф поиска конкретного песни. - Самое главное это адрес в магазине Itunes для соответствующего исполнителя (artistViewUrl), коллекция (альбом [collectionViewUrl]) и дорожки (песни [trackViewUrl]). Важно отметить, что это сырье Itunes URL, и должен быть надлежащим партнерской кодируемый прежде, чем они будут генерировать комиссия. - Кроме того, интерес художника (artistName), коллекция (CollectionName) и отслеживать имена (trackName), как это признано в Itunes Store. - Ценообразование связаны со сбором (collectionPrice) и дорожки (trackPrice) также доступна в данных, а также соответствующей валюте (валюта). - Жанр (primaryGenreName) также определены в результатах поиска API, а также соответствующей обложки в двух различных размерах (artworkUrl60 и artworkUrl100). - И, наконец, 30 второй звуковые образцы доступны для использования песен (trackViewUrl), но должны быть воспроизведены только в на веб-сайтах, основанных США и когда купить на кнопку Itunes связано с ними. Вот несколько советов, которые помогут вам познакомиться в API поиска. - Читая неформатированный результатов JSON может быть проблемой. Используйте форматирования, чтобы помочь. - Страна по умолчанию США. Если вы ищете до идентификаторы неамериканских пунктов убедитесь, и включают в себя "=" страну и значный код ISO 2 в URL. - Адам идентификаторы легко найти, как последний набор чисел на стандартном ссылку ITunes и используется с wsLookup может обеспечить добычу хорошей информации. - Чтобы найти все параметры, которые являются приемлемыми для включения в поиск API запроса вы можете вызвать запрос на "свалку". Вы можете сделать это, отправив в неправильно построенной запроса. Попробуйте это: http://ax.itunes.apple.com/WebObjects/MZStoreServices.woa/wa/wsSearch?term=jack+johnson&country=UK (ИСО двух код Великобритании на самом деле "ГБ"). В то время как поиск API является относительно простым в использовании и начать работу с ним Важно отметить, что это ограничение. Потому что это веб-основе результаты могут иногда быть медленным. Для того, чтобы справиться с этим мы рекомендуем строить систему кэширования, чтобы уменьшить количество звонков вы делаете в службу или посмотреть в строительство собственного на стороне сервера услугу, используя наш канал Предприятие Partner. Если вы обнаружите, что вы являетесь пользователем тяжелых из Itunes Ссылка инструмент чайник или ищете способ начать автоматизацию некоторых вашего поколения партнерской ссылке я настоятельно рекомендую вам сначала принять во взгляде на документации Поиск API, а затем прыгать прямо в!

Результаты (русский) 3:

введение - search APIпоиск API не простой инструмент для начала использования передовых филиала и следующим логическим шагом для сайтов, хотят внедрить автоматическую путь для создания ссылок.этот филиал Tool Works, направив запрос в Apple, как специально URL, стр. тогда нагрузки являются результаты запроса в JSON (JavaScript объект записи) формате.поиск API не требуют отчет для использования после беглого поиска API документацию, вы сразу же сможете начать работать с ним.два различных вида обысков возможно с использованием search API.это делается с помощью набора параметров, вести поиск или использование ID не смотреть.вы можете пройти в различных параметров для определения обыск; таких, как целое, вы ищете, средств массовой информации, типа, связанной с атрибутами, терминов и т.д. полный перечень этих параметров можно найти внутри search API документации.эти обыски проводятся с использованием wssearch службы.базового URL для wssearch выглядит так: http://ax.itunes.apple.com/webobjects/mzstoreservices.woa/wa/wssearch?если у вас уже есть iTunes адам ID, AMG ID или скп, также вы можете использовать API поиска, чтобы найти соответствующую информацию из iTunes по пункту вы ищете.это делается путем добавления amgartistid скп, ID, amgalbumid и т.д. в данных о wslookup URL: http://ax.itunes.apple.com/webobjects/mzstoreservices.woa/wa/wslookup?хотя результаты, которые будут варьироваться в зависимости от типа контента возвращается есть несколько важных вещей, чтобы посмотреть.здесь приводятся результаты от поиска отдельной песни.главное - URL в ITunes Store для соответствующих художника (artistviewurl), сбор (альбом [collectionviewurl]), и трек (песни [trackviewurl]).важно отметить, что эти сырье iTunes URL, и должны быть надлежащим образом филиал закодированы, прежде чем они будут генерировать комиссии.- интерес также представляет художник (artistname), сбор (collectionname) и отслеживания имен (trackname), как это признано в iTunes Store.- цены, связанных со сбором (collectionprice) и отслеживания (trackprice) содержится в данных, а также соответствующие валюты (валюты).- жанр (primarygenrename) также выявлены в search API результаты, а также соответствующие обложки в двух разных размеров (artworkurl60 и artworkurl100).- и, наконец, 30 второй звук образцы, которые можно использовать для песен (trackviewurl), но должен быть только играл на нас на веб - сайтах и когда покупать на iTunes кнопка, связанных с ними.вот несколько советов, которые помогут вам познакомиться с search API.- читая тому JSON результаты могут быть проблемой.использование - для того, чтобы помочь.- дефолт страны - это мы.если ты смотрел ID, не нам вопросов убедитесь, что и включить "Country =" и ISO 2 - значный код в URL.- адам IDS легко найти как последний набор чисел на стандартной iTunes связь и с wslookup может стать добычей надлежащей информации.- чтобы найти все параметры, которые приемлемы для включения в поисках API запрос можно сделать запрос на "свалка". ты это, отправив в неправильно построил запроса.попробуйте: http://ax.itunes.apple.com/webobjects/mzstoreservices.woa/wa/wssearch?срок = джек + джонсон & Country = UK (ISO два кода великобритании фактически 'ru').в то время как search API является относительно простым в использовании и начнем с важно отметить, это ограничения.потому что это интернет - результаты могут иногда быть медленным.в связи с этим мы рекомендуем построения система кэширования для сокращения числа призывает вас на службу или заглянуть в построении собственных серверных услуг с использованием нашего предприятия партнера корм.если ты найдешь ты тяжелый пользователя iTunes связь производитель инструментов или ищут способ начать автоматизации некоторых вашей партнёрской ссылке, поколение, я настоятельно рекомендую вам сначала принять на взгляд на search API документации и тогда сразу!