API pour développeurs
En savoir plus sur l'API ImportGenius
Intégrez ImportGenius via une API pour créer de nouveaux outils, produits et solutions puissants à l'aide de nos données d'importation et d'exportation. Consultez tous les détails ci-dessous ou contactez-nous pour identifier la meilleure solution pour les besoins de votre entreprise.
Ce que nous proposons
Le service API ImportGenius vous donne un accès illimité aux dossiers d'importation et d'exportation internationaux pour tous vos cas d'utilisation uniques
Couvre les données des États-Unis et de 22 autres pays d'Asie, d'Europe et d'Amérique latine.
L'une des bases de données les plus complètes de données commerciales historiques, répertoriant les expéditions américaines depuis 2006.
L'un des ensembles de données les plus récents. Les données américaines sont mises à jour tous les jours sauf le dimanche. Les données hors États-Unis sont mises à jour chaque semaine, sous réserve de disponibilité.
Format de demande
https://data.importgenius.com/v2/shipments/?q ={requête}&jeton_d'accès={jeton d'accès}&pays={pays}&type={type}
Structure des requêtes
Requête de base
Structure
https://data.importgenius.com/v2/shipments?q =Champ de recherche+modificateur+Terme de recherche&jeton_d'accès=Token d'accès&pays=pays&type=type
Exemple
https://data.importgenius.com/v2/shipments?q=shipname+exactly+adidas&access_token=example_token_123456789&country=us&type=im
Requête portant uniquement sur le nombre
Structure
&countOnly=True
Exemple
https://data.importgenius.com/v2/shipments?q=shipname+exactly+adidas&accesshttps://data.importgenius.com/v2/shipments?q=product+contains+walnuts&access_token=example_token_123456789&country=in&type=im&countOnly=true
_token=example_token_123456789&country=us&type=im
_token=example_token_123456789&country=us&type=im
Requête à mots multiples
Ajouter à n'importe quelle structure
https://data.importgenius.com/v2/shipments?q =Champ de recherche+modificateur+Terme de recherche&jeton_d'accès=Token d'accès&pays=pays&type=type
Exemple
https://data.importgenius.com/v2/shipments?q=product+contains+Māt+cài&access_token=example_token_123456789&country=vn&type=im
Requête par code postal (États-Unis uniquement)
Structure
https://data.importgenius.com/v2/shipments?q=zipcode+is +Code postal&jeton_d'accès=Token d'accès&pays=pays&type=type
Exemple
https://data.importgenius.com/v2/shipments?q=zipcode+is+85258&access_token=example_token_123456789&country=us&type=im
Requête par plage de codes postaux (États-Unis uniquement)
Structure
https://data.importgenius.com/v2/shipments?q=zipcode+range+from +Code postal de+à+Code postal LAST&jeton_d'accès=Token d'accès&pays=pays&type=type
Exemple
https://data.importgenius.com/v2/shipments?q=product+contains+Māt+cài&access_token=example_token_123456789&country=vn&type=im
Requête avec plage de dates
Structure
https://data.importgenius.com/v2/shipments?q =Champ de recherche+modificateur+Terme de recherche/date+de+Date de début+à+Date de fin&jeton_d'accès=Token d'accès&pays=pays&type=type
Exemple
https://data.importgenius.com/v2/shipments?q=shipname+exactly+adidas/date+from+2023-01-27+to+2023-01-28&access_token=example_token_123456789&country=us&type=im
Pagination
Ajouter après les critères de recherche
/page+de+page
Exemple
https://data.importgenius.com/v2/shipments?q=trademark+exactly+fjord/page+from+1&access_token=example_token_123456789&country=ru&type=im
Pagination avec limite
Ajouter après les critères de recherche
/page+de+page+limite+Limite de pages
Exemple
https://data.importgenius.com/v1/shipments?q=trademark+exactly+fjord/page+from+1+limit+5&access_token=example_token_123456789&country=ru&type=im
Requête avancée
Ajouter après les critères de recherche
https://data.importgenius.com/v2/shipments?q =Champ de recherche+modificateur+Terme de recherche/Type d'ajout+Champ de recherche+modificateur+Terme de recherche&jeton_d'accès=Token d'accès&pays=pays&type=type
Exemple
https://data.importgenius.com/v2/shipments?q=product+contains+Māt+cài&access_token=example_token_123456789&country=vn&type=im
Paramètres de la demande
Paramètre
obligatoire
Tapez
Descriptif
Token d'accès
Y
Corde
Jeton d'accès qui confirme la validité de la demande
pays
Y
Corde
Pays d'où les données d'expédition seront extraites. Par exemple, entrez camionnette pour le Vietnam. En fonction de vos besoins, une liste des codes de pays pertinents sera fournie par notre équipe de mise en œuvre lors de l'intégration.
type
N
Corde
Indique si vous recherchez une importation, im, ou exportez, ex, données. Par défaut, le type est import lorsqu'il n'est pas indiqué.
Champ de recherche
Y
Corde
Détermine la catégorie du mot clé que vous recherchez. Par exemple, si vous souhaitez effectuer une recherche à l'aide d'un mot clé basé sur le nom d'un importateur aux États-Unis, le champ de recherche sera consname. La liste complète des champs de recherche sera fournie par notre équipe de mise en œuvre lors de l'intégration.
modificateur
Y
Corde
Il peut s'agir de l'une des valeurs suivantes : contient, exactement, n'importe quel, commence_par_de_, ou se terminer_par
Terme de recherche
Y
Corde
Correspond à votre mot clé de recherche. Par exemple, si Champ de recherche est produit, le Terme de recherche peut être noix
Type d'ajout
N
Corde
Il peut s'agir de l'une des valeurs suivantes : et, ou, ou pas
Compter uniquement
N
Booléen
Si ce champ est laissé vide, la valeur par défaut est faux ce qui déclenche la réponse de l'API avec la liste des envois correspondant aux critères de recherche. En le réglant sur vrai ne renverra que le nombre d'envois correspondant aux critères de recherche.
Code postal
N
Booléen
Couverture par code postal de la recherche. Cette fonctionnalité est prise en charge pour les envois aux États-Unis uniquement
Code postal de
N
Nombre entier
Code postal de départ si vous effectuez une recherche via une plage. Cette fonctionnalité est uniquement prise en charge pour les envois aux États-Unis
Code postal LAST
N
Nombre entier
Fin du code postal si vous effectuez une recherche par plage. Cette fonctionnalité est uniquement prise en charge pour les envois aux États-Unis.
Date de début
N
Date
Date de début de la plage de dates d'une recherche
Date de fin
N
Date
Date de fin de la plage de dates de la recherche
page
N
Nombre entier
Si vous laissez ce champ vide, la réponse affichera la première page. Lorsque le numéro de page est identifié, il détermine de quelle page proviendra la réponse.
Par exemple, si page est 4 et la valeur par défaut Limite de pages est de 10, les lignes 31 à 40 seront renvoyées.
Par exemple, si page est 4 et la valeur par défaut Limite de pages est de 10, les lignes 31 à 40 seront renvoyées.
Limite de pages
N
Nombre entier
Peut être réglé sur une valeur maximale de 10 et une valeur minimale de 1. Si ce champ est laissé vide, la valeur par défaut est 10. Dans le cas contraire, le nombre spécifié déterminera le nombre de lignes du résultat.
Paramètres de retour
Paramètre
Tapez
Descriptif
total
Corde
Nombre total de lignes disponibles, soit le nombre de données que vous pouvez interroger
a pris
Corde
Durée du traitement de la demande (en secondes)
Plage de dates
Corde
Date de début à partir de et date de fin pour
lignes
Objet
Données du manifeste d'expédition au format JSON, limitées à un maximum de 10 lignes par requête. Chaque ligne contient des informations granulaires sur les détails du produit, les détails de l'entreprise et les informations de notification, entre autres.
sid
Nombre entier
Identifiant de chaîne
solde_précédent
Corde
Le total de votre crédit précédent avant le traitement de la demande
balance_actuel
Corde
Le total de votre crédit actuel après le traitement de la demande
réponse
Corde
Notifications importantes d'ImportGenius, telles que des rappels concernant votre utilisation
balance_actuel
Corde
Temps total nécessaire avant qu'une réponse ne soit renvoyée au demandeur (en secondes)
Prêt à démarrer ? Communiquez avec nous dès aujourd'hui.
Nos équipes de service client et de mise en œuvre sont prêtes à vous aider à optimiser votre expérience ImportGenius.