{
  "info": {
    "name": "Fluxcrawl API",
    "description": "TikTok, Instagram, and X endpoints for the Fluxcrawl API. See https://fluxcrawl.dev/docs for full documentation.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "X-API-Key",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{apiKey}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.fluxcrawl.dev"
    },
    {
      "key": "apiKey",
      "value": ""
    }
  ],
  "item": [
    {
      "name": "TikTok",
      "item": [
        {
          "name": "Get profile",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Look up a TikTok profile by username.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/tiktok/profile?username=tiktok",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tiktok",
                "profile"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "tiktok"
                }
              ]
            }
          }
        },
        {
          "name": "List posts",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List recent posts for a TikTok profile, newest first, pinned posts excluded.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/tiktok/posts?username=tiktok&count=3",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tiktok",
                "posts"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "tiktok"
                },
                {
                  "key": "count",
                  "value": "3"
                }
              ]
            }
          }
        },
        {
          "name": "Get post",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Fetch a single TikTok post/video by ID.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/tiktok/post?id=7680721699171601694",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tiktok",
                "post"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "7680721699171601694"
                }
              ]
            }
          }
        },
        {
          "name": "List comments",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List comments on a TikTok post. `count` sets how many comments to return.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/tiktok/comments?id=7680721699171601694&count=1",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tiktok",
                "comments"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "7680721699171601694"
                },
                {
                  "key": "count",
                  "value": "1"
                }
              ]
            }
          }
        },
        {
          "name": "Search users",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Search TikTok creators by keyword.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/tiktok/search?query=tiktok",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tiktok",
                "search"
              ],
              "query": [
                {
                  "key": "query",
                  "value": "tiktok"
                }
              ]
            }
          }
        },
        {
          "name": "List followers",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List a TikTok account's followers.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/tiktok/followers?username=tiktok",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tiktok",
                "followers"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "tiktok"
                }
              ]
            }
          }
        },
        {
          "name": "List following",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List who a TikTok account follows.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/tiktok/following?username=tiktok",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tiktok",
                "following"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "tiktok"
                }
              ]
            }
          }
        },
        {
          "name": "Discover content",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Search TikTok content by keyword or hashtag.\n\nThis is content search. `search` is TikTok **user** search; the two stay separate so each endpoint always returns one shape.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/tiktok/discover?query=cats",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tiktok",
                "discover"
              ],
              "query": [
                {
                  "key": "query",
                  "value": "cats"
                }
              ]
            }
          }
        }
      ]
    },
    {
      "name": "X",
      "item": [
        {
          "name": "Get profile",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Look up an X (Twitter) profile by username.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/x/profile?username=elonmusk",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "x",
                "profile"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "elonmusk"
                }
              ]
            }
          }
        },
        {
          "name": "List posts",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List recent tweets for an X profile.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/x/posts?username=elonmusk",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "x",
                "posts"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "elonmusk"
                }
              ]
            }
          }
        },
        {
          "name": "Get post",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Fetch a single tweet by ID.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/x/post?id=1893456789012345678",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "x",
                "post"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "1893456789012345678"
                }
              ]
            }
          }
        },
        {
          "name": "List comments",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List replies to a tweet.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/x/comments?id=1893456789012345678",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "x",
                "comments"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "1893456789012345678"
                }
              ]
            }
          }
        },
        {
          "name": "Search users",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Search X users by keyword.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/x/search?query=elonmusk",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "x",
                "search"
              ],
              "query": [
                {
                  "key": "query",
                  "value": "elonmusk"
                }
              ]
            }
          }
        },
        {
          "name": "List followers",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List an X account's followers.\n\n`verified` reflects only X's legacy verification flag on this list, which reads `false` for almost every account. Use `profile` for real verification status.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/x/followers?username=elonmusk",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "x",
                "followers"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "elonmusk"
                }
              ]
            }
          }
        },
        {
          "name": "List following",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List who an X account follows.\n\n`verified` reflects only X's legacy verification flag on this list, which reads `false` for almost every account. Use `profile` for real verification status.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/x/following?username=elonmusk",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "x",
                "following"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "elonmusk"
                }
              ]
            }
          }
        },
        {
          "name": "List retweeters",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List who retweeted a tweet.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/x/retweeters?id=2101767007406641574",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "x",
                "retweeters"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "2101767007406641574"
                }
              ]
            }
          }
        },
        {
          "name": "Discover content",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Search X content by keyword or hashtag.\n\nThis is content search. `search` is X **user** search; the two stay separate so each endpoint always returns one shape.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/x/discover?query=cats",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "x",
                "discover"
              ],
              "query": [
                {
                  "key": "query",
                  "value": "cats"
                }
              ]
            }
          }
        },
        {
          "name": "Get community",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Get an X community's details and recent posts in one call.\n\nFans out to two upstream calls internally (details, then recent posts).\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/x/community?id=1493446837214187523",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "x",
                "community"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "1493446837214187523"
                }
              ]
            }
          }
        }
      ]
    },
    {
      "name": "Instagram",
      "item": [
        {
          "name": "Get profile",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Look up an Instagram profile by username.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/profile?username=instagram",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "profile"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "instagram"
                }
              ]
            }
          }
        },
        {
          "name": "List posts",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List recent posts for an Instagram profile.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/posts?username=instagram",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "posts"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "instagram"
                }
              ]
            }
          }
        },
        {
          "name": "Get post",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Fetch a single Instagram post by ID.\n\nLike counts are live and can drift slightly between calls, even seconds apart. That's Instagram's real-time data, not a Fluxcrawl inconsistency.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/post?id=3989102446432402227",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "post"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "3989102446432402227"
                }
              ]
            }
          }
        },
        {
          "name": "List comments",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List comments on an Instagram post.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/comments?id=3989102446432402227",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "comments"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "3989102446432402227"
                }
              ]
            }
          }
        },
        {
          "name": "Search users",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Search Instagram users by keyword.\n\n`followers` is always `0` here: Instagram's search response doesn't include a follower count, and hydrating every result would turn one call into N+1 upstream calls. If this request is served by the fallback provider, `verified` can read `false` for a verified account. Use `profile` when you need the verified status to be authoritative.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/search?query=instagram",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "search"
              ],
              "query": [
                {
                  "key": "query",
                  "value": "instagram"
                }
              ]
            }
          }
        },
        {
          "name": "List followers",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List an Instagram account's followers.\n\n`followers` is always `0` on listed rows, and `display_name` can be empty when an account hasn't set one. Use `profile` for full details.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/followers?username=instagram",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "followers"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "instagram"
                }
              ]
            }
          }
        },
        {
          "name": "List following",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List who an Instagram account follows.\n\n`followers` is always `0` on listed rows, and `display_name` can be empty when an account hasn't set one. Use `profile` for full details.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/following?username=instagram",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "following"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "instagram"
                }
              ]
            }
          }
        },
        {
          "name": "List likers",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List who liked an Instagram post.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/likers?id=3989102446432402227",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "likers"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "3989102446432402227"
                }
              ]
            }
          }
        },
        {
          "name": "Discover content",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Search Instagram content by keyword or hashtag. Maps to a hashtag-media search. No plain-keyword search exists on this endpoint, only hashtag-based, so a leading `#` is optional and stripped.\n\nThis is content search. `search` is Instagram **account** search. Searching `cats` returns posts tagged `#cats`, not a keyword match across captions.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/discover?query=cats",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "discover"
              ],
              "query": [
                {
                  "key": "query",
                  "value": "cats"
                }
              ]
            }
          }
        },
        {
          "name": "List highlights",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List an Instagram account's story highlights.\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/highlights?username=instagram",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "highlights"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "instagram"
                }
              ]
            }
          }
        },
        {
          "name": "List stories",
          "request": {
            "method": "GET",
            "header": [],
            "description": "List an Instagram account's active stories.\n\nStories expire 24 hours after posting, so this returns an empty array for most accounts most of the time, not an error. No view count: Instagram doesn't expose one for accounts you don't own.\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/stories?username=instagram",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "stories"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "instagram"
                }
              ]
            }
          }
        },
        {
          "name": "Get about",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Get an Instagram account's transparency panel (join date, country, former usernames).\n\n`joined_date` is a plain \"Month Year\" string with no exact day. Don't parse it as ISO 8601.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/about?username=instagram",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "about"
              ],
              "query": [
                {
                  "key": "username",
                  "value": "instagram"
                }
              ]
            }
          }
        },
        {
          "name": "Search locations",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Search Instagram locations near a coordinate. Not a name search: pass `lat` and `lng`.\n\n`posts` is always empty on search results, to avoid N+1 upstream calls. Pass a result's `id` to `location` to get that place's posts.\n\nReturns the first page only; pagination isn't exposed yet.\n\n**Cost:** 1 credit per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/locations?lat=40.7128&lng=-74.0060",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "locations"
              ],
              "query": [
                {
                  "key": "lat",
                  "value": "40.7128"
                },
                {
                  "key": "lng",
                  "value": "-74.0060"
                }
              ]
            }
          }
        },
        {
          "name": "Get location",
          "request": {
            "method": "GET",
            "header": [],
            "description": "Get an Instagram location's details and recent posts in one call.\n\n**Cost:** 2 credits per successful call.",
            "url": {
              "raw": "{{baseUrl}}/v1/instagram/location?id=233608000157522",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "instagram",
                "location"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "233608000157522"
                }
              ]
            }
          }
        }
      ]
    }
  ]
}