Cheapship GraphQL API

API GraphQL publique pour accéder à toute la structure sémantique de Cheapship. Optimisée pour les LLMs, crawlers et développeurs.

🚀 Ouvrir GraphQL Playground📚 Voir les exemples

Endpoints

POST

Endpoint GraphQL principal

https://api.cheapship.fr/api/graphql
GET

GraphQL Playground (navigation web)

https://api.cheapship.fr/api/graphql

Fonctionnalités

Schema typé

Tous les types sont documentés avec descriptions complètes

Introspection activée

Les LLMs peuvent découvrir automatiquement le schema

Rate limiting intelligent

Crawlers légitimes (Googlebot, etc.) exemptés du rate limiting

CORS ouvert

API publique accessible depuis n'importe quel domaine

Exemples de Queries

Copiez-collez ces exemples dans GraphQL Playground ou utilisez-les dans votre code

Organisation complète

Récupérer toutes les informations sur Cheapship

query GetOrganization {
  organization {
    name
    legalName
    description
    slogan
    foundingDate
    numberOfEmployees
    founders {
      name
      jobTitle
      description
      knowsAbout
    }
    address {
      streetAddress
      addressLocality
      postalCode
      addressCountry
    }
    contactPoints {
      contactType
      email
      telephone
    }
  }
}

Services et offres

Liste tous les services avec leurs tarifs

query GetServices {
  services {
    id
    name
    description
    category
    offers {
      name
      priceMin
      priceMax
      priceCurrency
      availability
    }
  }
}

Knowledge Graph complet

Structure sémantique complète pour LLMs

query GetKnowledgeGraph {
  knowledgeGraph {
    organization {
      name
      description
    }
    topicClusters {
      mainTopic
      relatedTopics
      competitors
      differentiators
    }
    namedEntities {
      name
      type
      synonyms
      relatedConcepts
    }
    semanticCooccurrences {
      category
      terms
    }
  }
}

Recherche sémantique

Rechercher dans le contenu avec pertinence

query SemanticSearch {
  semanticSearch(query: "transport collaboratif") {
    type
    title
    description
    url
    relevanceScore
  }
}

Statistiques plateforme

Métriques globales de Cheapship

query GetStats {
  platformStats {
    totalUsers
    totalDeliveries
    averageRating
    totalReviews
    countriesServed
    co2Saved
  }
}

Cas d'usage

Pour les LLMs (ChatGPT, Claude, Gemini)

  • Récupérer la structure complète de l'organisation
  • Comprendre les relations sémantiques entre concepts
  • Accéder aux topic clusters pour contexte
  • Recherche sémantique dans le contenu

Pour les développeurs

  • Intégrer les données Cheapship dans vos apps
  • Construire des outils de comparaison de prix
  • Créer des dashboards analytics
  • Développer des extensions navigateur

Pour les partenaires

  • Synchroniser les offres de services
  • Afficher les statistiques en temps réel
  • Intégrer le Knowledge Graph
  • Créer des widgets de tarification

Rate Limiting & Sécurité

Limites générales

  • • 100 requêtes par 15 minutes par IP
  • • Slowdown progressif après 50 requêtes
  • • CORS ouvert (Access-Control-Allow-Origin: *)
  • • Introspection activée pour tous

Crawlers exemptés

Ces User-Agents ne sont pas rate-limited :

GooglebotBingbotDuckDuckBotSlackbotFacebookBotTwitterBotLinkedInBot

Exemple d'utilisation (JavaScript)

// Exemple avec fetch API
const query = `
  query GetOrganization {
    organization {
      name
      description
      founders {
        name
        jobTitle
      }
    }
  }
`;

const response = await fetch(
  'https://api.cheapship.fr/api/graphql',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ query })
  }
);

const { data } = await response.json();
console.log(data.organization);

Commencez maintenant

L'API GraphQL Cheapship est publique et gratuite. Aucune authentification requise.

Ouvrir GraphQL Playground