Aller au contenu principal
Piloterr
Retour à la bibliothèque

API GSA eLibrary Contract

Lisez une fiche contractant GSA eLibrary à partir de l'URL de contrat renvoyée par la recherche.

Actif1 crédit = 1 requêteGET/v2/gsaelibrary/contract

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

AperçuLink to Aperçu

Lit une page contractant sur GSA eLibrary. La réponse est un objet plat : identité, adresse, UEI SAM, schedule, point de contact gouvernemental et catégories SIN du contrat.

Passez l'url d'une ligne de recherche dont result_type vaut contract. Pour US RADAR INC, cette URL contractorInfo.do contient contractNumber=GS-07F-0239T et contractorName=US+RADAR+INC. L'appel avec seulement GS-07F-0239T renvoie 404.

DémarrageLink to Démarrage

GET et POST prennent le même query. Encodez la valeur.

GET https://api.piloterr.com/v2/gsaelibrary/contract?query=https://www.gsaelibrary.gsa.gov/ElibMain/contractorInfo.do?contractNumber=GS-07F-0239T&contractorName=US+RADAR+INC&executeQuery=YES

Le dossier revient avec contract_number GS-07F-0239T et contractor_name US RADAR INC.

ParamètresLink to Paramètres

Paramètre Obligatoire Exemple
query oui URL contractorInfo.do issue de la recherche

query est obligatoire. Un autre domaine, ou une URL qui n'est pas contractorInfo.do, renvoie 400. Un numéro comme GS-07F-0239T est accepté et renvoie 404 quand GSA ne peut pas le résoudre sans le nom.

Champs de réponseLink to Champs de réponse

Champ Type Sens
contract_number string ou null Numéro, par exemple GS-07F-0239T
contractor_name string ou null Raison sociale
address string ou null Adresse, lignes jointes par des virgules
phone string ou null Téléphone
email string ou null E-mail
website string ou null Site web
sam_uei string ou null UEI SAM
socio_economic string ou null Indicateurs socio-économiques
current_option_period_end_date string ou null Fin de période d'option, telle qu'imprimée
government_poc_name string ou null Contact gouvernemental
government_poc_phone string ou null Téléphone du contact
government_poc_email string ou null E-mail du contact
epls string ou null Texte sur la liste des parties exclues
schedule_number string ou null Code schedule, par exemple MAS
schedule_name string ou null Titre du schedule
categories array Catégories SIN, chaque objet a sin et name
terms_url string ou null URL des conditions quand la page en donne une
url string URL demandée

Pas d'enveloppe results. Sur US RADAR INC, categories contient par exemple 334515 / Diagnostic, Measuring and Testing Equipment.

Cas d'usageLink to Cas d'usage

  • Vérifier l'UEI SAM, l'adresse et la ligne socio-économique de US RADAR INC.
  • Lister les SIN portés par GS-07F-0239T.
  • Copier le contact gouvernemental et la date de fin d'option dans un dossier fournisseur.

Codes d'erreurLink to Codes d'erreur

Code Sens
400 Requête vide, numéro mal formé, ou URL hors domaine
401 Clé API absente
404 Contrat introuvable. Un numéro sans le nom du contractant aboutit souvent ici
500 Échec de la récupération

Endpoints liésLink to Endpoints liés

GSA eLibrary Search

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus