Inspiration API

Inspiration items, trends, niche news and viral formats.

15 endpoints. 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.

GET`/v1/orgs/{orgId}/inspiration`

Bearer tokenMCP tool: list_inspiration_opportunities

Returns a unified inspiration library across platforms (X, LinkedIn) with optional filters.

Path parameters

orgIdstring (uuid)required

Query parameters

includeHiddenboolean | stringrequired
verboseboolean | stringrequired
platformstring
one of x, linkedin
topicstring
hookstring
audiencestring
creatorstring
tagstring
analysisStatusstring
one of pending, processing, ready, failed, skipped
opportunityStatusstring
one of open, saved, hidden, dismissed, acted_on
sortstring
one of relevance, recent
savedFromstring
savedTostring
pageinteger
limitinteger

Responses

200Returns a unified inspiration library across platforms (X, LinkedIn) with optional filters.

dataobjectrequired
Fields
- itemsarray<object>required
  Option 1
  - idstring (uuid)required
  - orgIdstring (uuid)required
  - platformstringrequired
    one of x, linkedin
  - sourceTypestringrequired
    one of own_account, manual_url, manual_text, extension
  - sourceExternalIdstring | nullrequired
  - sourceUrlstring | nullrequired
  - authorNamestring | nullrequired
  - authorHandlestring | nullrequired
  - authorProfileUrlstring | nullrequired
  - contentTextstringrequired
  - mediaobject | nullrequired
    Fields
    itemsarray<object>
    Item fields
    typestring
    one of image, video, document, link, other
    urlstring (uri)
    altstring
    mimeTypestring
  - publishedAtstring | nullrequired
  - engagementobject | nullrequired
    Fields
    likesinteger | null
    commentsinteger | null
    sharesinteger | null
    impressionsinteger | null
    bookmarksinteger | null
    quotesinteger | null
    rawobject | null
  - analysisStatusstringrequired
    one of pending, processing, ready, failed, skipped
  - analysisErrorstring | nullrequired
  - analysisobject | nullrequired
    Fields
    topicstringrequired
    hookstringrequired
    formatstringrequired
    tonestringrequired
    audiencestringrequired
    ctastringrequired
    writingFrameworkstringrequired
    keywordsarray<string>required
    qualityScorenumberrequired
  - analysisProviderstring | nullrequired
  - analysisModelstring | nullrequired
  - analysisPromptVersionstring | nullrequired
  - analyzedAtstring | nullrequired
  - generatedAtstring | nullrequired
  - notesstring | nullrequired
  - tagsarray<string>required
  - socialAccountIdstring (uuid) | nullrequired
  - createdBystring (uuid) | nullrequired
  - feedbackReasonstring | nullrequired
  - relevanceScorenumber | nullrequired
  - whyItMattersstring | nullrequired
  - interpretationobject | nullrequired
    Fields
    relevanceScorenumberrequired
    whyItMattersstringrequired
    scoreBreakdownobjectrequired
    Fields
    strategyFitnumberrequired
    audienceFitnumberrequired
    qualitynumberrequired
    freshnessnumberrequired
    engagementnumberrequired
    matchedPillarsarray<string>
    matchedPrioritiesarray<string>
    strategyNotesarray<string>
  - strategyIdstring (uuid) | nullrequired
  - strategyVersioninteger | nullrequired
  - createdAtstringrequired
  - updatedAtstringrequired
  - generatedDraftsarray<object>
    Item fields
    destinationstringrequired
    one of x, linkedin, thread, article
    styleKeystringrequired
    textstringrequired
  - opportunityStatusstring
    one of open, saved, hidden, dismissed, acted_on
  Option 2
  - idstring (uuid)required
  - platformstringrequired
    one of x, linkedin
  - sourceUrlstring | nullrequired
  - authorNamestring | nullrequired
  - contentExcerptstringrequired
  - contentTruncatedbooleanrequired
  - analysisStatusstringrequired
    one of pending, processing, ready, failed, skipped
  - topicstring | nullrequired
  - hookstring | nullrequired
  - keywordsarray<string>required
  - opportunityStatusstringrequired
    one of open, saved, hidden, dismissed, acted_on
  - relevanceScorenumber | nullrequired
  - whyItMattersstring | nullrequired
  - scoreBreakdownobject | nullrequired
    Fields
    strategyFitnumberrequired
    audienceFitnumberrequired
    qualitynumberrequired
    freshnessnumberrequired
    engagementnumberrequired
  - matchedPillarsarray<string>required
  - matchedPrioritiesarray<string>required
  - strategyNotesarray<string>required
  - generatedDraftsarray<object>required
    Item fields
    destinationstringrequired
    one of x, linkedin, thread, article
    styleKeystringrequired
    textstringrequired
  - tagsarray<string>required
  - createdAtstringrequired
- pageintegerrequired
- limitintegerrequired
- totalintegerrequired
- hasMorebooleanrequired

curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration?includeHidden=true&verbose=true" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

GET`/v1/orgs/{orgId}/inspiration/{itemId}`

Bearer token

Get a single inspiration library item.

Path parameters

orgIdstring (uuid)required
itemIdstring (uuid)required

Responses

200Get a single inspiration library item.

dataobjectrequired
Fields
- idstring (uuid)required
- orgIdstring (uuid)required
- platformstringrequired
  one of x, linkedin
- sourceTypestringrequired
  one of own_account, manual_url, manual_text, extension
- sourceExternalIdstring | nullrequired
- sourceUrlstring | nullrequired
- authorNamestring | nullrequired
- authorHandlestring | nullrequired
- authorProfileUrlstring | nullrequired
- contentTextstringrequired
- mediaobject | nullrequired
  Fields
  - itemsarray<object>
    Item fields
    typestring
    one of image, video, document, link, other
    urlstring (uri)
    altstring
    mimeTypestring
- publishedAtstring | nullrequired
- engagementobject | nullrequired
  Fields
  - likesinteger | null
  - commentsinteger | null
  - sharesinteger | null
  - impressionsinteger | null
  - bookmarksinteger | null
  - quotesinteger | null
  - rawobject | null
- analysisStatusstringrequired
  one of pending, processing, ready, failed, skipped
- analysisErrorstring | nullrequired
- analysisobject | nullrequired
  Fields
  - topicstringrequired
  - hookstringrequired
  - formatstringrequired
  - tonestringrequired
  - audiencestringrequired
  - ctastringrequired
  - writingFrameworkstringrequired
  - keywordsarray<string>required
  - qualityScorenumberrequired
- analysisProviderstring | nullrequired
- analysisModelstring | nullrequired
- analysisPromptVersionstring | nullrequired
- analyzedAtstring | nullrequired
- generatedAtstring | nullrequired
- notesstring | nullrequired
- tagsarray<string>required
- socialAccountIdstring (uuid) | nullrequired
- createdBystring (uuid) | nullrequired
- feedbackReasonstring | nullrequired
- relevanceScorenumber | nullrequired
- whyItMattersstring | nullrequired
- interpretationobject | nullrequired
  Fields
  - relevanceScorenumberrequired
  - whyItMattersstringrequired
  - scoreBreakdownobjectrequired
    Fields
    strategyFitnumberrequired
    audienceFitnumberrequired
    qualitynumberrequired
    freshnessnumberrequired
    engagementnumberrequired
  - matchedPillarsarray<string>
  - matchedPrioritiesarray<string>
  - strategyNotesarray<string>
- strategyIdstring (uuid) | nullrequired
- strategyVersioninteger | nullrequired
- createdAtstringrequired
- updatedAtstringrequired
- generatedDraftsarray<object>
  Item fields
  - destinationstringrequired
    one of x, linkedin, thread, article
  - styleKeystringrequired
  - textstringrequired
- opportunityStatusstring
  one of open, saved, hidden, dismissed, acted_on

curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/$ITEM_ID" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

PATCH`/v1/orgs/{orgId}/inspiration/{itemId}`

Bearer token

Update notes, tags, or content on an inspiration item.

Path parameters

orgIdstring (uuid)required
itemIdstring (uuid)required

Request body application/json

notesstring | null
tagsarray<string>
contentTextstring
authorNamestring | null
authorHandlestring | null
generatedDraftsarray<object>
Item fields
- destinationstringrequired
  one of x, linkedin, thread, article
- styleKeystringrequired
- textstringrequired

Responses

200Update notes, tags, or content on an inspiration item.

dataobjectrequired
Fields
- idstring (uuid)required
- orgIdstring (uuid)required
- platformstringrequired
  one of x, linkedin
- sourceTypestringrequired
  one of own_account, manual_url, manual_text, extension
- sourceExternalIdstring | nullrequired
- sourceUrlstring | nullrequired
- authorNamestring | nullrequired
- authorHandlestring | nullrequired
- authorProfileUrlstring | nullrequired
- contentTextstringrequired
- mediaobject | nullrequired
  Fields
  - itemsarray<object>
    Item fields
    typestring
    one of image, video, document, link, other
    urlstring (uri)
    altstring
    mimeTypestring
- publishedAtstring | nullrequired
- engagementobject | nullrequired
  Fields
  - likesinteger | null
  - commentsinteger | null
  - sharesinteger | null
  - impressionsinteger | null
  - bookmarksinteger | null
  - quotesinteger | null
  - rawobject | null
- analysisStatusstringrequired
  one of pending, processing, ready, failed, skipped
- analysisErrorstring | nullrequired
- analysisobject | nullrequired
  Fields
  - topicstringrequired
  - hookstringrequired
  - formatstringrequired
  - tonestringrequired
  - audiencestringrequired
  - ctastringrequired
  - writingFrameworkstringrequired
  - keywordsarray<string>required
  - qualityScorenumberrequired
- analysisProviderstring | nullrequired
- analysisModelstring | nullrequired
- analysisPromptVersionstring | nullrequired
- analyzedAtstring | nullrequired
- generatedAtstring | nullrequired
- notesstring | nullrequired
- tagsarray<string>required
- socialAccountIdstring (uuid) | nullrequired
- createdBystring (uuid) | nullrequired
- feedbackReasonstring | nullrequired
- relevanceScorenumber | nullrequired
- whyItMattersstring | nullrequired
- interpretationobject | nullrequired
  Fields
  - relevanceScorenumberrequired
  - whyItMattersstringrequired
  - scoreBreakdownobjectrequired
    Fields
    strategyFitnumberrequired
    audienceFitnumberrequired
    qualitynumberrequired
    freshnessnumberrequired
    engagementnumberrequired
  - matchedPillarsarray<string>
  - matchedPrioritiesarray<string>
  - strategyNotesarray<string>
- strategyIdstring (uuid) | nullrequired
- strategyVersioninteger | nullrequired
- createdAtstringrequired
- updatedAtstringrequired
- generatedDraftsarray<object>
  Item fields
  - destinationstringrequired
    one of x, linkedin, thread, article
  - styleKeystringrequired
  - textstringrequired
- opportunityStatusstring
  one of open, saved, hidden, dismissed, acted_on

curl -X PATCH "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/$ITEM_ID" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE`/v1/orgs/{orgId}/inspiration/{itemId}`

Bearer token

Remove an item from the inspiration library.

Path parameters

orgIdstring (uuid)required
itemIdstring (uuid)required

Responses

200Remove an item from the inspiration library.

dataobjectrequired
Fields
- idstring (uuid)required
- orgIdstring (uuid)required
- platformstringrequired
  one of x, linkedin
- sourceTypestringrequired
  one of own_account, manual_url, manual_text, extension
- sourceExternalIdstring | nullrequired
- sourceUrlstring | nullrequired
- authorNamestring | nullrequired
- authorHandlestring | nullrequired
- authorProfileUrlstring | nullrequired
- contentTextstringrequired
- mediaobject | nullrequired
  Fields
  - itemsarray<object>
    Item fields
    typestring
    one of image, video, document, link, other
    urlstring (uri)
    altstring
    mimeTypestring
- publishedAtstring | nullrequired
- engagementobject | nullrequired
  Fields
  - likesinteger | null
  - commentsinteger | null
  - sharesinteger | null
  - impressionsinteger | null
  - bookmarksinteger | null
  - quotesinteger | null
  - rawobject | null
- analysisStatusstringrequired
  one of pending, processing, ready, failed, skipped
- analysisErrorstring | nullrequired
- analysisobject | nullrequired
  Fields
  - topicstringrequired
  - hookstringrequired
  - formatstringrequired
  - tonestringrequired
  - audiencestringrequired
  - ctastringrequired
  - writingFrameworkstringrequired
  - keywordsarray<string>required
  - qualityScorenumberrequired
- analysisProviderstring | nullrequired
- analysisModelstring | nullrequired
- analysisPromptVersionstring | nullrequired
- analyzedAtstring | nullrequired
- generatedAtstring | nullrequired
- notesstring | nullrequired
- tagsarray<string>required
- socialAccountIdstring (uuid) | nullrequired
- createdBystring (uuid) | nullrequired
- feedbackReasonstring | nullrequired
- relevanceScorenumber | nullrequired
- whyItMattersstring | nullrequired
- interpretationobject | nullrequired
  Fields
  - relevanceScorenumberrequired
  - whyItMattersstringrequired
  - scoreBreakdownobjectrequired
    Fields
    strategyFitnumberrequired
    audienceFitnumberrequired
    qualitynumberrequired
    freshnessnumberrequired
    engagementnumberrequired
  - matchedPillarsarray<string>
  - matchedPrioritiesarray<string>
  - strategyNotesarray<string>
- strategyIdstring (uuid) | nullrequired
- strategyVersioninteger | nullrequired
- createdAtstringrequired
- updatedAtstringrequired
- generatedDraftsarray<object>
  Item fields
  - destinationstringrequired
    one of x, linkedin, thread, article
  - styleKeystringrequired
  - textstringrequired
- opportunityStatusstring
  one of open, saved, hidden, dismissed, acted_on

curl -X DELETE "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/$ITEM_ID" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

POST`/v1/orgs/{orgId}/inspiration/{itemId}/analyze`

Bearer token

Run (or re-run) AI analysis and workspace opportunity ranking (relevance + why this matters).

Path parameters

orgIdstring (uuid)required
itemIdstring (uuid)required

Responses

200Run (or re-run) AI analysis and workspace opportunity ranking (relevance + why this matters).

dataobjectrequired
Fields
- idstring (uuid)required
- orgIdstring (uuid)required
- platformstringrequired
  one of x, linkedin
- sourceTypestringrequired
  one of own_account, manual_url, manual_text, extension
- sourceExternalIdstring | nullrequired
- sourceUrlstring | nullrequired
- authorNamestring | nullrequired
- authorHandlestring | nullrequired
- authorProfileUrlstring | nullrequired
- contentTextstringrequired
- mediaobject | nullrequired
  Fields
  - itemsarray<object>
    Item fields
    typestring
    one of image, video, document, link, other
    urlstring (uri)
    altstring
    mimeTypestring
- publishedAtstring | nullrequired
- engagementobject | nullrequired
  Fields
  - likesinteger | null
  - commentsinteger | null
  - sharesinteger | null
  - impressionsinteger | null
  - bookmarksinteger | null
  - quotesinteger | null
  - rawobject | null
- analysisStatusstringrequired
  one of pending, processing, ready, failed, skipped
- analysisErrorstring | nullrequired
- analysisobject | nullrequired
  Fields
  - topicstringrequired
  - hookstringrequired
  - formatstringrequired
  - tonestringrequired
  - audiencestringrequired
  - ctastringrequired
  - writingFrameworkstringrequired
  - keywordsarray<string>required
  - qualityScorenumberrequired
- analysisProviderstring | nullrequired
- analysisModelstring | nullrequired
- analysisPromptVersionstring | nullrequired
- analyzedAtstring | nullrequired
- generatedAtstring | nullrequired
- notesstring | nullrequired
- tagsarray<string>required
- socialAccountIdstring (uuid) | nullrequired
- createdBystring (uuid) | nullrequired
- feedbackReasonstring | nullrequired
- relevanceScorenumber | nullrequired
- whyItMattersstring | nullrequired
- interpretationobject | nullrequired
  Fields
  - relevanceScorenumberrequired
  - whyItMattersstringrequired
  - scoreBreakdownobjectrequired
    Fields
    strategyFitnumberrequired
    audienceFitnumberrequired
    qualitynumberrequired
    freshnessnumberrequired
    engagementnumberrequired
  - matchedPillarsarray<string>
  - matchedPrioritiesarray<string>
  - strategyNotesarray<string>
- strategyIdstring (uuid) | nullrequired
- strategyVersioninteger | nullrequired
- createdAtstringrequired
- updatedAtstringrequired
- generatedDraftsarray<object>
  Item fields
  - destinationstringrequired
    one of x, linkedin, thread, article
  - styleKeystringrequired
  - textstringrequired
- opportunityStatusstring
  one of open, saved, hidden, dismissed, acted_on

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/$ITEM_ID/analyze" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

POST`/v1/orgs/{orgId}/inspiration/{itemId}/feedback`

Bearer token

Save, hide, dismiss, or reopen an inspiration opportunity to improve future ranking.

Path parameters

orgIdstring (uuid)required
itemIdstring (uuid)required

Request body application/json

actionstringrequired
one of save, hide, dismiss, reopen
reasonstring

Responses

200Save, hide, dismiss, or reopen an inspiration opportunity to improve future ranking.

dataobjectrequired
Fields
- idstring (uuid)required
- orgIdstring (uuid)required
- platformstringrequired
  one of x, linkedin
- sourceTypestringrequired
  one of own_account, manual_url, manual_text, extension
- sourceExternalIdstring | nullrequired
- sourceUrlstring | nullrequired
- authorNamestring | nullrequired
- authorHandlestring | nullrequired
- authorProfileUrlstring | nullrequired
- contentTextstringrequired
- mediaobject | nullrequired
  Fields
  - itemsarray<object>
    Item fields
    typestring
    one of image, video, document, link, other
    urlstring (uri)
    altstring
    mimeTypestring
- publishedAtstring | nullrequired
- engagementobject | nullrequired
  Fields
  - likesinteger | null
  - commentsinteger | null
  - sharesinteger | null
  - impressionsinteger | null
  - bookmarksinteger | null
  - quotesinteger | null
  - rawobject | null
- analysisStatusstringrequired
  one of pending, processing, ready, failed, skipped
- analysisErrorstring | nullrequired
- analysisobject | nullrequired
  Fields
  - topicstringrequired
  - hookstringrequired
  - formatstringrequired
  - tonestringrequired
  - audiencestringrequired
  - ctastringrequired
  - writingFrameworkstringrequired
  - keywordsarray<string>required
  - qualityScorenumberrequired
- analysisProviderstring | nullrequired
- analysisModelstring | nullrequired
- analysisPromptVersionstring | nullrequired
- analyzedAtstring | nullrequired
- generatedAtstring | nullrequired
- notesstring | nullrequired
- tagsarray<string>required
- socialAccountIdstring (uuid) | nullrequired
- createdBystring (uuid) | nullrequired
- feedbackReasonstring | nullrequired
- relevanceScorenumber | nullrequired
- whyItMattersstring | nullrequired
- interpretationobject | nullrequired
  Fields
  - relevanceScorenumberrequired
  - whyItMattersstringrequired
  - scoreBreakdownobjectrequired
    Fields
    strategyFitnumberrequired
    audienceFitnumberrequired
    qualitynumberrequired
    freshnessnumberrequired
    engagementnumberrequired
  - matchedPillarsarray<string>
  - matchedPrioritiesarray<string>
  - strategyNotesarray<string>
- strategyIdstring (uuid) | nullrequired
- strategyVersioninteger | nullrequired
- createdAtstringrequired
- updatedAtstringrequired
- generatedDraftsarray<object>
  Item fields
  - destinationstringrequired
    one of x, linkedin, thread, article
  - styleKeystringrequired
  - textstringrequired
- opportunityStatusstring
  one of open, saved, hidden, dismissed, acted_on

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/$ITEM_ID/feedback" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"save"}'

POST`/v1/orgs/{orgId}/inspiration/{itemId}/generate`

Bearer token

Create original LinkedIn/X/thread/article drafts inspired by a library opportunity while following brand voice, strategy, and avoiding plagiarism.

Path parameters

orgIdstring (uuid)required
itemIdstring (uuid)required

Request body application/json

destinationsarray<string>required
tonestring
objectivestring
additionalGuidancestring

Responses

200Create original LinkedIn/X/thread/article drafts inspired by a library opportunity while following brand voice, strategy, and avoiding plagiarism.

dataobjectrequired
Fields
- draftsarray<object>required
  Item fields
  - destinationstringrequired
    one of x, linkedin, thread, article
  - styleKeystringrequired
  - textstringrequired
- providerstringrequired
- providerModelstringrequired
- promptVersionstringrequired
- creditsUsednumberrequired
- remainingCreditsnumberrequired
- pendingApprovalGroupIdstring (uuid) | nullrequired

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/$ITEM_ID/generate" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"destinations":["x"]}'

GET`/v1/orgs/{orgId}/inspiration/algorithm-hints`

Bearer tokenMCP tool: get_platform_algorithm_hints

What each social platform's feed currently rewards and punishes, with the evidence, a confidence level and cited sources, so posts can be shaped for reach.

Path parameters

orgIdstring (uuid)required

Query parameters

platformstring
one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

Responses

200What each social platform's feed currently rewards and punishes, with the evidence, a confidence level and cited sources, so posts can be shaped for reach.

dataobjectrequired
Fields
- reviewedAtstringrequired
- caveatstringrequired
- platformsarray<object>required
  Item fields
  - platformstringrequired
    one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads
  - summarystringrequired
  - hintsanyrequired
  - sourcesanyrequired

curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/algorithm-hints" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

GET`/v1/orgs/{orgId}/inspiration/formats`

Bearer tokenMCP tool: list_viral_post_formats

Proven X and LinkedIn post formats with the structure, a fill-in template and an example of each, so a brand can borrow the shape of posts that spread.

Path parameters

orgIdstring (uuid)required

Query parameters

platformstring
one of x, linkedin
categorystring
one of hot_take, list, story, news, engagement, data, how_to

Responses

200Proven X and LinkedIn post formats with the structure, a fill-in template and an example of each, so a brand can borrow the shape of posts that spread.

dataarray<object>required
Item fields
- idstringrequired
- platformstringrequired
  one of x, linkedin
- namestringrequired
- categorystringrequired
  one of hot_take, list, story, news, engagement, data, how_to
- summarystringrequired
- whyItWorksstringrequired
- structureanyrequired
- templatestringrequired
- examplestringrequired
- bestForanyrequired

curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/formats" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

POST`/v1/orgs/{orgId}/inspiration/import`

Bearer token

Import inspiration by pasting a LinkedIn/X URL and/or raw post text.

Path parameters

orgIdstring (uuid)required

Request body application/json

platformstringrequired
one of x, linkedin
sourceUrlstring (uri)
contentTextstring
authorNamestring
authorHandlestring
authorProfileUrlstring (uri)
publishedAtstring
notesstring
tagsarray<string>
mediaobject
Fields
- itemsarray<object>
  Item fields
  - typestring
    one of image, video, document, link, other
  - urlstring (uri)
  - altstring
  - mimeTypestring
engagementobject
Fields
- likesinteger | null
- commentsinteger | null
- sharesinteger | null
- impressionsinteger | null
- bookmarksinteger | null
- quotesinteger | null
- rawobject | null
analyzeboolean

Responses

200Import inspiration by pasting a LinkedIn/X URL and/or raw post text.

dataobjectrequired
Fields
- idstring (uuid)required
- orgIdstring (uuid)required
- platformstringrequired
  one of x, linkedin
- sourceTypestringrequired
  one of own_account, manual_url, manual_text, extension
- sourceExternalIdstring | nullrequired
- sourceUrlstring | nullrequired
- authorNamestring | nullrequired
- authorHandlestring | nullrequired
- authorProfileUrlstring | nullrequired
- contentTextstringrequired
- mediaobject | nullrequired
  Fields
  - itemsarray<object>
    Item fields
    typestring
    one of image, video, document, link, other
    urlstring (uri)
    altstring
    mimeTypestring
- publishedAtstring | nullrequired
- engagementobject | nullrequired
  Fields
  - likesinteger | null
  - commentsinteger | null
  - sharesinteger | null
  - impressionsinteger | null
  - bookmarksinteger | null
  - quotesinteger | null
  - rawobject | null
- analysisStatusstringrequired
  one of pending, processing, ready, failed, skipped
- analysisErrorstring | nullrequired
- analysisobject | nullrequired
  Fields
  - topicstringrequired
  - hookstringrequired
  - formatstringrequired
  - tonestringrequired
  - audiencestringrequired
  - ctastringrequired
  - writingFrameworkstringrequired
  - keywordsarray<string>required
  - qualityScorenumberrequired
- analysisProviderstring | nullrequired
- analysisModelstring | nullrequired
- analysisPromptVersionstring | nullrequired
- analyzedAtstring | nullrequired
- generatedAtstring | nullrequired
- notesstring | nullrequired
- tagsarray<string>required
- socialAccountIdstring (uuid) | nullrequired
- createdBystring (uuid) | nullrequired
- feedbackReasonstring | nullrequired
- relevanceScorenumber | nullrequired
- whyItMattersstring | nullrequired
- interpretationobject | nullrequired
  Fields
  - relevanceScorenumberrequired
  - whyItMattersstringrequired
  - scoreBreakdownobjectrequired
    Fields
    strategyFitnumberrequired
    audienceFitnumberrequired
    qualitynumberrequired
    freshnessnumberrequired
    engagementnumberrequired
  - matchedPillarsarray<string>
  - matchedPrioritiesarray<string>
  - strategyNotesarray<string>
- strategyIdstring (uuid) | nullrequired
- strategyVersioninteger | nullrequired
- createdAtstringrequired
- updatedAtstringrequired
- generatedDraftsarray<object>
  Item fields
  - destinationstringrequired
    one of x, linkedin, thread, article
  - styleKeystringrequired
  - textstringrequired
- opportunityStatusstring
  one of open, saved, hidden, dismissed, acted_on

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/import" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"platform":"x"}'

POST`/v1/orgs/{orgId}/inspiration/import/account`

Bearer token

Import the authenticated user's recent X or LinkedIn posts into the inspiration library for AI analysis.

Path parameters

orgIdstring (uuid)required

Request body application/json

platformstringrequired
one of x, linkedin
socialAccountIdstring (uuid)
limitinteger
analyzeboolean

Responses

200Import the authenticated user's recent X or LinkedIn posts into the inspiration library for AI analysis.

dataobjectrequired
Fields
- importedarray<object>required
  Item fields
  - idstring (uuid)required
  - orgIdstring (uuid)required
  - platformstringrequired
    one of x, linkedin
  - sourceTypestringrequired
    one of own_account, manual_url, manual_text, extension
  - sourceExternalIdstring | nullrequired
  - sourceUrlstring | nullrequired
  - authorNamestring | nullrequired
  - authorHandlestring | nullrequired
  - authorProfileUrlstring | nullrequired
  - contentTextstringrequired
  - mediaobject | nullrequired
    Fields
    itemsarray<object>
    Item fields
    typestring
    one of image, video, document, link, other
    urlstring (uri)
    altstring
    mimeTypestring
  - publishedAtstring | nullrequired
  - engagementobject | nullrequired
    Fields
    likesinteger | null
    commentsinteger | null
    sharesinteger | null
    impressionsinteger | null
    bookmarksinteger | null
    quotesinteger | null
    rawobject | null
  - analysisStatusstringrequired
    one of pending, processing, ready, failed, skipped
  - analysisErrorstring | nullrequired
  - analysisobject | nullrequired
    Fields
    topicstringrequired
    hookstringrequired
    formatstringrequired
    tonestringrequired
    audiencestringrequired
    ctastringrequired
    writingFrameworkstringrequired
    keywordsarray<string>required
    qualityScorenumberrequired
  - analysisProviderstring | nullrequired
  - analysisModelstring | nullrequired
  - analysisPromptVersionstring | nullrequired
  - analyzedAtstring | nullrequired
  - generatedAtstring | nullrequired
  - notesstring | nullrequired
  - tagsarray<string>required
  - socialAccountIdstring (uuid) | nullrequired
  - createdBystring (uuid) | nullrequired
  - feedbackReasonstring | nullrequired
  - relevanceScorenumber | nullrequired
  - whyItMattersstring | nullrequired
  - interpretationobject | nullrequired
    Fields
    relevanceScorenumberrequired
    whyItMattersstringrequired
    scoreBreakdownobjectrequired
    Fields
    strategyFitnumberrequired
    audienceFitnumberrequired
    qualitynumberrequired
    freshnessnumberrequired
    engagementnumberrequired
    matchedPillarsarray<string>
    matchedPrioritiesarray<string>
    strategyNotesarray<string>
  - strategyIdstring (uuid) | nullrequired
  - strategyVersioninteger | nullrequired
  - createdAtstringrequired
  - updatedAtstringrequired
  - generatedDraftsarray<object>
    Item fields
    destinationstringrequired
    one of x, linkedin, thread, article
    styleKeystringrequired
    textstringrequired
  - opportunityStatusstring
    one of open, saved, hidden, dismissed, acted_on
- skippednumberrequired
- errorsarray<string>required

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/import/account" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"platform":"x"}'

POST`/v1/orgs/{orgId}/inspiration/import/external`

Bearer token

Accepts structured inspiration payloads from browser extensions or other external clients.

Path parameters

orgIdstring (uuid)required

Request body application/json

platformstringrequired
one of x, linkedin
contentTextstringrequired
sourceExternalIdstring
sourceUrlstring (uri)
authorNamestring
authorHandlestring
authorProfileUrlstring (uri)
mediaobject
Fields
- itemsarray<object>
  Item fields
  - typestring
    one of image, video, document, link, other
  - urlstring (uri)
  - altstring
  - mimeTypestring
publishedAtstring
engagementobject
Fields
- likesinteger | null
- commentsinteger | null
- sharesinteger | null
- impressionsinteger | null
- bookmarksinteger | null
- quotesinteger | null
- rawobject | null
notesstring
tagsarray<string>
clientobject
Fields
- namestring
- versionstring
analyzeboolean

Responses

200Accepts structured inspiration payloads from browser extensions or other external clients.

dataobjectrequired
Fields
- idstring (uuid)required
- orgIdstring (uuid)required
- platformstringrequired
  one of x, linkedin
- sourceTypestringrequired
  one of own_account, manual_url, manual_text, extension
- sourceExternalIdstring | nullrequired
- sourceUrlstring | nullrequired
- authorNamestring | nullrequired
- authorHandlestring | nullrequired
- authorProfileUrlstring | nullrequired
- contentTextstringrequired
- mediaobject | nullrequired
  Fields
  - itemsarray<object>
    Item fields
    typestring
    one of image, video, document, link, other
    urlstring (uri)
    altstring
    mimeTypestring
- publishedAtstring | nullrequired
- engagementobject | nullrequired
  Fields
  - likesinteger | null
  - commentsinteger | null
  - sharesinteger | null
  - impressionsinteger | null
  - bookmarksinteger | null
  - quotesinteger | null
  - rawobject | null
- analysisStatusstringrequired
  one of pending, processing, ready, failed, skipped
- analysisErrorstring | nullrequired
- analysisobject | nullrequired
  Fields
  - topicstringrequired
  - hookstringrequired
  - formatstringrequired
  - tonestringrequired
  - audiencestringrequired
  - ctastringrequired
  - writingFrameworkstringrequired
  - keywordsarray<string>required
  - qualityScorenumberrequired
- analysisProviderstring | nullrequired
- analysisModelstring | nullrequired
- analysisPromptVersionstring | nullrequired
- analyzedAtstring | nullrequired
- generatedAtstring | nullrequired
- notesstring | nullrequired
- tagsarray<string>required
- socialAccountIdstring (uuid) | nullrequired
- createdBystring (uuid) | nullrequired
- feedbackReasonstring | nullrequired
- relevanceScorenumber | nullrequired
- whyItMattersstring | nullrequired
- interpretationobject | nullrequired
  Fields
  - relevanceScorenumberrequired
  - whyItMattersstringrequired
  - scoreBreakdownobjectrequired
    Fields
    strategyFitnumberrequired
    audienceFitnumberrequired
    qualitynumberrequired
    freshnessnumberrequired
    engagementnumberrequired
  - matchedPillarsarray<string>
  - matchedPrioritiesarray<string>
  - strategyNotesarray<string>
- strategyIdstring (uuid) | nullrequired
- strategyVersioninteger | nullrequired
- createdAtstringrequired
- updatedAtstringrequired
- generatedDraftsarray<object>
  Item fields
  - destinationstringrequired
    one of x, linkedin, thread, article
  - styleKeystringrequired
  - textstringrequired
- opportunityStatusstring
  one of open, saved, hidden, dismissed, acted_on

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/import/external" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"platform":"x","contentText":"string"}'

GET`/v1/orgs/{orgId}/inspiration/news`

Bearer tokenMCP tool: get_niche_news

Recent web news for the topics the workspace follows (its research focus, brand topics and expertise). Topics are shared across workspaces and refreshed hourly, so this is served from the research cache and spends no credits.

Path parameters

orgIdstring (uuid)required

Responses

200Recent web news for the topics the workspace follows (its research focus, brand topics and expertise). Topics are shared across workspaces and refreshed hourly, so this is served from the research cache and spends no credits.

dataobjectrequired
Fields
- groundedbooleanrequired
- reasonstring | nullrequired
- topicsarray<object>required
  Item fields
  - slugstringrequired
  - labelstringrequired
  - articlesarray<object>required
    Item fields
    titlestringrequired
    urlstringrequired
    snippetstringrequired
    publishedAtstring | nullrequired

curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/news" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

GET`/v1/orgs/{orgId}/inspiration/trends`

Bearer tokenMCP tool: get_trending_topics

Returns the most recent trending-topics report for the workspace, or null when none has been run.

Path parameters

orgIdstring (uuid)required

Responses

200Returns the most recent trending-topics report for the workspace, or null when none has been run.

dataobject | nullrequired
Fields
- idstringrequired
- focusstring | nullrequired
- groundedbooleanrequired
- searchQueriesarray<string>required
- topicsarray<object>required
  Item fields
  - idstringrequired
  - titlestringrequired
  - summarystringrequired
  - whyNowstringrequired
  - momentumstringrequired
    one of breaking, rising, evergreen
  - hotTakestringrequired
  - brandAnglestringrequired
  - sourcesarray<object>required
    Item fields
    titlestringrequired
    urlstring (uri)required
    publishedAtstring | nullrequired
    platformstring
    one of web, x
  - postIdeasarray<object>required
    Item fields
    platformstringrequired
    one of x, linkedin
    formatIdstringrequired
    formatNamestringrequired
    textstringrequired
    templateboolean
- generatedAtstringrequired
- groundingReasonstring | null
- xSearchobject | null
  Fields
  - statusstringrequired
    one of ok, no_posts, failed, unavailable
  - postsFoundintegerrequired
  - sourcesCitedintegerrequired
  - messagestring | nullrequired

curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/inspiration/trends" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

POST`/v1/orgs/{orgId}/inspiration/trends`

Bearer tokenMCP tool: find_trending_topics

Searches the web and recent X posts for news and debates in the brand's niche (or a given focus), then suggests hot takes and X / LinkedIn posts in proven viral formats. Counts toward the workspace's monthly AI usage allowance (including X reads), and saves the report.

Path parameters

orgIdstring (uuid)required

Request body application/json

focusstring
maxTopicsinteger
platformsarray<string>

Responses

200Searches the web and recent X posts for news and debates in the brand's niche (or a given focus), then suggests hot takes and X / LinkedIn posts in proven viral formats. Counts toward the workspace's monthly AI usage allowance (including X reads), and saves the report.

dataobjectrequired
Fields
- idstringrequired
- focusstring | nullrequired
- groundedbooleanrequired
- searchQueriesarray<string>required
- topicsarray<object>required
  Item fields
  - idstringrequired
  - titlestringrequired
  - summarystringrequired
  - whyNowstringrequired
  - momentumstringrequired
    one of breaking, rising, evergreen
  - hotTakestringrequired
  - brandAnglestringrequired
  - sourcesarray<object>required
    Item fields
    titlestringrequired
    urlstring (uri)required
    publishedAtstring | nullrequired
    platformstring
    one of web, x
  - postIdeasarray<object>required
    Item fields
    platformstringrequired
    one of x, linkedin
    formatIdstringrequired
    formatNamestringrequired
    textstringrequired
    templateboolean
- generatedAtstringrequired
- groundingReasonstring | null
- xSearchobject | null
  Fields
  - statusstringrequired
    one of ok, no_posts, failed, unavailable
  - postsFoundintegerrequired
  - sourcesCitedintegerrequired
  - messagestring | nullrequired

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

Inspiration API

GET/v1/orgs/{orgId}/inspiration

Path parameters

Query parameters

Responses

GET/v1/orgs/{orgId}/inspiration/{itemId}

Path parameters

Responses

PATCH/v1/orgs/{orgId}/inspiration/{itemId}

Path parameters

Request body application/json

Responses

DELETE/v1/orgs/{orgId}/inspiration/{itemId}

Path parameters

Responses

POST/v1/orgs/{orgId}/inspiration/{itemId}/analyze

Path parameters

Responses

POST/v1/orgs/{orgId}/inspiration/{itemId}/feedback

Path parameters

Request body application/json

Responses

POST/v1/orgs/{orgId}/inspiration/{itemId}/generate

Path parameters

Request body application/json

Responses

GET/v1/orgs/{orgId}/inspiration/algorithm-hints

Path parameters

Query parameters

Responses

GET/v1/orgs/{orgId}/inspiration/formats

Path parameters

Query parameters

Responses

POST/v1/orgs/{orgId}/inspiration/import

Path parameters

Request body application/json

Responses

POST/v1/orgs/{orgId}/inspiration/import/account

Path parameters

Request body application/json

Responses

POST/v1/orgs/{orgId}/inspiration/import/external

Path parameters

Request body application/json

Responses

GET/v1/orgs/{orgId}/inspiration/news

Path parameters

Responses

GET/v1/orgs/{orgId}/inspiration/trends

Path parameters

Responses

POST/v1/orgs/{orgId}/inspiration/trends

Path parameters

Request body application/json

Responses

GET`/v1/orgs/{orgId}/inspiration`

GET`/v1/orgs/{orgId}/inspiration/{itemId}`

PATCH`/v1/orgs/{orgId}/inspiration/{itemId}`

DELETE`/v1/orgs/{orgId}/inspiration/{itemId}`

POST`/v1/orgs/{orgId}/inspiration/{itemId}/analyze`

POST`/v1/orgs/{orgId}/inspiration/{itemId}/feedback`

POST`/v1/orgs/{orgId}/inspiration/{itemId}/generate`

GET`/v1/orgs/{orgId}/inspiration/algorithm-hints`

GET`/v1/orgs/{orgId}/inspiration/formats`

POST`/v1/orgs/{orgId}/inspiration/import`

POST`/v1/orgs/{orgId}/inspiration/import/account`

POST`/v1/orgs/{orgId}/inspiration/import/external`

GET`/v1/orgs/{orgId}/inspiration/news`

GET`/v1/orgs/{orgId}/inspiration/trends`

POST`/v1/orgs/{orgId}/inspiration/trends`