Mobile feed

The mobile feed holds the posts a user forwarded to Brandsearch from the Instagram or Facebook app: reels, photos and videos, as they appear in the Mobile feed tab of Swipe Files. These endpoints let a tool do by code what the user does by hand in that tab: read their posts, keep folders, file a post in a folder, and take a post out of the feed.

You choose the folders. Brandsearch files nothing by itself: your automation (Zapier, Make, n8n, your own code) or your AI assistant reads the new posts and decides where each one goes.

Instagram and Facebook. Posts and folders belong to one platform, given by platform. A post goes only in a folder of its own platform. Facebook is in early access in the app: until it opens to everyone, only accounts with that access see Facebook posts and folders. Other accounts get Instagram only, and asking for Facebook by name is a 403 feature_not_available.

Watch for new posts

To act on every post a user forwards, ask for the posts received since the last one you handled, every few minutes:

1. List the feed once (GET /v1/swipe/mobile-feed/posts) and keep the received_at of the newest post.
2. On each run, ask for GET /v1/swipe/mobile-feed/posts?received_after=<that received_at>. Only newer posts come back, newest first.
3. Handle them, then keep the newest received_at for the next run.

Reading the feed is free: it does not count against your quota, so checking every few minutes costs nothing. Rate limits still apply.

Pricing and limits

• Reads are free: listing and reading posts and folders do not count against your quota (X-Quota-Charged: false).
• Writes count as 1 request and cost 0 credits.
• Creating, renaming and deleting a folder each have their own limit of 1 request per second and 5 per minute per key, separate from the other Swipe folders' limits.
• Filing a post, taking it out of a folder, and taking it out of the feed share a separate limit of 2 requests per second and 60 per minute per key, enough to sort a backlog one post at a time.

The post record

Post filters

platform, type, media_format, sort_by and sort_order are case-insensitive. Any other value is a 400 invalid_parameter naming the parameter, with details.allowed listing the accepted values; a date we cannot read is a 400 invalid_parameter too. Results are paginated with page and page_size (up to 100).

List posts

curl -G https://api.brandsearch.co/v1/swipe/mobile-feed/posts \
  -H "X-API-Key: bsk_your_api_key" \
  -d type=reel \
  -d received_after=2026-10-11T08:00:00.000Z

{
  "data": [
    {
      "id": "reel_18189285490405380",
      "platform": "instagram",
      "type": "reel",
      "media_format": "video",
      "received_at": "2026-10-11T13:58:10.930Z",
      "posted_at": "2026-10-09T11:07:33.000Z",
      "caption": "3 steps to glass skin #skincare",
      "hashtags": ["#skincare"],
      "media_url": "https://cdn.brandsearch.co/mobile-feed/18189285490405380.mp4",
      "permalink": "https://www.instagram.com/reel/DPq1aBcDeFg/",
      "duration_seconds": 21.5,
      "like_count": 1200,
      "comment_count": 40,
      "view_count": 56000,
      "share_count": null,
      "author": {
        "id": "999",
        "username": "glowbrand",
        "name": "Glow Brand",
        "is_verified": true,
        "follower_count": 81000,
        "profile_pic_url": "https://cdn.brandsearch.co/instagram/pp_999.jpg"
      },
      "folder_ids": ["cmv8lulla7yn3n9769tujw1cv"],
      "dashboard_url": "https://app.brandsearch.co/swipe-files/mobile-feed/reel_18189285490405380"
    }
  ],
  "pagination": { "page": 1, "page_size": 20, "total": 1, "total_pages": 1 }
}

Get a post

curl https://api.brandsearch.co/v1/swipe/mobile-feed/posts/reel_18189285490405380 \
  -H "X-API-Key: bsk_your_api_key"

Remove a post from the feed

curl -X DELETE \
  https://api.brandsearch.co/v1/swipe/mobile-feed/posts/reel_18189285490405380 \
  -H "X-API-Key: bsk_your_api_key"

{
  "id": "reel_18189285490405380",
  "removed": true
}

The folder record

Mobile feed folders are the user's own: they are not shared, and every folder below belongs to the API key's user. Folders, and filing posts in them, need an active paid plan.

List folders

curl https://api.brandsearch.co/v1/swipe/mobile-feed/folders \
  -H "X-API-Key: bsk_your_api_key"

{
  "data": [
    {
      "id": "cmv8lulla7yn3n9769tujw1cv",
      "name": "Skincare hooks",
      "platform": "instagram",
      "item_count": 12,
      "created_at": "2026-10-11T14:02:00+00:00",
      "updated_at": "2026-10-11T14:02:00+00:00"
    }
  ],
  "pagination": { "page": 1, "page_size": 20, "total": 1, "total_pages": 1 }
}

Create a folder

curl -X POST https://api.brandsearch.co/v1/swipe/mobile-feed/folders \
  -H "X-API-Key: bsk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Skincare hooks"}'

{
  "id": "cmv8lulla7yn3n9769tujw1cv",
  "name": "Skincare hooks",
  "platform": "instagram",
  "item_count": 0,
  "created_at": "2026-10-11T14:02:00+00:00",
  "updated_at": "2026-10-11T14:02:00+00:00"
}

Get, rename or delete a folder

curl -X PATCH \
  https://api.brandsearch.co/v1/swipe/mobile-feed/folders/cmv8lulla7yn3n9769tujw1cv \
  -H "X-API-Key: bsk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Skincare hooks, best"}'

File a post in a folder

curl -X POST \
  https://api.brandsearch.co/v1/swipe/mobile-feed/folders/cmv8lulla7yn3n9769tujw1cv/items \
  -H "X-API-Key: bsk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"post_id": "reel_18189285490405380"}'

{
  "folder_id": "cmv8lulla7yn3n9769tujw1cv",
  "post_id": "reel_18189285490405380",
  "already_in_folder": false
}

Take a post out of a folder

curl -X DELETE \
  https://api.brandsearch.co/v1/swipe/mobile-feed/folders/cmv8lulla7yn3n9769tujw1cv/items/reel_18189285490405380 \
  -H "X-API-Key: bsk_your_api_key"

{
  "folder_id": "cmv8lulla7yn3n9769tujw1cv",
  "post_id": "reel_18189285490405380",
  "removed": true,
  "already_removed": false
}

From your AI assistant

The MCP server gives the same access to an AI assistant: get_mobile_feed lists the posts with the same filters, remove_from_mobile_feed takes one out of the feed, and the folder tools (except get_folder_ads and get_folder_brands) take folder_type="mobile_feed". A user can ask, for example, to sort their latest reels into folders by theme.

Errors

• 403 plan_required: a folder endpoint, or filing a post in a folder or taking it out, on a trial, a cancelled plan or no paid plan. Listing, reading and removing posts work on any plan.
• 403 swipe_not_provisioned, 409 account_link_broken: the API key is not linked to a Brandsearch user, or is linked to one that no longer exists (see Errors).
• 403 feature_not_available: Facebook asked for by an account without early access.
• 404 mobile_feed_post_not_found: the post is not in the user's feed.
• 404 swipe_folder_not_found: the folder does not exist or is not the user's.
• 409 swipe_folder_name_taken: when creating or renaming a folder. 429 swipe_folder_quota_exceeded: when creating one past the plan's folder cap.
• 409 mobile_feed_write_conflict: a post kept changing while it was being saved. Send the request again.
• 400 invalid_parameter or 400 validation_error for a bad value, with the parameter named.

See Errors for the full list.