Profile

Retrieve profile from Facebook with a single API request.

GET/api/data/v1/facebook/profile

1credit base costZero-credit cache supported

Request parameters

Up to 1 credit

urlrequired

Facebook profile URL

get_business_hoursoptional

Get the business's hours

include_gated_profileoptional

When true, returns limited public fields for gated or age-restricted profiles. Ignored for normal public profiles — those still return the full response.

cache_max_ageoptional

If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.]

Try in the console

Live requests use your prepaid balance. Cached responses cost zero where supported.

curl --request GET \
  --url 'https://fetchgoblin.com/api/data/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2Fmantraindianfolsom' \
  --header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'

Response

Example

{
  "success": true,
  "credits_charged": 1,
  "adLibrary": {
    "adStatus": "This Page is currently running ads.",
    "pageId": "104359362513119"
  },
  "creationDate": "November 25, 2022",
  "businessHours": [
    {
      "monday": {
        "open": null,
        "close": null,
        "intervals": [],
        "fullText": "CLOSED"
      }
    }
  ],
  "id": "100088017857524",
  "isPrivate": false,
  "name": "Mantraindian",
  "url": "https://www.facebook.com/mantraindianfolsom",
  "gender": "UNKNOWN",
  "coverPhoto": {
    "focus": {
      "x": 0.5,
      "y": 0
    },
    "photo": {
      "id": "204402652503662",
      "image": {
        "uri": "https://scontent.fist7-1.fna.fbcdn.net/v/t39.30808-6/477575273_596577106619546_7712360987777031655_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=111&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=hroqQOZECdYQ7kNvwHW0J5L&_nc_oc=Adk2HkBhLO3HlnqMEN512H6bOO8kWLs9n2qaiqPc4ZLz5-wi2uBfzqlepnfKhx2hhhM&_nc_zt=23&_nc_ht=scontent.fist7-1.fna&_nc_gid=-tZvZl1NES4sMXJo89jIig&oh=00_AflZ2sbTeyQC-owdG-cOBdq99WVZuYH0HKLsj13NJ_UOPw&oe=6934FD62",
        "width": 960,
        "height": 365
      },
      "viewer_image": {
        "height": 780,
        "width": 2050
      },
      "blurred_image": {
        "uri": "https://scontent.fist7-1.fna.fbcdn.net/v/t39.30808-6/477575273_596577106619546_7712360987777031655_n.jpg?stp=dst-jpg_fb50_s320x320_tt6&_nc_cat=111&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=hroqQOZECdYQ7kNvwHW0J5L&_nc_oc=Adk2HkBhLO3HlnqMEN512H6bOO8kWLs9n2qaiqPc4ZLz5-wi2uBfzqlepnfKhx2hhhM&_nc_zt=23&_nc_ht=scontent.fist7-1.fna&_nc_gid=-tZvZl1NES4sMXJo89jIig&oh=00_Afn0vRutoAnfxCkPeQ0UNfSocrQwMLU8RATTjTchjbR90g&oe=6934FD62",
        "width": 320,
        "height": 122
      },
      "url": "https://www.facebook.com/photo/?fbid=204402652503662&set=a.113593838251211"
    }
  },
  "isBusinessPageActive": false,
  "profilePhoto": {
    "url": "https://www.facebook.com/photo/?fbid=152234581053803&set=a.107432348867360",
    "viewer_image": {
      "height": 2000,
      "width": 2000
    },
    "id": "152234581053803"
  },
  "profilePicLarge": "https://scontent.fist20-2.fna.fbcdn.net/v/t39.30808-1/331711173_3408886226056104_241444658713195527_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=110&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=eQc1mF5YvQ8Q7kNvwFj3Nmh&_nc_oc=AdlpRt4MVt6MwM7loElnrHIChk-vaLz0fxxzMR70TNaQBST-bDibHAZNHPFldgXd1go&_nc_zt=24&_nc_ht=scontent.fist20-2.fna&_nc_gid=-tZvZl1NES4sMXJo89jIig&oh=00_AflOlRBe-OV2xNqafE-cb2i0qvJfJ1yB21EebLXS_LKbQw&oe=693512A2",
  "profilePicMedium": "https://scontent.fist20-2.fna.fbcdn.net/v/t39.30808-1/331711173_3408886226056104_241444658713195527_n.jpg?stp=dst-jpg_s148x148_tt6&_nc_cat=110&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=eQc1mF5YvQ8Q7kNvwFj3Nmh&_nc_oc=AdlpRt4MVt6MwM7loElnrHIChk-vaLz0fxxzMR70TNaQBST-bDibHAZNHPFldgXd1go&_nc_zt=24&_nc_ht=scontent.fist20-2.fna&_nc_gid=-tZvZl1NES4sMXJo89jIig&oh=00_Afl-VZWFU-_9jnKbqC0-2y--wYgnEAyFxIrSDSRl98Azkg&oe=693512A2",
  "profilePicSmall": "https://scontent.fist20-2.fna.fbcdn.net/v/t39.30808-1/331711173_3408886226056104_241444658713195527_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=110&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=eQc1mF5YvQ8Q7kNvwFj3Nmh&_nc_oc=AdlpRt4MVt6MwM7loElnrHIChk-vaLz0fxxzMR70TNaQBST-bDibHAZNHPFldgXd1go&_nc_zt=24&_nc_ht=scontent.fist20-2.fna&_nc_gid=-tZvZl1NES4sMXJo89jIig&oh=00_AflavCQJIlrYTApZzkUMv1dDuld8v9j1ApqTtJkQrF32kQ&oe=693512A2",
  "pageIntro": "Indian Vegan & Vegetarian Restaurant",
  "category": "Restaurant",
  "address": "1870 Prairie City Rd, Suite 500, Folsom, CA, United States, California",
  "email": "[email protected]",
  "links": [],
  "phone": "+1 916-999-1749",
  "website": "https://www.mantraindian.com/",
  "services": "Delivery · Takeaway · Dine in…",
  "priceRange": "$$",
  "rating": "Not yet rated (1 review)",
  "ratingCount": null,
  "likeCount": 3224,
  "talkingAboutCount": 418,
  "followerCount": 3200
}

Example data from the API specification. Run a request to retrieve current data.

Response shape

This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.

View JSON Schema +

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "credits_remaining": {
      "type": "integer"
    },
    "credits_charged": {
      "type": "integer"
    },
    "adLibrary": {
      "type": "object",
      "properties": {
        "adStatus": {
          "type": "string"
        },
        "pageId": {
          "type": "string"
        }
      }
    },
    "creationDate": {
      "type": "string"
    },
    "businessHours": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "monday": {
            "type": "object",
            "properties": {
              "open": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "close": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "intervals": {
                "type": "array"
              },
              "fullText": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "id": {
      "type": "string"
    },
    "isPrivate": {
      "type": "boolean"
    },
    "name": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "gender": {
      "type": "string"
    },
    "coverPhoto": {
      "type": "object",
      "properties": {
        "focus": {
          "type": "object",
          "properties": {
            "x": {
              "type": "number"
            },
            "y": {
              "type": "integer"
            }
          }
        },
        "photo": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "image": {
              "type": "object",
              "properties": {
                "uri": {
                  "type": "string"
                },
                "width": {
                  "type": "integer"
                },
                "height": {
                  "type": "integer"
                }
              }
            },
            "viewer_image": {
              "type": "object",
              "properties": {
                "height": {
                  "type": "integer"
                },
                "width": {
                  "type": "integer"
                }
              }
            },
            "blurred_image": {
              "type": "object",
              "properties": {
                "uri": {
                  "type": "string"
                },
                "width": {
                  "type": "integer"
                },
                "height": {
                  "type": "integer"
                }
              }
            },
            "url": {
              "type": "string"
            }
          }
        }
      }
    },
    "isBusinessPageActive": {
      "type": "boolean"
    },
    "profilePhoto": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string"
        },
        "viewer_image": {
          "type": "object",
          "properties": {
            "height": {
              "type": "integer"
            },
            "width": {
              "type": "integer"
            }
          }
        },
        "id": {
          "type": "string"
        }
      }
    },
    "profilePicLarge": {
      "type": "string"
    },
    "profilePicMedium": {
      "type": "string"
    },
    "profilePicSmall": {
      "type": "string"
    },
    "pageIntro": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "links": {
      "type": "array"
    },
    "phone": {
      "type": "string"
    },
    "website": {
      "type": "string"
    },
    "services": {
      "type": "string"
    },
    "priceRange": {
      "type": "string"
    },
    "rating": {
      "type": "string"
    },
    "ratingCount": {
      "type": [
        "string",
        "object",
        "array",
        "number",
        "boolean",
        "null"
      ]
    },
    "likeCount": {
      "type": "integer"
    },
    "talkingAboutCount": {
      "type": "integer"
    },
    "followerCount": {
      "type": "integer"
    }
  }
}

More Facebook endpoints Errors and credit accounting