# Playground API OpenScraper

*Page HTML : https://openscraper.ai/fr/playground · Index pour agents : https://openscraper.ai/llms.txt*

> Choisissez un scraper pour le tester en direct dans le navigateur. Chaque exécution est facturée sur votre solde de crédits, et le playground affiche le corps de requête exact — ainsi que des snippets curl, Python et JavaScript à copier-coller.

## De quoi il s'agit

Le playground sur <https://openscraper.ai/fr/playground> génère un formulaire pour les paramètres de chaque module, l'exécute contre la vraie API et affiche les lignes renvoyées. Un module peut aussi être ouvert directement sur `https://openscraper.ai/fr/playground/<slug>`.

Les nouveaux comptes reçoivent 5 $ de crédits offerts : le premier run ne coûte rien.

## Ce que fournit une exécution

- Les lignes renvoyées par le module, dans la même forme que la réponse de l'API.
- Une estimation du coût avant lancement, calculée depuis le schéma de crédits du module.
- Le code généré pour la charge utile exacte : `curl`, Python (`requests`) et JavaScript (`fetch`). Coller votre clé API remplit les snippets avec celle-ci.

## L'appel API équivalent

Tout ce que fait le playground tient en un `POST /runs` :

```bash
curl -X POST https://api.openscraper.ai/runs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "module": "unlocker_matrix",
  "params": {
    "url": "https://example.com",
    "geo": "France"
  },
  "sync": true
}'
```

```python
import requests

response = requests.post(
    "https://api.openscraper.ai/runs",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "module": "unlocker_matrix",
        "params": {"url": "https://example.com", "geo": "France"},
        "sync": True,
    },
    timeout=600,
)
print(response.json())
```

Les modules qui renvoient beaucoup de lignes (Google Maps, Shein) se soumettent avec `"sync": false` puis s'interrogent sur `GET /runs/{task_id}`. Référence complète : <https://openscraper.ai/fr/docs.md>.