BUbundle
postImport

Start a new post history import

Changed on

Kick off an asynchronous import that backfills posts a social account published before it was connected to bundle.social, together with their analytics. Use it to get historical reporting from day one.

post/api/v1/post-history-import/

Request

  • Base URL
    https://api.bundle.social
  • URL
    https://api.bundle.social/api/v1/post-history-import/
  • Auth
    API key in header x-api-key

Request body

teamIdstring required
socialAccountType'FACEBOOK' | 'INSTAGRAM' | 'THREADS' | 'TIKTOK' | 'YOUTUBE' | 'LINKEDIN' | 'PINTEREST' | 'REDDIT' | 'MASTODON' | 'BLUESKY' | 'TWITTER' required
countinteger required
withAnalyticsboolean
importCarouselsboolean
onlyLatestboolean
surface'PROFILE_GRID' | 'NON_GRID' | 'STORY' | 'ALL'
mediaType'VIDEO' | 'IMAGE'

Response

201

idstring required
teamIdstring required
socialAccountIdstring required
requestedCountnumber required
withAnalyticsboolean required
importCarouselsboolean required
onlyLatestboolean required
surface'PROFILE_GRID' | 'NON_GRID' | 'STORY' | 'ALL' nullable
mediaType'VIDEO' | 'IMAGE' nullable
status'PENDING' | 'FETCHING_POSTS' | 'FETCHING_ANALYTICS' | 'COMPLETED' | 'FAILED' | 'RATE_LIMITED' required
postsImportednumber required
analyticsImportednumber required
errorstring nullable
rateLimitResetAtstring date-time nullable
startedAtstring date-time nullable
completedAtstring date-time nullable
createdAtstring date-time nullable required
updatedAtstring date-time nullable required
deletedAtstring date-time nullable

Changes

  • fb6e4fbd8d2fRevision changes
    • info

      added the new optional request property

    • info

      added the new TWITTER enum value to the request property

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status