Skip to content
AdVentur.aiAdVentur.aiAdVentur.ai Docs

Content research API

1 endpoint. Every path is relative to the API base URL and needs a bearer token unless it is marked public. See the REST API overview for authentication, errors and pagination.

POST/v1/orgs/{orgId}/marketing/content-research

Bearer token

Enqueues a durable content_research agent job: web research for trending topics in the brand sector, inspiration import/analysis, and pending_approval post generation.

Path parameters

  • orgIdstring (uuid)required

Request body application/json

  • maxTopicsinteger
  • maxCandidatesinteger

Responses

200Enqueues a durable content_research agent job: web research for trending topics in the brand sector, inspiration import/analysis, and pending_approval post generation.
  • dataobjectrequired
    Fields
    • enqueuedbooleanrequired
    • runobject | nullrequired
      Fields
      • idstring (uuid)required
      • orgIdstring (uuid)required
      • jobTypestringrequired
      • statusstringrequired

        one of queued, running, succeeded, failed, cancelled

      • payloadobjectrequired
      • resultSummaryobject | nullrequired
      • attemptCountintegerrequired
      • maxAttemptsintegerrequired
      • idempotencyKeystring | nullrequired
      • errorMessagestring | nullrequired
      • costCreditsnumber | nullrequired
      • estimatedCostMilliUsdnumber | nullrequired
      • createdByUserIdstring (uuid) | nullrequired
      • startedAtstring | nullrequired
      • completedAtstring | nullrequired
      • createdAtstringrequired
      • updatedAtstringrequired
    • skippedReasonstring

      one of concurrency_limit, duplicate_active, duplicate_idempotency, queue_unavailable

Request
curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/content-research" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'