ドキュメント

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/x/users/newdev"

{
  "data": {
    "id": "2244994945",
    "platform": "x",
    "type": "profile",
    "username": "newdev",
    "display_name": "New Dev",
    "description": "Building data APIs.",
    "url": "https://x.com/newdev",
    "profile_image_url": "https://cdn.example.com/avatar/newdev.jpg",
    "banner_image_url": null,
    "location": "Berlin",
    "verified": false,
    "created_at": "2019-04-01T10:15:00Z",
    "metrics": {
      "followers": 1204,
      "following": 312,
      "posts": 870,
      "likes": 15200
    },
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 120,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/x/users/newdev/posts"

{
  "data": [
    {
      "id": "1842951234567890123",
      "platform": "x",
      "type": "post",
      "author": {
        "id": "2244994945",
        "username": "newdev",
        "display_name": "New Dev",
        "verified": false
      },
      "text": "One API for internet data.",
      "lang": "en",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 128,
        "reposts": 12,
        "replies": 4,
        "quotes": 1,
        "views": 5230
      },
      "in_reply_to": null,
      "attachments": [],
      "fetched_at": "2026-09-18T09:00:00Z"
    },
    {
      "id": "1842909876543210987",
      "platform": "x",
      "type": "post",
      "author": {
        "id": "2244994945",
        "username": "newdev",
        "display_name": "New Dev",
        "verified": false
      },
      "text": "Freshness modes explained.",
      "lang": "en",
      "created_at": "2026-09-16T08:00:00Z",
      "metrics": {
        "likes": 64,
        "reposts": 3,
        "replies": 1,
        "quotes": 0,
        "views": 1200
      },
      "in_reply_to": null,
      "attachments": [
        {
          "type": "photo",
          "url": "https://cdn.example.com/p/1.jpg",
          "width": 1024,
          "height": 512
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": "eyJpZCI6IjE4MjkwMDAwMDAwMDAwMDAwIn0",
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/x/posts/1842951234567890123"

{
  "data": {
    "id": "1842951234567890123",
    "platform": "x",
    "type": "post",
    "author": {
      "id": "2244994945",
      "username": "newdev",
      "display_name": "New Dev",
      "verified": false
    },
    "text": "One API for internet data.",
    "lang": "en",
    "created_at": "2026-09-17T12:34:56Z",
    "metrics": {
      "likes": 128,
      "reposts": 12,
      "replies": 4,
      "quotes": 1,
      "views": 5230
    },
    "in_reply_to": null,
    "attachments": [],
    "fetched_at": "2026-09-18T07:30:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 3600,
      "source_layer": "cache",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": true
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/x/posts/1842951234567890123/comments"

{
  "data": [
    {
      "id": "1842951999999999999",
      "platform": "x",
      "type": "comment",
      "post_id": "1842951234567890123",
      "author": {
        "id": "1122334455",
        "username": "curiouscat",
        "display_name": "Curious Cat",
        "verified": false
      },
      "text": "Great post!",
      "created_at": "2026-09-17T13:00:00Z",
      "metrics": {
        "likes": 3
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 600,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/x/search/posts?q=fetchpi"

{
  "data": [
    {
      "id": "1841001111111111111",
      "platform": "x",
      "type": "post",
      "author": {
        "id": "5566778899",
        "username": "datafan",
        "display_name": "Data Fan",
        "verified": true
      },
      "text": "fetchpi launch day!",
      "lang": "en",
      "created_at": "2026-09-15T10:00:00Z",
      "metrics": {
        "likes": 9,
        "reposts": 2,
        "replies": 0,
        "quotes": 0,
        "views": 340
      },
      "in_reply_to": null,
      "attachments": [],
      "fetched_at": "2026-09-18T09:05:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "live",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/x/users/newdev/followers"

{
  "data": [
    {
      "id": "2244994945",
      "platform": "x",
      "type": "profile",
      "username": "newdev",
      "display_name": "New Dev",
      "description": "Building data APIs.",
      "url": "https://x.com/newdev",
      "profile_image_url": "https://cdn.example.com/avatar/newdev.jpg",
      "banner_image_url": null,
      "location": "Berlin",
      "verified": false,
      "created_at": "2019-04-01T10:15:00Z",
      "metrics": {
        "followers": 1204,
        "following": 312,
        "posts": 870,
        "likes": 15200
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/x/users/newdev/following"

{
  "data": [
    {
      "id": "2244994945",
      "platform": "x",
      "type": "profile",
      "username": "newdev",
      "display_name": "New Dev",
      "description": "Building data APIs.",
      "url": "https://x.com/newdev",
      "profile_image_url": "https://cdn.example.com/avatar/newdev.jpg",
      "banner_image_url": null,
      "location": "Berlin",
      "verified": false,
      "created_at": "2019-04-01T10:15:00Z",
      "metrics": {
        "followers": 1204,
        "following": 312,
        "posts": 870,
        "likes": 15200
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/x/users/newdev/replies"

{
  "data": [
    {
      "id": "1842951234567890123",
      "platform": "x",
      "type": "post",
      "author": {
        "id": "2244994945",
        "username": "newdev",
        "display_name": "New Dev",
        "verified": false
      },
      "text": "One API for internet data.",
      "lang": "en",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 128,
        "reposts": 12,
        "replies": 4,
        "quotes": 1,
        "views": 5230
      },
      "in_reply_to": null,
      "attachments": [],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/x/users/newdev/media"

{
  "data": [
    {
      "id": "1842951234567890123",
      "platform": "x",
      "type": "post",
      "author": {
        "id": "2244994945",
        "username": "newdev",
        "display_name": "New Dev",
        "verified": false
      },
      "text": "One API for internet data.",
      "lang": "en",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 128,
        "reposts": 12,
        "replies": 4,
        "quotes": 1,
        "views": 5230
      },
      "in_reply_to": null,
      "attachments": [],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/x/trends?q=fetchpi"

{
  "data": {
    "platform": "x",
    "type": "trends",
    "country": "united states",
    "trends": [
      {
        "name": "#FetchPI",
        "post_count": 52341
      },
      {
        "name": "Normalized Entities",
        "post_count": 8800,
        "url": "https://x.com/search?q=normalized"
      }
    ],
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/users/newdev"

{
  "data": {
    "id": "7004994945112",
    "platform": "tiktok",
    "type": "profile",
    "username": "creatordev",
    "display_name": "Creator Dev",
    "description": "Short videos about data APIs.",
    "url": "https://fetchpi.com",
    "profile_image_url": "https://cdn.example.com/avatar/creatordev.jpg",
    "verified": true,
    "is_private": false,
    "created_at": "2017-10-01T00:00:00Z",
    "metrics": {
      "followers": 88230,
      "following": 412,
      "posts": 356,
      "likes": 2140000
    },
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 120,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/users/newdev/posts"

{
  "data": [
    {
      "id": "7410886000000000001",
      "platform": "tiktok",
      "type": "post",
      "author": {
        "id": "7004994945112",
        "username": "creatordev",
        "display_name": "Creator Dev",
        "verified": true
      },
      "text": "One API for every platform.",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 864,
        "comments": 42,
        "shares": 87,
        "collects": 310,
        "views": 154203
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/cover.jpeg",
          "duration_ms": 34567
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    },
    {
      "id": "7410886000000000002",
      "platform": "tiktok",
      "type": "post",
      "author": {
        "id": "7004994945112",
        "username": "creatordev",
        "display_name": "Creator Dev",
        "verified": true
      },
      "text": "Photo dump from launch week.",
      "created_at": "2026-09-16T08:00:00Z",
      "metrics": {
        "likes": 412,
        "comments": 18,
        "shares": 9,
        "collects": 77,
        "views": 52100
      },
      "attachments": [
        {
          "type": "photo",
          "url": "https://cdn.example.com/p/1.jpeg"
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": "eyJ2IjoxLCJzcmMiOiJ4dGhpcmQiLCJwb3MiOiIxNzU4MzI2NDAwIn0",
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/posts/1842951234567890123"

{
  "data": {
    "id": "7410886000000000001",
    "platform": "tiktok",
    "type": "post",
    "author": {
      "id": "7004994945112",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "verified": true
    },
    "text": "One API for every platform.",
    "created_at": "2026-09-17T12:34:56Z",
    "metrics": {
      "likes": 864,
      "comments": 42,
      "shares": 87,
      "collects": 310,
      "views": 154203
    },
    "attachments": [
      {
        "type": "video",
        "preview_image_url": "https://cdn.example.com/cover.jpeg",
        "duration_ms": 34567
      }
    ],
    "fetched_at": "2026-09-18T07:30:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 3600,
      "source_layer": "cache",
      "stale": false
    },
    "billing": {
      "amount_credits": 0,
      "cache_hit": true
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/posts/1842951234567890123/comments"

{
  "data": [
    {
      "id": "7411111111000000001",
      "platform": "tiktok",
      "type": "comment",
      "post_id": "7410886000000000001",
      "author": {
        "id": "3311223344",
        "username": "curiousfan",
        "display_name": "Curious Fan",
        "verified": false
      },
      "text": "This is the future of data APIs.",
      "created_at": "2026-09-17T13:00:00Z",
      "metrics": {
        "likes": 12,
        "replies": 2
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 600,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/search/posts?q=fetchpi"

{
  "data": [
    {
      "id": "7410999000000000001",
      "platform": "tiktok",
      "type": "post",
      "author": {
        "id": "5566778899001",
        "username": "datafan",
        "display_name": "Data Fan",
        "verified": true
      },
      "text": "normalized entities for every feed!",
      "created_at": "2026-09-15T10:00:00Z",
      "metrics": {
        "likes": 91,
        "comments": 3,
        "shares": 12,
        "collects": 24,
        "views": 40320
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/s1.jpeg",
          "duration_ms": 21000
        }
      ],
      "fetched_at": "2026-09-18T09:05:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "live",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/posts/1842951234567890123/comments/9901222200001001/replies"

{
  "data": [
    {
      "id": "7411111111000000001",
      "platform": "tiktok",
      "type": "comment",
      "post_id": "7410886000000000001",
      "author": {
        "id": "3311223344",
        "username": "curiousfan",
        "display_name": "Curious Fan",
        "verified": false
      },
      "text": "This is the future of data APIs.",
      "created_at": "2026-09-17T13:00:00Z",
      "metrics": {
        "likes": 12,
        "replies": 2
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/users/newdev/followers"

{
  "data": [
    {
      "id": "7004994945112",
      "platform": "tiktok",
      "type": "profile",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "description": "Short videos about data APIs.",
      "url": "https://fetchpi.com",
      "profile_image_url": "https://cdn.example.com/avatar/creatordev.jpg",
      "verified": true,
      "is_private": false,
      "created_at": "2017-10-01T00:00:00Z",
      "metrics": {
        "followers": 88230,
        "following": 412,
        "posts": 356,
        "likes": 2140000
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/users/newdev/following"

{
  "data": [
    {
      "id": "7004994945112",
      "platform": "tiktok",
      "type": "profile",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "description": "Short videos about data APIs.",
      "url": "https://fetchpi.com",
      "profile_image_url": "https://cdn.example.com/avatar/creatordev.jpg",
      "verified": true,
      "is_private": false,
      "created_at": "2017-10-01T00:00:00Z",
      "metrics": {
        "followers": 88230,
        "following": 412,
        "posts": 356,
        "likes": 2140000
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/search/users?q=fetchpi"

{
  "query": "data api",
  "data": [
    {
      "id": "7004994945112",
      "platform": "tiktok",
      "type": "profile",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "description": "Short videos about data APIs.",
      "url": "https://fetchpi.com",
      "profile_image_url": "https://cdn.example.com/avatar/creatordev.jpg",
      "verified": true,
      "is_private": false,
      "created_at": "2017-10-01T00:00:00Z",
      "metrics": {
        "followers": 88230,
        "following": 412,
        "posts": 356,
        "likes": 2140000
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/hashtags/trending"

{
  "data": {
    "id": "1600000000000000001",
    "platform": "tiktok",
    "type": "hashtag",
    "name": "fetchpi",
    "description": "One API for every platform feed.",
    "cover_image_url": "https://p19-sign-sg.tiktokcdn.com/aweme/hashtag/fetchpi.jpeg",
    "metrics": {
      "views": 4820000000
    },
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/hashtags/trending/posts"

{
  "data": [
    {
      "id": "7410886000000000001",
      "platform": "tiktok",
      "type": "post",
      "author": {
        "id": "7004994945112",
        "username": "creatordev",
        "display_name": "Creator Dev",
        "verified": true
      },
      "text": "One API for every platform.",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 864,
        "comments": 42,
        "shares": 87,
        "collects": 310,
        "views": 154203
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/cover.jpeg",
          "duration_ms": 34567
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/musics/1842951234567890123"

{
  "data": {
    "id": "7416880000000000001",
    "platform": "tiktok",
    "type": "music",
    "title": "Sim Song (prod. Creator Dev)",
    "author_name": "Creator Dev",
    "duration_ms": 34567,
    "cover_image_url": "https://p16-sign-sg.tiktokcdn.com/aweme/music/7416880000000000001.jpeg",
    "metrics": {
      "videos": 128000
    },
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/live/1842951234567890123"

{
  "data": {
    "id": "8800000000000000001",
    "platform": "tiktok",
    "type": "live_room",
    "title": "Live: normalized entities Q&A",
    "username": "creatordev",
    "display_name": "Creator Dev",
    "status": "LIVE",
    "viewer_count": 2345,
    "started_at": "2026-09-20T00:00:00Z",
    "cover_image_url": "https://p19-sign-sg.tiktokcdn.com/aweme/live/8800000000000000001.jpeg",
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/search/live?q=fetchpi"

{
  "query": "data talk",
  "data": [
    {
      "id": "8800000000000000001",
      "platform": "tiktok",
      "type": "live_room",
      "title": "Live: normalized entities Q&A",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "status": "LIVE",
      "viewer_count": 2345,
      "started_at": "2026-09-20T00:00:00Z",
      "cover_image_url": "https://p19-sign-sg.tiktokcdn.com/aweme/live/8800000000000000001.jpeg",
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/homefeed"

{
  "data": [
    {
      "id": "7410886000000000001",
      "platform": "tiktok",
      "type": "post",
      "author": {
        "id": "7004994945112",
        "username": "creatordev",
        "display_name": "Creator Dev",
        "verified": true
      },
      "text": "One API for every platform.",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 864,
        "comments": 42,
        "shares": 87,
        "collects": 310,
        "views": 154203
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/cover.jpeg",
          "duration_ms": 34567
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/tiktok/download/1842951234567890123"

{
  "data": {
    "id": "7412050000000000001",
    "platform": "tiktok",
    "type": "download",
    "play_url": "https://v16-webapp.tiktok.com/aweme/v1/play/?video_id=7412050000000000001&no-watermark=1",
    "preview_image_url": "https://p19-sign-sg.tiktokcdn.com/aweme/cover/7412050000000000001.jpeg",
    "duration_ms": 34567,
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/users/newdev"

{
  "data": {
    "id": "1295448945",
    "platform": "instagram",
    "type": "profile",
    "username": "creatordev",
    "display_name": "Creator Dev",
    "description": "Photo dumps and API graphs.",
    "url": "https://fetchpi.com",
    "profile_image_url": "https://cdn.example.com/profile_pic/creatordev.jpg",
    "verified": true,
    "is_private": false,
    "created_at": null,
    "metrics": {
      "followers": 51230,
      "following": 310,
      "posts": 862
    },
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 120,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/users/newdev/posts"

{
  "data": [
    {
      "id": "CwxOne00001",
      "platform": "instagram",
      "type": "post",
      "author": {
        "id": "1295448945",
        "username": "creatordev",
        "display_name": "Creator Dev",
        "verified": true
      },
      "text": "Carousel dump",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 1204,
        "comments": 36,
        "views": 0
      },
      "attachments": [
        {
          "type": "photo",
          "url": "https://cdn.example.com/1.jpg"
        },
        {
          "type": "photo",
          "url": "https://cdn.example.com/2.jpg"
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    },
    {
      "id": "CwxTwo00002",
      "platform": "instagram",
      "type": "post",
      "author": {
        "id": "1295448945",
        "username": "creatordev",
        "display_name": "Creator Dev",
        "verified": true
      },
      "text": "Reel day",
      "created_at": "2026-09-16T08:00:00Z",
      "metrics": {
        "likes": 640,
        "comments": 21,
        "views": 60110
      },
      "attachments": [
        {
          "type": "video",
          "url": "https://cdn.example.com/reel2.mp4",
          "duration_ms": 30100
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": "QVFBQ2daOTItcGxhdGZvcm0",
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/posts/1842951234567890123"

{
  "data": {
    "id": "Creel00001",
    "platform": "instagram",
    "type": "post",
    "author": {
      "id": "1295448945",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "verified": true
    },
    "text": "Reel day",
    "created_at": "2026-09-17T12:34:56Z",
    "metrics": {
      "likes": 1204,
      "comments": 36,
      "views": 88231
    },
    "attachments": [
      {
        "type": "video",
        "url": "https://cdn.example.com/reel.mp4",
        "duration_ms": 32500
      }
    ],
    "fetched_at": "2026-09-18T07:30:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 3600,
      "source_layer": "cache",
      "stale": false
    },
    "billing": {
      "amount_credits": 0,
      "cache_hit": true
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/posts/1842951234567890123/comments"

{
  "data": [
    {
      "id": "17990000000000001",
      "platform": "instagram",
      "type": "comment",
      "post_id": "CwxOne00001",
      "author": {
        "id": "8811223344",
        "username": "curiousfan",
        "display_name": "Curious Fan",
        "verified": false
      },
      "text": "Clean normalized shape!",
      "created_at": "2026-09-17T13:00:00Z",
      "metrics": {
        "likes": 5
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 600,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/search/posts?q=fetchpi"

{
  "data": [
    {
      "id": "Creel00001",
      "platform": "instagram",
      "type": "post",
      "author": {
        "id": "5566778899001",
        "username": "datafan",
        "display_name": "Data Fan",
        "verified": true
      },
      "text": "search hit one",
      "created_at": "2026-09-15T10:00:00Z",
      "metrics": {
        "likes": 341,
        "comments": 12,
        "views": 88231
      },
      "attachments": [
        {
          "type": "video",
          "url": "https://cdn.example.com/reel1.mp4",
          "duration_ms": 32500
        }
      ],
      "fetched_at": "2026-09-18T09:05:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "live",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/posts/1842951234567890123/comments/9901222200001001/replies"

{
  "data": [
    {
      "id": "17990000000000001",
      "platform": "instagram",
      "type": "comment",
      "post_id": "CwxOne00001",
      "author": {
        "id": "8811223344",
        "username": "curiousfan",
        "display_name": "Curious Fan",
        "verified": false
      },
      "text": "Clean normalized shape!",
      "created_at": "2026-09-17T13:00:00Z",
      "metrics": {
        "likes": 5
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/users/newdev/followers"

{
  "data": [
    {
      "id": "1295448945",
      "platform": "instagram",
      "type": "profile",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "description": "Photo dumps and API graphs.",
      "url": "https://fetchpi.com",
      "profile_image_url": "https://cdn.example.com/profile_pic/creatordev.jpg",
      "verified": true,
      "is_private": false,
      "created_at": null,
      "metrics": {
        "followers": 51230,
        "following": 310,
        "posts": 862
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/users/newdev/following"

{
  "data": [
    {
      "id": "1295448945",
      "platform": "instagram",
      "type": "profile",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "description": "Photo dumps and API graphs.",
      "url": "https://fetchpi.com",
      "profile_image_url": "https://cdn.example.com/profile_pic/creatordev.jpg",
      "verified": true,
      "is_private": false,
      "created_at": null,
      "metrics": {
        "followers": 51230,
        "following": 310,
        "posts": 862
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/search/users?q=fetchpi"

{
  "query": "data api",
  "data": [
    {
      "id": "1295448945",
      "platform": "instagram",
      "type": "profile",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "description": "Photo dumps and API graphs.",
      "url": "https://fetchpi.com",
      "profile_image_url": "https://cdn.example.com/profile_pic/creatordev.jpg",
      "verified": true,
      "is_private": false,
      "created_at": null,
      "metrics": {
        "followers": 51230,
        "following": 310,
        "posts": 862
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/users/newdev/stories"

{
  "data": [
    {
      "id": "CwxOne00001",
      "platform": "instagram",
      "type": "post",
      "author": {
        "id": "1295448945",
        "username": "creatordev",
        "display_name": "Creator Dev",
        "verified": true
      },
      "text": "Carousel dump #1",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 1204,
        "comments": 36,
        "views": 0
      },
      "attachments": [
        {
          "type": "photo",
          "url": "https://cdn.example.com/1.jpg"
        },
        {
          "type": "photo",
          "url": "https://cdn.example.com/2.jpg"
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/users/newdev/highlights"

{
  "data": [
    {
      "id": "highlight_launch",
      "platform": "instagram",
      "type": "highlight",
      "title": "Launch Week",
      "username": "creatordev",
      "cover_image_url": "https://scontent.cdninstagram.com/hl-launch.jpg",
      "media_count": 3,
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/ig/posts/1842951234567890123/likers"

{
  "data": [
    {
      "id": "1295448945",
      "platform": "instagram",
      "type": "profile",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "description": "Photo dumps and API graphs.",
      "url": "https://fetchpi.com",
      "profile_image_url": "https://cdn.example.com/profile_pic/creatordev.jpg",
      "verified": true,
      "is_private": false,
      "created_at": null,
      "metrics": {
        "followers": 51230,
        "following": 310,
        "posts": 862
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/xhs/users/newdev"

{
  "data": {
    "id": "66f2a1de000000001e0167a1",
    "platform": "xiaohongshu",
    "type": "profile",
    "username": "creatordev",
    "display_name": "Creator Dev",
    "description": "Notes about data APIs.",
    "profile_image_url": "https://cdn.example.com/avatar/creatordev.jpg",
    "verified": true,
    "created_at": null,
    "metrics": {
      "followers": 51230,
      "following": 310,
      "posts": 862,
      "likes": 2140000
    },
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 120,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/xhs/users/newdev/posts"

{
  "data": [
    {
      "id": "66f2b1de000000001f0167a1",
      "platform": "xiaohongshu",
      "type": "post",
      "author": null,
      "title": "First note on the platform.",
      "text": null,
      "created_at": null,
      "metrics": {
        "likes": 512,
        "collects": 0,
        "comments": 0,
        "shares": 0
      },
      "attachments": [
        {
          "type": "photo",
          "url": "https://cdn.example.com/n1-cover.jpg"
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    },
    {
      "id": "66f2b1de000000001f0167a2",
      "platform": "xiaohongshu",
      "type": "post",
      "author": null,
      "title": "Freshness modes, explained in 30s.",
      "text": null,
      "created_at": null,
      "metrics": {
        "likes": 512,
        "collects": 0,
        "comments": 0,
        "shares": 0
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/n2-cover.jpg"
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": "eyJ2IjoxLCJzcmMiOiJ4dGhpcmQiLCJwb3MiOiI2NmYyYjFkZTAwIn0",
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/xhs/posts/1842951234567890123"

{
  "data": {
    "id": "66f2b1de000000001f0167a1",
    "platform": "xiaohongshu",
    "type": "post",
    "author": {
      "id": "66f2a1de000000001e0167a1",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "verified": true
    },
    "title": "One API for every feed.",
    "text": "One API for every platform.",
    "created_at": "2026-09-17T12:34:56Z",
    "metrics": {
      "likes": 1204,
      "collects": 310,
      "comments": 42,
      "shares": 87
    },
    "attachments": [
      {
        "type": "video",
        "url": "https://cdn.example.com/note.mp4",
        "preview_image_url": "https://cdn.example.com/note-cover.jpg"
      }
    ],
    "fetched_at": "2026-09-18T07:30:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 3600,
      "source_layer": "cache",
      "stale": false
    },
    "billing": {
      "amount_credits": 0,
      "cache_hit": true
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/xhs/posts/1842951234567890123/comments"

{
  "data": [
    {
      "id": "66f3a1de000000001f0267c1",
      "platform": "xiaohongshu",
      "type": "comment",
      "post_id": "66f2b1de000000001f0167a1",
      "author": {
        "id": "66f1a1de000000001f0167d1",
        "username": "curiousfan",
        "display_name": "Curious Fan",
        "verified": false
      },
      "text": "This is the future of data APIs.",
      "created_at": "2026-09-17T13:06:40Z",
      "metrics": {
        "likes": 12,
        "replies": 2
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 600,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/xhs/search/posts?q=fetchpi"

{
  "data": [
    {
      "id": "66f2c1de000000001f0167b1",
      "platform": "xiaohongshu",
      "type": "post",
      "author": null,
      "title": "search hit one",
      "text": null,
      "created_at": null,
      "metrics": {
        "likes": 512,
        "collects": 0,
        "comments": 0,
        "shares": 0
      },
      "attachments": [
        {
          "type": "photo",
          "url": "https://cdn.example.com/s1-cover.jpg"
        }
      ],
      "fetched_at": "2026-09-18T09:05:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "live",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/xhs/posts/1842951234567890123/comments/9901222200001001/replies"

{
  "data": [
    {
      "id": "66f3a1de000000001f0267c1",
      "platform": "xiaohongshu",
      "type": "comment",
      "post_id": "66f2b1de000000001f0167a1",
      "author": {
        "id": "66f1a1de000000001f0167d1",
        "username": "curiousfan",
        "display_name": "Curious Fan",
        "verified": false
      },
      "text": "This is the future of data APIs.",
      "created_at": "2026-09-17T13:06:40Z",
      "metrics": {
        "likes": 12,
        "replies": 2
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/xhs/search/users?q=fetchpi"

{
  "query": "data api",
  "data": [
    {
      "id": "66f2a1de000000001e0167a1",
      "platform": "xiaohongshu",
      "type": "profile",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "description": "Notes about data APIs.",
      "profile_image_url": "https://cdn.example.com/avatar/creatordev.jpg",
      "verified": true,
      "created_at": null,
      "metrics": {
        "followers": 51230,
        "following": 310,
        "posts": 862,
        "likes": 2140000
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/xhs/homefeed"

{
  "data": [
    {
      "id": "66f2b1de000000001f0167a1",
      "platform": "xiaohongshu",
      "type": "post",
      "author": {
        "id": "66f2a1de000000001e0167a1",
        "username": "creatordev",
        "display_name": "Creator Dev",
        "verified": true
      },
      "title": "One API for every feed.",
      "text": "One API for every platform.",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 1204,
        "collects": 310,
        "comments": 42,
        "shares": 87
      },
      "attachments": [
        {
          "type": "video",
          "url": "https://cdn.example.com/note.mp4",
          "preview_image_url": "https://cdn.example.com/note-cover.jpg"
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/youtube/users/newdev"

{
  "data": {
    "id": "UCsim0000000000000000777",
    "platform": "youtube",
    "type": "profile",
    "username": "creatordev",
    "display_name": "Creator Dev",
    "description": "Videos about data APIs.",
    "url": "https://www.youtube.com/@creatordev",
    "profile_image_url": "https://cdn.example.com/avatar/creatordev.jpg",
    "verified": true,
    "created_at": "2019-04-01T10:15:00Z",
    "metrics": {
      "subscribers": 51230,
      "views": 19824567,
      "posts": 862
    },
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 120,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/youtube/users/newdev/posts"

{
  "data": [
    {
      "id": "wSimVideo0001",
      "platform": "youtube",
      "type": "post",
      "author": null,
      "title": "First video on the platform.",
      "text": null,
      "created_at": "2026-09-16T08:00:00Z",
      "metrics": {
        "views": 0,
        "likes": 0,
        "comments": 0
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/t1.jpg",
          "duration_ms": 30000
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    },
    {
      "id": "wSimVideo0002",
      "platform": "youtube",
      "type": "post",
      "author": null,
      "title": "Freshness modes, explained in 30s.",
      "text": null,
      "created_at": "2026-09-15T08:00:00Z",
      "metrics": {
        "views": 52100,
        "likes": 0,
        "comments": 0
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/t2.jpg",
          "duration_ms": 30000
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": "eyJ2IjoxLCJzcmMiOiJ4dGhpcmQiLCJwb3MiOiJDQlFTRCJ9",
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/youtube/posts/1842951234567890123"

{
  "data": {
    "id": "wSimVideo0001",
    "platform": "youtube",
    "type": "post",
    "author": {
      "id": "UCsim0000000000000000777",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "verified": true
    },
    "title": "One API for every platform.",
    "text": "One API for every platform.",
    "created_at": "2026-09-17T12:34:56Z",
    "metrics": {
      "views": 154203,
      "likes": 864,
      "comments": 42
    },
    "attachments": [
      {
        "type": "video",
        "preview_image_url": "https://cdn.example.com/thumb.jpg",
        "duration_ms": 212000
      }
    ],
    "fetched_at": "2026-09-18T07:30:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 3600,
      "source_layer": "cache",
      "stale": false
    },
    "billing": {
      "amount_credits": 0,
      "cache_hit": true
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/youtube/posts/1842951234567890123/comments"

{
  "data": [
    {
      "id": "UgxSim000000000001",
      "platform": "youtube",
      "type": "comment",
      "post_id": "wSimVideo0001",
      "author": {
        "id": "UCsimfan000000000001",
        "username": "curiousfan",
        "display_name": "Curious Fan",
        "verified": false
      },
      "text": "This is the future of data APIs.",
      "created_at": "2026-09-17T13:00:00Z",
      "metrics": {
        "likes": 12,
        "replies": 2
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 600,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/youtube/search/posts?q=fetchpi"

{
  "data": [
    {
      "id": "sSimVideo001",
      "platform": "youtube",
      "type": "post",
      "author": {
        "id": "UCsimsearch00000000001",
        "username": "datafan",
        "display_name": "Data Fan",
        "verified": false
      },
      "title": "normalized entities for every feed!",
      "text": null,
      "created_at": null,
      "metrics": {
        "views": 0,
        "likes": 0,
        "comments": 0
      },
      "attachments": [],
      "fetched_at": "2026-09-18T09:05:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "live",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/youtube/search/users?q=fetchpi"

{
  "query": "data api",
  "data": [
    {
      "id": "UCsim0000000000000000777",
      "platform": "youtube",
      "type": "profile",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "description": "Videos about data APIs.",
      "url": "https://www.youtube.com/@creatordev",
      "profile_image_url": "https://cdn.example.com/avatar/creatordev.jpg",
      "verified": true,
      "created_at": "2019-04-01T10:15:00Z",
      "metrics": {
        "subscribers": 51230,
        "views": 19824567,
        "posts": 862
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/reddit/users/newdev"

{
  "data": {
    "id": "1a2b3c",
    "platform": "reddit",
    "type": "profile",
    "username": "creatordev",
    "display_name": "Creator Dev",
    "description": "Posts about data APIs.",
    "profile_image_url": "https://cdn.example.com/avatar/creatordev.png",
    "verified": true,
    "created_at": "2019-04-01T08:15:00Z",
    "metrics": {
      "karma_posts": 8620,
      "karma_comments": 15300,
      "total_karma": 24100,
      "followers": 4811
    },
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 120,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/reddit/users/newdev/posts"

{
  "data": [
    {
      "id": "1simpost01",
      "platform": "reddit",
      "type": "post",
      "author": {
        "id": "7004994945",
        "username": "creatordev",
        "display_name": null,
        "verified": false
      },
      "title": "First post on the platform.",
      "text": "One API for every platform.",
      "url": "https://www.reddit.com/r/dataapi/comments/1simpost01/",
      "created_at": "2026-09-16T19:23:20Z",
      "metrics": {
        "upvotes": 864,
        "downvotes": 12,
        "comments": 42
      },
      "attachments": [],
      "fetched_at": "2026-09-18T09:00:00Z"
    },
    {
      "id": "1simpost02",
      "platform": "reddit",
      "type": "post",
      "author": {
        "id": "7004994945",
        "username": "creatordev",
        "display_name": null,
        "verified": false
      },
      "title": "Freshness modes, explained.",
      "text": "One API for every platform.",
      "url": "https://www.reddit.com/r/dataapi/comments/1simpost02/",
      "created_at": "2026-09-16T08:00:00Z",
      "metrics": {
        "upvotes": 412,
        "downvotes": 9,
        "comments": 18
      },
      "attachments": [
        {
          "type": "photo",
          "url": "https://cdn.example.com/p1-full.jpg",
          "preview_image_url": "https://cdn.example.com/p1.jpg"
        },
        {
          "type": "video",
          "url": "https://cdn.example.com/p2.mp4",
          "preview_image_url": "https://cdn.example.com/p2.jpg"
        }
      ],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": "eyJ2IjoxLCJzcmMiOiJ4dGhpcmQiLCJwb3MiOiJ0M19zaW0ifQ",
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/reddit/posts/1842951234567890123"

{
  "data": {
    "id": "1simpost01",
    "platform": "reddit",
    "type": "post",
    "author": {
      "id": "7004994945",
      "username": "creatordev",
      "display_name": null,
      "verified": false
    },
    "title": "One API for every platform.",
    "text": "One API for every platform.",
    "url": "https://www.reddit.com/r/dataapi/comments/1simpost01/",
    "created_at": "2026-09-17T12:34:56Z",
    "metrics": {
      "upvotes": 864,
      "downvotes": 12,
      "comments": 42
    },
    "attachments": [],
    "fetched_at": "2026-09-18T07:30:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 3600,
      "source_layer": "cache",
      "stale": false
    },
    "billing": {
      "amount_credits": 0,
      "cache_hit": true
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/reddit/posts/1842951234567890123/comments"

{
  "data": [
    {
      "id": "simcomment1",
      "platform": "reddit",
      "type": "comment",
      "post_id": "1simpost01",
      "author": {
        "id": "fan0000001",
        "username": "curiousfan",
        "display_name": null,
        "verified": false
      },
      "text": "This is the future of data APIs.",
      "created_at": "2026-09-17T13:06:40Z",
      "metrics": {
        "upvotes": 12,
        "downvotes": 1
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 600,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/reddit/search/posts?q=fetchpi"

{
  "data": [
    {
      "id": "1simsear01",
      "platform": "reddit",
      "type": "post",
      "author": {
        "id": "5566778899",
        "username": "datafan",
        "display_name": null,
        "verified": false
      },
      "title": "normalized entities for every feed!",
      "text": "One API for every platform.",
      "url": "https://www.reddit.com/r/dataapi/comments/1simsear01/",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "upvotes": 91,
        "downvotes": 2,
        "comments": 3
      },
      "attachments": [],
      "fetched_at": "2026-09-18T09:05:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "live",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/reddit/search/users?q=fetchpi"

{
  "query": "data api",
  "data": [
    {
      "id": "1a2b3c",
      "platform": "reddit",
      "type": "profile",
      "username": "creatordev",
      "display_name": "Creator Dev",
      "description": "Posts about data APIs.",
      "profile_image_url": "https://cdn.example.com/avatar/creatordev.png",
      "verified": true,
      "created_at": "2019-04-01T08:15:00Z",
      "metrics": {
        "karma_posts": 8620,
        "karma_comments": 15300,
        "total_karma": 24100,
        "followers": 4811
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/reddit/subreddits/technology/posts"

{
  "data": [
    {
      "id": "1simpost01",
      "platform": "reddit",
      "type": "post",
      "author": {
        "id": "7004994945",
        "username": "creatordev",
        "display_name": null,
        "verified": false
      },
      "title": "One API for every platform.",
      "text": "One API for every platform.",
      "url": "https://www.reddit.com/r/dataapi/comments/1simpost01/",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "upvotes": 864,
        "downvotes": 12,
        "comments": 42
      },
      "attachments": [],
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/reddit/users/newdev/comments"

{
  "data": [
    {
      "id": "simcomment1",
      "platform": "reddit",
      "type": "comment",
      "post_id": "1simpost01",
      "author": {
        "id": "fan0000001",
        "username": "curiousfan",
        "display_name": null,
        "verified": false
      },
      "text": "This is the future of data APIs.",
      "created_at": "2026-09-17T13:06:40Z",
      "metrics": {
        "upvotes": 12,
        "downvotes": 1
      },
      "fetched_at": "2026-09-18T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/users/newdev"

{
  "data": {
    "id": "7004994945113",
    "platform": "douyin",
    "type": "profile",
    "username": "fetchpi_dev",
    "display_name": "FetchPI 抖音站",
    "description": "短视频形式的数据 API 教程。",
    "url": "https://fetchpi.com",
    "profile_image_url": "https://cdn.example.com/avatar/douyin-fetchpi.jpg",
    "verified": true,
    "created_at": "2019-06-01T00:00:00Z",
    "metrics": {
      "followers": 1288000,
      "following": 88,
      "posts": 412,
      "likes": 18600000
    },
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/posts/1842951234567890123"

{
  "data": {
    "id": "7412050000000001001",
    "platform": "douyin",
    "type": "post",
    "author": {
      "id": "7004994945113",
      "username": "fetchpi_dev",
      "display_name": "FetchPI 抖音站",
      "verified": true
    },
    "text": "一条关于数据 API 的短视频。",
    "created_at": "2026-09-17T12:34:56Z",
    "metrics": {
      "likes": 32810,
      "comments": 1204,
      "shares": 988,
      "collects": 5600,
      "views": 2140000
    },
    "attachments": [
      {
        "type": "video",
        "preview_image_url": "https://cdn.example.com/cover/douyin-7412050000000001001.jpeg",
        "duration_ms": 45678
      }
    ],
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/users/newdev/posts"

{
  "data": [
    {
      "id": "7412050000000001001",
      "platform": "douyin",
      "type": "post",
      "author": {
        "id": "7004994945113",
        "username": "fetchpi_dev",
        "display_name": "FetchPI 抖音站",
        "verified": true
      },
      "text": "一条关于数据 API 的短视频。",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 32810,
        "comments": 1204,
        "shares": 988,
        "collects": 5600,
        "views": 2140000
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/cover/douyin-7412050000000001001.jpeg",
          "duration_ms": 45678
        }
      ],
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/posts/1842951234567890123/comments"

{
  "data": [
    {
      "id": "7411222200000001001",
      "platform": "douyin",
      "type": "comment",
      "post_id": "7412050000000001001",
      "author": {
        "id": "7004994945114",
        "username": "commentfan",
        "display_name": "评论粉丝",
        "verified": false
      },
      "text": "讲得清楚，赞。",
      "created_at": "2026-09-17T13:01:22Z",
      "metrics": {
        "likes": 823,
        "replies": 12
      },
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/posts/1842951234567890123/comments/9901222200001001/replies"

{
  "data": [
    {
      "id": "7411222200000001001",
      "platform": "douyin",
      "type": "comment",
      "post_id": "7412050000000001001",
      "author": {
        "id": "7004994945114",
        "username": "commentfan",
        "display_name": "评论粉丝",
        "verified": false
      },
      "text": "讲得清楚，赞。",
      "created_at": "2026-09-17T13:01:22Z",
      "metrics": {
        "likes": 823,
        "replies": 12
      },
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/users/newdev/followers"

{
  "data": [
    {
      "id": "7004994945113",
      "platform": "douyin",
      "type": "profile",
      "username": "fetchpi_dev",
      "display_name": "FetchPI 抖音站",
      "description": "短视频形式的数据 API 教程。",
      "url": "https://fetchpi.com",
      "profile_image_url": "https://cdn.example.com/avatar/douyin-fetchpi.jpg",
      "verified": true,
      "created_at": "2019-06-01T00:00:00Z",
      "metrics": {
        "followers": 1288000,
        "following": 88,
        "posts": 412,
        "likes": 18600000
      },
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/users/newdev/following"

{
  "data": [
    {
      "id": "7004994945113",
      "platform": "douyin",
      "type": "profile",
      "username": "fetchpi_dev",
      "display_name": "FetchPI 抖音站",
      "description": "短视频形式的数据 API 教程。",
      "url": "https://fetchpi.com",
      "profile_image_url": "https://cdn.example.com/avatar/douyin-fetchpi.jpg",
      "verified": true,
      "created_at": "2019-06-01T00:00:00Z",
      "metrics": {
        "followers": 1288000,
        "following": 88,
        "posts": 412,
        "likes": 18600000
      },
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/hashtags/trending"

{
  "data": {
    "id": "1655000000000001001",
    "platform": "douyin",
    "type": "hashtag",
    "name": "数据API",
    "description": "话题详情（按上游 ch_id 寻址）。",
    "cover_image_url": "https://cdn.example.com/cover/douyin-hashtag.jpeg",
    "metrics": {
      "views": 960000000,
      "posts": 128000
    },
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/hashtags/trending/posts"

{
  "data": [
    {
      "id": "7412050000000001001",
      "platform": "douyin",
      "type": "post",
      "author": {
        "id": "7004994945113",
        "username": "fetchpi_dev",
        "display_name": "FetchPI 抖音站",
        "verified": true
      },
      "text": "一条关于数据 API 的短视频。",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 32810,
        "comments": 1204,
        "shares": 988,
        "collects": 5600,
        "views": 2140000
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/cover/douyin-7412050000000001001.jpeg",
          "duration_ms": 45678
        }
      ],
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/musics/1842951234567890123"

{
  "data": {
    "id": "7416880000000001001",
    "platform": "douyin",
    "type": "music",
    "title": "原创音源（数据 API 主题曲）",
    "author_name": "数据工场",
    "duration_ms": 45678,
    "cover_image_url": "https://cdn.example.com/cover/douyin-music.jpeg",
    "metrics": {
      "videos": 128000
    },
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/musics/1842951234567890123/posts"

{
  "data": [
    {
      "id": "7412050000000001001",
      "platform": "douyin",
      "type": "post",
      "author": {
        "id": "7004994945113",
        "username": "fetchpi_dev",
        "display_name": "FetchPI 抖音站",
        "verified": true
      },
      "text": "一条关于数据 API 的短视频。",
      "created_at": "2026-09-17T12:34:56Z",
      "metrics": {
        "likes": 32810,
        "comments": 1204,
        "shares": 988,
        "collects": 5600,
        "views": 2140000
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/cover/douyin-7412050000000001001.jpeg",
          "duration_ms": 45678
        }
      ],
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/live/1842951234567890123"

{
  "data": {
    "id": "8800000000000001001",
    "platform": "douyin",
    "type": "live_room",
    "title": "直播：数据 API 问答",
    "username": "fetchpi_dev",
    "display_name": "FetchPI 抖音站",
    "status": "LIVE",
    "viewer_count": 3456,
    "started_at": "2026-09-21T08:00:00Z",
    "cover_image_url": "https://cdn.example.com/cover/douyin-live.jpeg",
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/hot-search"

{
  "data": {
    "platform": "douyin",
    "type": "hot_search",
    "words": [
      {
        "word": "数据开放",
        "hot_value": 4821000
      },
      {
        "word": "实体层",
        "hot_value": 3120004
      }
    ],
    "updated_at": "2026-09-21T08:00:00Z",
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/douyin/download/1842951234567890123"

{
  "data": {
    "id": "7412050000000001001",
    "platform": "douyin",
    "type": "download",
    "play_url": "https://v.douyincdn.com/aweme/7412050000000001001/play.mp4?no-watermark=1",
    "preview_image_url": "https://cdn.example.com/cover/douyin-7412050000000001001.jpeg",
    "duration_ms": 45678,
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/kuaishou/users/newdev"

{
  "data": {
    "id": "3185500122",
    "platform": "kuaishou",
    "type": "profile",
    "username": "fetchpi_ks",
    "display_name": "FetchPI 快手号",
    "description": "快手短视频与数据开放。",
    "url": "https://fetchpi.com",
    "profile_image_url": "https://cdn.example.com/avatar/kuaishou-fetchpi.jpg",
    "verified": false,
    "created_at": "2018-03-15T00:00:00Z",
    "metrics": {
      "followers": 156000,
      "following": 210,
      "posts": 389,
      "likes": 2100000
    },
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/kuaishou/posts/1842951234567890123"

{
  "data": {
    "id": "5566778899001",
    "platform": "kuaishou",
    "type": "post",
    "author": {
      "id": "3185500122",
      "username": "fetchpi_ks",
      "display_name": "FetchPI 快手号",
      "verified": false
    },
    "text": "快手短视频数据示例。",
    "created_at": "2026-09-16T10:00:00Z",
    "metrics": {
      "likes": 8642,
      "comments": 512,
      "shares": 87,
      "views": 154000
    },
    "attachments": [
      {
        "type": "video",
        "preview_image_url": "https://cdn.example.com/cover/kuaishou-5566778899001.jpeg",
        "duration_ms": 38400
      }
    ],
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/kuaishou/users/newdev/posts"

{
  "data": [
    {
      "id": "5566778899001",
      "platform": "kuaishou",
      "type": "post",
      "author": {
        "id": "3185500122",
        "username": "fetchpi_ks",
        "display_name": "FetchPI 快手号",
        "verified": false
      },
      "text": "快手短视频数据示例。",
      "created_at": "2026-09-16T10:00:00Z",
      "metrics": {
        "likes": 8642,
        "comments": 512,
        "shares": 87,
        "views": 154000
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/cover/kuaishou-5566778899001.jpeg",
          "duration_ms": 38400
        }
      ],
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/kuaishou/posts/1842951234567890123/comments"

{
  "data": [
    {
      "id": "7700112233445",
      "platform": "kuaishou",
      "type": "comment",
      "post_id": "5566778899001",
      "author": {
        "id": "4400112233445",
        "username": "ksfan001",
        "display_name": "快手网友",
        "verified": false
      },
      "text": "这个讲解很实用。",
      "created_at": "2026-09-16T10:20:00Z",
      "metrics": {
        "likes": 96,
        "replies": 3
      },
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/kuaishou/search/posts?q=fetchpi"

{
  "data": [
    {
      "id": "5566778899001",
      "platform": "kuaishou",
      "type": "post",
      "author": {
        "id": "3185500122",
        "username": "fetchpi_ks",
        "display_name": "FetchPI 快手号",
        "verified": false
      },
      "text": "快手短视频数据示例。",
      "created_at": "2026-09-16T10:00:00Z",
      "metrics": {
        "likes": 8642,
        "comments": 512,
        "shares": 87,
        "views": 154000
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/cover/kuaishou-5566778899001.jpeg",
          "duration_ms": 38400
        }
      ],
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "query": "数据",
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/kuaishou/posts/1842951234567890123/comments/9901222200001001/replies"

{
  "data": [
    {
      "id": "7700112233445",
      "platform": "kuaishou",
      "type": "comment",
      "post_id": "5566778899001",
      "author": {
        "id": "4400112233445",
        "username": "ksfan001",
        "display_name": "快手网友",
        "verified": false
      },
      "text": "这个讲解很实用。",
      "created_at": "2026-09-16T10:20:00Z",
      "metrics": {
        "likes": 96,
        "replies": 3
      },
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/kuaishou/search/users?q=fetchpi"

{
  "data": [
    {
      "id": "3185500122",
      "platform": "kuaishou",
      "type": "profile",
      "username": "fetchpi_ks",
      "display_name": "FetchPI 快手号",
      "description": "快手短视频与数据开放。",
      "url": "https://fetchpi.com",
      "profile_image_url": "https://cdn.example.com/avatar/kuaishou-fetchpi.jpg",
      "verified": false,
      "created_at": "2018-03-15T00:00:00Z",
      "metrics": {
        "followers": 156000,
        "following": 210,
        "posts": 389,
        "likes": 2100000
      },
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "query": "数据",
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 300,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/kuaishou/hashtags/trending/posts"

{
  "data": [
    {
      "id": "5566778899001",
      "platform": "kuaishou",
      "type": "post",
      "author": {
        "id": "3185500122",
        "username": "fetchpi_ks",
        "display_name": "FetchPI 快手号",
        "verified": false
      },
      "text": "快手短视频数据示例。",
      "created_at": "2026-09-16T10:00:00Z",
      "metrics": {
        "likes": 8642,
        "comments": 512,
        "shares": 87,
        "views": 154000
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/cover/kuaishou-5566778899001.jpeg",
          "duration_ms": 38400
        }
      ],
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/kuaishou/users/newdev/live"

{
  "data": {
    "id": "8810000000000001001",
    "platform": "kuaishou",
    "type": "live_room",
    "title": "快手直播：数据开放夜",
    "username": "fetchpi_ks",
    "display_name": "FetchPI 快手号",
    "status": "LIVE",
    "viewer_count": 1234,
    "started_at": "2026-09-21T07:30:00Z",
    "cover_image_url": "https://cdn.example.com/cover/kuaishou-live.jpeg",
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/xigua/users/newdev"

{
  "data": {
    "id": "7004994945115",
    "platform": "xigua",
    "type": "profile",
    "username": "fetchpi_xigua",
    "display_name": "FetchPI 西瓜号",
    "description": "中视频数据 API 演示。",
    "url": "https://fetchpi.com",
    "profile_image_url": "https://cdn.example.com/avatar/xigua-fetchpi.jpg",
    "verified": false,
    "created_at": "2020-01-10T00:00:00Z",
    "metrics": {
      "followers": 86500,
      "following": 35,
      "posts": 128,
      "likes": 940000
    },
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/xigua/posts/1842951234567890123"

{
  "data": {
    "id": "7413050000000001001",
    "platform": "xigua",
    "type": "post",
    "author": {
      "id": "7004994945115",
      "username": "fetchpi_xigua",
      "display_name": "FetchPI 西瓜号",
      "verified": false
    },
    "title": "西瓜视频：一条中视频",
    "text": "中视频格式的数据 API 演示。",
    "created_at": "2026-09-15T08:30:00Z",
    "metrics": {
      "likes": 5120,
      "comments": 320,
      "shares": 140,
      "views": 880000
    },
    "attachments": [
      {
        "type": "video",
        "preview_image_url": "https://cdn.example.com/cover/xigua-7413050000000001001.jpeg",
        "duration_ms": 732000
      }
    ],
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
  "https://fetchpi.com/v1/xigua/users/newdev/posts"

{
  "data": [
    {
      "id": "7413050000000001001",
      "platform": "xigua",
      "type": "post",
      "author": {
        "id": "7004994945115",
        "username": "fetchpi_xigua",
        "display_name": "FetchPI 西瓜号",
        "verified": false
      },
      "title": "西瓜视频：一条中视频",
      "text": "中视频格式的数据 API 演示。",
      "created_at": "2026-09-15T08:30:00Z",
      "metrics": {
        "likes": 5120,
        "comments": 320,
        "shares": 140,
        "views": 880000
      },
      "attachments": [
        {
          "type": "video",
          "preview_image_url": "https://cdn.example.com/cover/xigua-7413050000000001001.jpeg",
          "duration_ms": 732000
        }
      ],
      "fetched_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 200,
      "cache_hit": false
    }
  }
}