Facebook

Posts / Reels

per_call

Paginated feed of a Page's posts and Reels, including message text, attached photos or video URLs, link previews, reaction breakdown, comment and share counts and publish timestamps. Use it for competitive content tracking and engagement benchmarking.

What you get

Each call returns up to 3 posts, plus a cursor for the next 3.

Endpoint

GET /v1/facebook/posts-reels

Price

$1.50

per 1,000 calls · $0.0015 per call

Cost per call

1 credit

Failed calls never charged

Parameters

target

required

string

The Facebook profile or page — a bare username (`asif2bd`), `facebook.com/asif2bd`, or the full URL. Case does not matter.

limit

optional

integer

Maximum records to return, capped at this service's page size (see Limits below). Omit it to receive the whole page. It shapes the response, not the price — a call costs the same either way.

cursor

optional

string

Pagination cursor returned by a previous response.

fresh

optional

enum

Bypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.

One of: true, 1, false, 0

Example request

Live call. Successful calls are charged; failed and empty results are not.

curl

curl "https://fastfetchz.com/v1/facebook/posts-reels?target=asif2bd" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json

{
  "success": true,
  "service": {
    "platform": "Facebook",
    "name": "Posts / Reels",
    "slug": "posts-reels"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "posts": [
      {
        "id": "1624398375722199",
        "text": "Hey, neighbor\n\nDid you know our home galaxy — the Milky Way — has smaller galaxies that orbit around it? The biggest one, called the Large Magellanic Cloud, is \"only\" 160,000 light-years away. It's known for giving astronomers great views of newly-forming stars, like in the nebula seen here.\n\nThe bubble in this image, as shown by NASA's Hubble Space Telescope, was created by the stars in the cente…",
        "url": "https://www.facebook.com/NASA/posts/pfbid0hSgbekvXSQGQJDibHXr71B5kharJ9NzXMX2oJB9RNbd5D8G89f5is2fGdifj4sv3l",
        "author": {
          "__typename": "User",
          "name": "NASA - National Aeronautics and Space Administration",
          "short_name": "NASA - National Aeronautics and Space Administration",
          "id": "100044561550831"
        },
        "videoDetails": {},
        "image": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.30808-6/801056421_1624398362388867_8412775479356659921_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=127cfc&_nc_ohc=XXAabiZrVjAQ7kNvwHtW2dM&_nc_oc=Adqv0H_v6J1JoB6XMGqprtubQMi8W89MbxB4I0MmxmdhNmwweg6PLYuWKAdH1ar28LA&_nc_zt=23&_nc_ht=scontent-phl2-1.xx&_nc_gid=13mjGWrFrR-Bg8HoZDv0EA&_nc_ss=7f289&oh=00_AQLYfkWrR4Fr_gZFoJ8lK8pB8v-e7aQjYRG_uUjrRA2gqw&oe=6AA621F0",
        "reactionCount": 1629,
        "reaction_counts": {
          "thankful": 0,
          "like": 1091,
          "love": 468,
          "care": 31,
          "haha": 2,
          "wow": 36,
          "sad": 1,
          "anger": 0,
          "pride": 0,
          "confused": 0
        },
        "commentCount": 45,
        "videoViewCount": null,
        "publishTime": 1788884863,
        "creation_time": "2026-09-08T16:27:43.000Z",
        "topComments": [
          {
            "id": "Y29tbWVudDoxNjI0Mzk4Mzc1NzIyMTk5XzE2MDAwMTQ2ODUwMzUyMTA=",
            "text": "Looks like a a Ghost  perfect for Halloween",
            "publishTime": 1788895407,
            "author": {
              "id": "pfbid02h8E4VHUT7a7tje34eX84r4gA2AW11gzbcbFiaJ6dZgvD9A1GijNyxNn77XQgGsGAl",
              "name": "Odalis Euceda",
              "gender": "FEMALE",
              "url": "https://www.facebook.com/odalis.euceda"
            }
          }
        ]
      },
      {
        "id": "1620874212741282",
        "text": "AvGeeks, assemble!\n\nMAX POWER, America’s newest and most exciting aerospace technology expo and air show, is touching down in Florida on Nov. 7–8.\n\nJUST CONFIRMED: The MAX POWER Salute to America Air Show will feature an F‑104 flyover by the Starfighters, and NASA’s ER‑2 will be on static display.\n\nLearn how to secure your spot on the flightline: www.nasa.gov/maxpower",
        "url": "https://www.facebook.com/reel/28631238109803230/",
        "permalink": "https://www.facebook.com/reel/28631238109803230/",
        "author": {
          "__typename": "User",
          "name": "NASA - National Aeronautics and Space Administration",
          "short_name": "NASA - National Aeronautics and Space Administration",
          "id": "100044561550831"
        },
        "reactionCount": 950,
        "reaction_counts": {
          "thankful": 0,
          "like": 816,
          "love": 111,
          "care": 10,
          "haha": 0,
          "wow": 13,
          "sad": 0,
          "anger": 0,
          "pride": 0,
          "confused": 0
        },
        "commentCount": 84,
        "videoViewCount": null,
        "publishTime": 1788534422,
        "creation_time": "2026-09-04T15:07:02.000Z",
        "videoDetails": {
          "sdUrl": "https://video-phl2-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQMiFnhHnOudqYM9zNam1luOfe9L6Z6Dz9qysyFFyekhaRZidn6nD9Lh6l61LQgxqXfro7zRL8pOoC1wrfr61aEuUUo092T5BKLjBieT1A.mp4?_nc_cat=111&_nc_sid=8bf8fe&_nc_ht=video-phl2-1.xx.fbcdn.net&_nc_ohc=WxSfvqr2xdkQ7kNvwHcM9an&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjQwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MTgwNDM4NTAxMTAwODA5NCwiYXNzZXRfYWdlX2RheXMiOjQ…",
          "hdUrl": "https://video-phl2-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQOuNBX5ONbHyRHQubNjmTrqvkBHnADPSi95Aib90hn3vG5cXJz9C6rk-A2GrXrIfV67XFEbqGJt2HSA9wA7qQC5vAJlWXDVVVm3BaL8zRzxAw.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=video-phl2-1.xx.fbcdn.net&_nc_ohc=AWxFutGi700Q7kNvwFm61OU&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI4MC5kYXNoX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjoxODA0Mzg1MDExMDA…",
          "thumbnailUrl": "https://scontent-phl2-1.xx.fbcdn.net/v/t15.5256-10/796096241_1780944590009731_1220817617453126620_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=103&ccb=1-7&_nc_sid=be8305&_nc_ohc=Uh6PptUw5A4Q7kNvwHnjwGR&_nc_oc=Adq2Az1fxGPJfmwWxECC5OgxfQg1PJTlQYcPZz9zeMU4xcKpjyblKwBCW6CgkSrblzM&_nc_zt=23&_nc_ht=scontent-phl2-1.xx&_nc_gid=13mjGWrFrR-Bg8HoZDv0EA&_nc_ss=7f289&oh=00_AQLzaYDoH5iR6q4Yyek4ub3L9LOY1TN9oVLaeNSMpzu…"
        },
        "image": "https://scontent-phl2-1.xx.fbcdn.net/v/t15.5256-10/796096241_1780944590009731_1220817617453126620_n.jpg?stp=dst-jpg_p565x565_tt6&_nc_cat=103&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=Uh6PptUw5A4Q7kNvwHnjwGR&_nc_oc=Adq2Az1fxGPJfmwWxECC5OgxfQg1PJTlQYcPZz9zeMU4xcKpjyblKwBCW6CgkSrblzM&_nc_zt=23&_nc_ht=scontent-phl2-1.xx&_nc_gid=13mjGWrFrR-Bg8HoZDv0EA&_nc_ss=7f289&oh=00_AQKH6Kpd9vE9xvMSPmWomS2qDQBQkU06nZpBAfrMfc7…",
        "images": [
          "https://scontent-phl2-1.xx.fbcdn.net/v/t15.5256-10/796096241_1780944590009731_1220817617453126620_n.jpg?stp=dst-jpg_p565x565_tt6&_nc_cat=103&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=Uh6PptUw5A4Q7kNvwHnjwGR&_nc_oc=Adq2Az1fxGPJfmwWxECC5OgxfQg1PJTlQYcPZz9zeMU4xcKpjyblKwBCW6CgkSrblzM&_nc_zt=23&_nc_ht=scontent-phl2-1.xx&_nc_gid=13mjGWrFrR-Bg8HoZDv0EA&_nc_ss=7f289&oh=00_AQKH6Kpd9vE9xvMSPmWomS2qDQBQkU06nZpBAfrMfc7…"
        ],
        "topComments": []
      }
    ],
    "cursor": "Cg8Ob3JnYW5pY19jdXJzb3IJAAACREFRSFRtRkZJTVNTc1dtTDdNdDZBRGJIdUthN01PLV9pS2QxckZVR21SbUVrVExNNDRReTc5Z3M0SDMwRzhNcXM5YjRiWTdiOWxROVluY1cwb3E4ZFlDWlk1LWtCTlhvclN1bnFXYk1LSXVROElTZXFZRVp4YWd5N01DdHlTakdYeGJRS2owQ3RXakZCYlNmaDY0ZGhfV2ZpQjA1WXdoYnhQcHkzNzdkNlBMYy0xUEk3ZDh2T3NCS29xUDhsRnZhd1hBblNudHhhR3FLS2pmRnlQZXNFUllPb1pWM2pMRVVyTzdrTGM5YzJfblJlYTRsZUV5U21seWcwR2x1MHBFb3VzSExjelhfRzQwX0xWeDFYVzJJZ0NE…"
  }
}

Getting more results

Each response includes a cursor. Pass it back as cursor to fetch the next 3 posts. Repeat until no cursor is returned.

two calls

# Call 1 — first 3 posts
curl "https://fastfetchz.com/v1/facebook/posts-reels?target=asif2bd" \
  -H "X-API-Key: $FASTFETCHZ_KEY"
# -> { "data": { ... }, "cursor": "eyJwYWdlIjoyfQ" }

# Call 2 — next 3 posts
curl "https://fastfetchz.com/v1/facebook/posts-reels?target=asif2bd&cursor=eyJwYWdlIjoyfQ" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Limits

Maximum per call: 3 posts.
Minimum per call: 1 post — a target with less data returns fewer posts, and an empty result is still a successful call.
Pass limit to receive fewer than 3 posts. It shapes the response, not the price.
Larger jobs are paginated with a cursor; there is no cap on how many pages you fetch.

What this costs in practice

30,000 posts = 10,000 calls × 1 credits per call = 10,000 credits = $0.00

Priced at the Custom pack rate: 1,000,000 credits for $0.00.

Open in the pricing calculator

Error codes

StatusCodeMeaning

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.

402insufficient_creditsYour balance is below the cost of the call. Top up to continue.

403account_suspended / key_revokedThe account is suspended or the key was revoked.

429rate_limitedOver your account's requests-per-second limit. Retrying helps: the body carries retry_after_seconds and the response carries a Retry-After header. Not charged.

429monthly_cap_reachedThis key used the monthly call cap you set for it. Retrying will not help — raise the cap, use another key, or wait for the next calendar month. No Retry-After header is sent. Not charged.

500upstream_errorUnexpected failure while fulfilling the request. Not charged.