Commandez une campagne UGC par agent IA.
UGC Pocket expose une couche commerce pour agents : un agent peut estimer et commander une campagne. La commande crée un brouillon ; un humain le confirme et le finance dans l'app.
Base API https://ugcpocket.com/api · MCP https://ugcpocket.com/mcp
status: "draft"
ordered_by_agent: true
Un agent ne s'inscrit pas seul : l'accès est amorcé par un humain.
- Installer l'app UGC Pocket et créer un compte organisation (côté marque).
- Aller dans Profil → « Clés API (agents) » et générer une clé
ugcp_live_…. La clé n'est affichée qu'une seule fois: copiez-la immédiatement. - Coller la clé dans la configuration de votre agent ou client MCP, en-tête
Authorization: Bearer ugcp_live_….
draft, rattachée à l'organisation propriétaire de la clé. La marque doit ensuite confirmer et financer la campagne dans l'app (bouton « Publier »). Aucun paiement n'est déclenché par l'agent.
Trois surfaces : llms.txt, API REST + OpenAPI, et MCP.
MCP
Serveur MCP Streamable HTTP : https://ugcpocket.com/mcp. 4 outils.
Points d'entrée REST
| Méthode + chemin | Auth | Rôle |
|---|---|---|
GET /service-info | aucune | Descripteur produit (catégories, plancher de budget, liens). |
POST /estimate | aucune | Brief libre → champs suggérés + total indicatif. |
POST /campaigns | clé API | Crée un brouillon de campagne. |
GET /campaigns/{id} | clé API | Statut d'une campagne possédée. |
Connexion en 10 secondes (Claude Code, Cursor…)
La découverte (initialize, tools/list, get_service_info) fonctionne sans clé. Collez ceci dans la config de votre client MCP ; ajoutez votre clé pour commander :
{
"mcpServers": {
"ugc-pocket": {
"type": "http",
"url": "https://ugcpocket.com/mcp",
"headers": { "Authorization": "Bearer ugcp_live_VOTRE_CLE" }
}
}
}
Outils MCP: https://ugcpocket.com/mcp
| Outil | Rôle |
|---|---|
get_service_info | Descripteur produit. |
estimate_campaign | { brief } → champs suggérés + total indicatif. |
create_campaign_order | Schéma CampaignDraftInput → crée un brouillon. |
check_campaign_status | { campaign_id } → statut. |
Commander un brouillon (REST).
La clé du funnel : la commande crée un brouillon. La réponse renvoie un confirm_url qui ouvre la campagne dans l'app pour la confirmation et le financement par un humain.
curl -X POST https://ugcpocket.com/api/campaigns \
-H "Authorization: Bearer ugcp_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"title":"Lancement gamelle","brief":"Vidéo TikTok…","prestation":"video_post","target_categories":["dog"],"platforms":["TikTok"],"budget_per_creator_cents":12000,"creators_wanted":5}'
Réponse 201 : { "campaign_id":"…","status":"draft","ordered_by_agent":true,"next_step":"…","confirm_url":"https://ugcpocket.com/c/…" }
CampaignDraftInput: l'objet envoyé à POST /campaigns.
| Champ | Type | Détail |
|---|---|---|
title requis | string ≤120 | Titre court de la campagne. |
brief requis | string ≤2000 | Consignes créatives, ton, contraintes. |
budget_per_creator_cents requis | entier | Centimes d'euro. Min 5000 (50 €), max 200000 (2000 €). |
creators_wanted requis | entier | 1 à 50. |
prestation | enum | ugc_only (défaut), video_post, post_provided. |
target_categories | enum[] | dog, cat, car, cooking, couple, business, podcast. |
platforms | enum[] | TikTok, Instagram, YouTube, Snapchat, Facebook. |
payment_trigger | enum | publication ou views. |
views_threshold | entier | Seuil de vues (si payment_trigger=views). |
deadline | date ISO | AAAA-MM-JJ. |
Schéma de référence complet : /openapi.json (composant CampaignDraftInput, additionalProperties=false).
Budget, débit et idempotence.
Budget & quantité
Budget par créateur ≥ 5000 (50 €), ≤ 200000 (2000 €). creators_wanted ∈ [1, 50]. Devise EUR, montants en centimes. Une valeur < 5000 est refusée (validation_error).
Débit
30 requêtes/minute par clé ; au-delà 429 + Retry-After: 60. Plafond de 200 brouillons/jour par clé.
Idempotence
En-tête Idempotency-Key optionnel sur POST /campaigns pour rejouer une requête sans créer de doublon.
Codes d'erreur
invalid_api_key (401), rate_limited (429), validation_error (422), not_found (404), internal (500).
Questions fréquentes.
Un agent IA peut-il payer une campagne automatiquement ?
Non. Une commande d'agent crée toujours une campagne en statut draft. La marque doit confirmer et financer la campagne dans l'app ; aucun paiement n'est déclenché par l'agent.
Comment obtenir une clé API ?
Un humain installe l'app, crée un compte organisation, puis génère une clé ugcp_live_… dans Profil → « Clés API (agents) ». La clé n'est affichée qu'une seule fois.
Quelles limites de budget pour une commande par API ?
Budget par créateur de 50 € à 2000 € (budget_per_creator_cents de 5000 à 200000) et 1 à 50 créateurs par campagne.
Quelles sont les limites de débit ?
30 requêtes/minute par clé (429 + Retry-After: 60 au-delà), avec un plafond de 200 brouillons/jour par clé.
Prêt à brancher votre agent ?
Commencez par le schéma OpenAPI et le fichier llms.txt, puis créez votre premier brouillon.
Une question d'intégration ? support@ugcpocket.com