Facebook API

Facebook page profiles and public posts.

Only public Facebook Pages are supported, not personal profiles
Post search returns up to 10 results per request
The /facebook/posts?url= endpoint supports posts, videos, reels, and share links

Users

`GET /facebook/users/:username` — 3 credits

Get Facebook page profile.

Param	Type	Required	Default	Description
`username`	string	Yes	—	Facebook page username or ID

cURL


curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/facebook/users/NASA

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/facebook/users/NASA",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch("https://api.bycrawl.com/facebook/users/NASA", {
  headers: { "x-api-key": "sk_byc_xxx" },
});
console.log(await response.json());

Response


{
  "id": "100044561550831",
  "name": "NASA - National Aeronautics and Space Administration",
  "username": "NASA",
  "category": "",
  "profilePicture": "https://...",
  "coverPhoto": "https://...",
  "likesCount": 26880882,
  "description": "NASA - National Aeronautics and Space Administration..."
}

`GET /facebook/users/:username/posts` — 3 credits

Get a Facebook page’s recent posts.

Param	Type	Required	Default	Description
`username`	string	Yes	—	Facebook page username or ID
`count`	integer	No	3	Number of posts (max 10)

cURL


curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/facebook/users/NASA/posts

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/facebook/users/NASA/posts",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch("https://api.bycrawl.com/facebook/users/NASA/posts", {
  headers: { "x-api-key": "sk_byc_xxx" },
});
console.log(await response.json());

Response


{
  "posts": [
    {
      "id": "1471370877691617",
      "text": "Want to track the Artemis II crew around the Moon...",
      "createdAt": "2026-03-06T18:48:20.000Z",
      "permalinkUrl": "https://www.facebook.com/photo.php?fbid=1471370844358287&set=a.416661013162614&type=3",
      "reactionCount": 3204,
      "commentCount": 208,
      "shareCount": 478,
      "topReactions": [
        { "type": "1635855486666999", "count": 20 },
        { "type": "115940658764963", "count": 4 }
      ],
      "media": []
    }
  ]
}

Posts

`GET /facebook/posts?url=xxx` — 1 credit

Get a Facebook post by URL. Supports posts, reels, videos, and share links.

Param	Type	Required	Default	Description
`url`	string	Yes	—	Facebook post URL

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/facebook/posts?url=https://www.facebook.com/will.fans/videos/2737644976589415"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/facebook/posts?url=https://www.facebook.com/will.fans/videos/2737644976589415",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/facebook/posts?url=https://www.facebook.com/will.fans/videos/2737644976589415",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "id": "2737644976589415",
  "url": "https://www.facebook.com/will.fans/videos/2737644976589415",
  "author": { "name": "Will", "id": "100064322940906" },
  "text": "Post content...",
  "createdAt": "2025-06-01T12:00:00.000Z",
  "reactionCount": 963,
  "commentCount": 47,
  "shareCount": 228,
  "viewCount": 59000,
  "media": [{ "type": "video", "url": "https://..." }]
}

`GET /facebook/posts/comments?url=xxx` — 3 credits

Get comments on a Facebook post by URL.

Param	Type	Required	Default	Description
`url`	string	Yes	—	Facebook post URL
`cursor`	string	No	—	Pagination cursor

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/facebook/posts/comments?url=https://www.facebook.com/hower.chen/posts/pfbid022KX63mKWNtujSnrsxBkzvSwG6G9XCTz5SxQrYdfYCktEjD1bzVNoX8zy5C1xR5Bol"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/facebook/posts/comments",
    params={"url": "https://www.facebook.com/hower.chen/posts/pfbid022KX63mKWNtujSnrsxBkzvSwG6G9XCTz5SxQrYdfYCktEjD1bzVNoX8zy5C1xR5Bol"},
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/facebook/posts/comments?url=https://www.facebook.com/hower.chen/posts/pfbid022KX63mKWNtujSnrsxBkzvSwG6G9XCTz5SxQrYdfYCktEjD1bzVNoX8zy5C1xR5Bol",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "comments": [
    {
      "id": "1234567890123",
      "text": "Great post!",
      "authorName": "John Doe",
      "authorId": "100012345678901",
      "createdAt": "2026-03-01T08:15:30.000Z",
      "reactionCount": 5,
      "replies": [
        {
          "id": "1234567890124",
          "text": "Thanks!",
          "authorName": "Jane Smith",
          "authorId": "100098765432101",
          "createdAt": "2026-03-01T09:20:00.000Z",
          "reactionCount": 1,
          "replies": []
        }
      ]
    }
  ],
  "nextCursor": null
}

`GET /facebook/posts/search?q=xxx` — 2 credits

Search public Facebook posts by keyword.

Param	Type	Required	Default	Description
`q`	string	Yes	—	Search keyword
`count`	integer	No	5	Number of results (max 10)

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/facebook/posts/search?q=bitcoin&count=5"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/facebook/posts/search?q=bitcoin&count=5",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/facebook/posts/search?q=bitcoin&count=5",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "posts": [
    {
      "postId": "1495158265349916",
      "url": "https://www.facebook.com/BitcoinMagazine/posts/pfbid02MeTE2RCUqf...",
      "text": "21 million #Bitcoin, 8.1 billion people. Do the math...",
      "createdAt": "2026-03-05T21:17:00.000Z",
      "author": { "name": "Bitcoin Magazine", "id": "100045672716302" },
      "reactionCount": 1506,
      "commentCount": 676,
      "shareCount": 172,
      "media": [{ "type": "photo", "url": "https://..." }]
    }
  ],
  "nextCursor": "AQHRl..."
}

Marketplace

`GET /facebook/marketplace/listings` — 1 credit

Browse Facebook Marketplace listings by location and optional category.

Param	Type	Required	Default	Description
`location`	string	No	`taipei`	Location slug (e.g. ‘taipei’, ‘newyork’)
`category`	string	No	—	Category slug (e.g. ‘vehicles’, ‘electronics’)

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/facebook/marketplace/listings?location=taipei&category=vehicles"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/facebook/marketplace/listings",
    params={"location": "taipei", "category": "vehicles"},
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/facebook/marketplace/listings?location=taipei&category=vehicles",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "listings": [
    {
      "id": "1432903611622625",
      "title": "Aston Martin 2005 DB9",
      "price": {
        "amount": "1750000",
        "currency": "TWD",
        "formatted": "NT$1,750,000"
      },
      "location": {
        "city": "台北市",
        "region": "",
        "displayName": "Taipei, Taiwan"
      },
      "primaryPhoto": "https://...",
      "url": "https://www.facebook.com/marketplace/item/1432903611622625/",
      "isSold": false,
      "isLive": true,
      "isPending": false,
      "categoryId": "807311116002614",
      "deliveryTypes": ["IN_PERSON", "PUBLIC_MEETUP"]
    }
  ],
  "location": "taipei",
  "category": "vehicles"
}

`GET /facebook/marketplace/search?q=xxx` — 1 credit

Search Facebook Marketplace listings by keyword.

Param	Type	Required	Default	Description
`q`	string	Yes	—	Search keyword
`location`	string	No	`taipei`	Location slug (e.g. ‘taipei’, ‘newyork’)
`category`	string	No	—	Category filter (e.g. ‘vehicles’)

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/facebook/marketplace/search?q=toyota&location=taipei"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/facebook/marketplace/search",
    params={"q": "toyota", "location": "taipei"},
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/facebook/marketplace/search?q=toyota&location=taipei",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "listings": [
    {
      "id": "9876543210123456",
      "title": "Toyota Corolla 2018",
      "price": {
        "amount": "450000",
        "currency": "TWD",
        "formatted": "NT$450,000"
      },
      "location": {
        "city": "台北市",
        "region": "",
        "displayName": "Taipei, Taiwan"
      },
      "primaryPhoto": "https://...",
      "url": "https://www.facebook.com/marketplace/item/9876543210123456/",
      "isSold": false,
      "isLive": true,
      "isPending": false,
      "categoryId": "807311116002614",
      "deliveryTypes": ["IN_PERSON"]
    }
  ],
  "query": "toyota",
  "location": "taipei"
}

`GET /facebook/marketplace/items/:listing_id` — 1 credit

Get detailed Facebook Marketplace listing by ID. Returns full description, photos, price, condition, and location.

Param	Type	Required	Default	Description
`listing_id`	string	Yes	—	Marketplace listing ID

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/facebook/marketplace/items/1432903611622625"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/facebook/marketplace/items/1432903611622625",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/facebook/marketplace/items/1432903611622625",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "id": "1432903611622625",
  "title": "Aston Martin 2005 DB9",
  "price": {
    "amount": "1750000",
    "currency": "TWD",
    "formatted": "NT$1,750,000"
  },
  "description": "英倫優雅，到利曼榮耀...",
  "condition": "PC_USED_GOOD",
  "createdAt": "2026-02-27T12:30:07.000Z",
  "photos": ["https://..."],
  "location": {
    "city": "台北市",
    "region": "",
    "displayName": "台北市, 台灣"
  },
  "primaryPhoto": "https://...",
  "url": "https://www.facebook.com/marketplace/item/1432903611622625/",
  "sellerName": null,
  "sellerId": null,
  "isSold": false,
  "isLive": true,
  "isPending": false,
  "categoryId": "807311116002614",
  "deliveryTypes": ["IN_PERSON", "PUBLIC_MEETUP"]
}

Facebook API

Users

GET /facebook/users/:username — 3 credits

cURL

Python

JavaScript

GET /facebook/users/:username/posts — 3 credits

cURL

Python

JavaScript

Posts

GET /facebook/posts?url=xxx — 1 credit

cURL

Python

JavaScript

GET /facebook/posts/comments?url=xxx — 3 credits

cURL

Python

JavaScript

GET /facebook/posts/search?q=xxx — 2 credits

cURL

Python

JavaScript

Marketplace

GET /facebook/marketplace/listings — 1 credit

cURL

Python

JavaScript

GET /facebook/marketplace/search?q=xxx — 1 credit

cURL

Python

JavaScript

GET /facebook/marketplace/items/:listing_id — 1 credit

cURL

Python

JavaScript

`GET /facebook/users/:username` — 3 credits

`GET /facebook/users/:username/posts` — 3 credits

`GET /facebook/posts?url=xxx` — 1 credit

`GET /facebook/posts/comments?url=xxx` — 3 credits

`GET /facebook/posts/search?q=xxx` — 2 credits

`GET /facebook/marketplace/listings` — 1 credit

`GET /facebook/marketplace/search?q=xxx` — 1 credit

`GET /facebook/marketplace/items/:listing_id` — 1 credit