apple-app-store/
app-detail

Récupérez les fiches publiques de l’Apple App Store à partir d’URL apps.apple.com connues et obtenez identité de l’application, descriptions, contexte du développeur, notes, tarifs et médias sous forme d’enregistrements normalisés.

Apple App Store App Detail API

URL de fiches connues
Enregistrements d’applications normalisés
Métadonnées de pages produit publiques
0,15 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Apple App Store App Detail

Les fiches de l’Apple App Store sont des pages produit publiques qui présentent l’identité d’une application, son texte descriptif, le contexte du développeur et de la catégorie, les notes visibles, les tarifs et les médias. Ces champs servent à enrichir un catalogue, à comparer des fiches et à suivre l’évolution des métadonnées à un instant donné.

Fonctionnalités de la Apple App Store App Detail API

  • Saisie par lot d’URL connuesEnvoyez une ou plusieurs URL de pages produit apps.apple.com : chaque URL nettoyée correspond à une entrée du fournisseur, et au plus un enregistrement d’application normalisé est conservé par URL envoyée.
  • Identité de la fiche et métadonnées descriptivesRenvoie l’ID de l’application, son nom, le texte de description, le développeur, la catégorie, l’URL source et l’heure de collecte dans un schéma d’application homogène.
  • Contexte de note et de prix visibleConserve la note, le nombre d’avis et les champs de prix structurés lorsqu’ils sont disponibles, pour comparer des fiches sans analyser le texte des pages produit.
  • Médias et contexte du catalogueGarde les médias disponibles de la fiche à côté des horodatages de publication et de collecte, et omet les valeurs du schéma que la page publique n’expose pas.

Paramètres de la Apple App Store App Detail API

ParamètresObligatoireDescription
urlsObligatoireTableau obligatoire d’une ou plusieurs URL de pages produit connues. Chaque élément non vide doit pointer vers apps.apple.com ou l’un de ses sous-domaines ; les mots-clés, les identifiants de bundle et les pays ne sont pas acceptés par cet endpoint.

Comment utiliser la Apple App Store App Detail API

Envoyez des URL de fiches connues, suivez la tâche asynchrone, puis lisez les enregistrements d’applications normalisés depuis les pages de résultats stockées.

  1. Préparez une ou plusieurs URL de pages produit publiques de l’Apple App Store dont le nom d’hôte est apps.apple.com ou l’un de ses sous-domaines.
  2. Envoyez le tableau urls en POST à /v1/apple-app-store/app-detail et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. Lisez les enregistrements d’applications dans data.results.items et suivez next_cursor uniquement lorsque has_more vaut true.
curl -X POST "https://api.socq.ai/v1/apple-app-store/app-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://apps.apple.com/us/app/chatgpt/id6448311069"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is true

Cas d’usage de la Apple App Store App Detail API

  • Enrichissement d’un catalogue d’applications : Associez identité normalisée, métadonnées descriptives, développeur, catégorie, tarifs, médias et URL sources à des enregistrements qui contiennent déjà des liens App Store connus.
  • Comparaison de fiches : Comparez le contexte du développeur et de la catégorie, les notes visibles, les nombres d’avis, les tarifs et les textes descriptifs sur un ensemble d’URL sélectionné.
  • Suivi de métadonnées par instantanés : Conservez des résultats successifs avec collected_at pour repérer les changements de noms, de descriptions, de catégories, de notes visibles, de tarifs et de médias au fil du temps.

Conseils d’expert pour la Apple App Store App Detail API

  • Validez chaque nom d’hôte analysé par rapport à apps.apple.com et envoyez des URL de pages produit plutôt que des termes de recherche, des identifiants de bundle ou des noms de boutiques.
  • Supprimez les URL en double avant l’envoi, afin que des entrées répétées ne créent ni lignes redondantes côté fournisseur ni enregistrements d’applications en double.
  • Considérez rating, reviews_count, price, media, published_at, installs et rank comme nullables, car une fiche peut n’exposer qu’une partie du schéma d’application.
  • Ne traitez pas next_cursor comme un jeton de page App Store en amont : il fait seulement avancer dans les résultats déjà stockés pour la tâche SocQ terminée.

En complément de la Apple App Store App Detail API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Apple App Store.

  • Apple App Store App Reviews API — Collectez les avis publics d’applications à partir d’URL apps.apple.com connues, avec texte, notes, informations sur les auteurs, horodatages et références d’application normalisés.
  • Apple App Store Rankings API — Collectez les entrées publiques des classements par catégorie à partir d’URL Apple App Store prises en charge, avec rang source, identité de l’application, développeur, note, nombre d’avis, prix et médias.

Explorer d’autres plateformes

Combinez les données Apple App Store avec les données publiques d’autres plateformes sociales prises en charge.

Apple App Store App Detail API — FAQ

Apple App Store App Detail API est une interface programmatique qui récupère les métadonnées publiques d’URL de pages produit de l’Apple App Store connues. Elle renvoie l’identité normalisée de l’application, les descriptions, le contexte du développeur et de la catégorie, les notes visibles, les tarifs, les médias et l’heure de collecte.

Envoyez un tableau urls non vide contenant des références de pages produit dont le nom d’hôte analysé est apps.apple.com ou l’un de ses sous-domaines. Cet endpoint n’accepte ni mots-clés, ni identifiants de bundle, ni codes de pays, ni champ results_limit.

Un enregistrement normalisé peut comprendre l’ID de l’application, le nom, le texte de description, le développeur, la catégorie, la note, le nombre d’avis, les installations, le prix structuré, le classement, les médias, l’URL source, la date de publication et l’heure de collecte. Les champs absents de la fiche publique restent à null et doivent être omis de la vue affichée.

Non. Le fournisseur reçoit une ligne d’entrée par URL envoyée et la tâche conserve au plus un enregistrement normalisé par URL. next_cursor et has_more concernent uniquement le lecteur de résultats SocQ stockés.

L’estimation de la requête se base sur le nombre d’URL envoyées, à 0,15 crédit par résultat attendu. La facturation finale retient le nombre de résultats normalisés stockés avec succès, et une tâche vide se règle à la base de zéro crédit.