> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuralverge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook reviews

> Reviews (recommendations) of Facebook pages: recommended or not, text, date, author, tags, likes, photos and comments. 5 point per returned record.



## OpenAPI

````yaml /openapi.json post /functions/v1/run-facebook-reviews
openapi: 3.0.0
info:
  title: NeuralVerge API
  version: 1.0.0
  description: >-
    NeuralVerge API for AI research, search, extraction, and structured data
    source execution.
servers:
  - url: https://api.neuralverge.ai
    description: NeuralVerge API
security:
  - BearerAuth: []
tags:
  - name: AI Research
    description: Multi-step research workflows and the sessions they run in.
  - name: AI Extract
    description: Schema-driven extraction workflows.
  - name: Search
    description: Fast, synchronous web search with no session or polling.
  - name: Company intelligence
    description: Company profile lookups from company databases.
  - name: E-commerce & Marketplaces
    description: >-
      Product, seller, and review lookups on Amazon, eBay, Walmart, AliExpress,
      and Alibaba.
  - name: Enrichment
    description: Email and phone enrichment, validation, and discovery.
  - name: Product reviews
    description: >-
      Software and business reviews from Capterra, Gartner Peer Insights, and
      Trustpilot.
  - name: Social media
    description: LinkedIn profile, company, and people lookups.
  - name: Company Registries
    description: Company Registries data sources.
  - name: Startup & Funding Data
    description: Startup & Funding Data data sources.
  - name: Maps & Local Businesses
    description: Maps & Local Businesses data sources.
paths:
  /functions/v1/run-facebook-reviews:
    post:
      tags:
        - Social media
      summary: Facebook reviews
      description: >-
        Reviews (recommendations) of Facebook pages: recommended or not, text,
        date, author, tags, likes, photos and comments. 5 point per returned
        record.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  description: >-
                    Page URL, name or ID. e.g.
                    https://www.facebook.com/copperkettleyqr/
                  type: string
                max_items:
                  description: Max reviews (up to 1000)
                  type: integer
                  minimum: 1
                  maximum: 1000
                  default: 20
                newer_than:
                  description: >-
                    Reviews newer than (date or period). e.g. 2024-01-01 or 3
                    months
                  type: string
              required:
                - url
            example:
              url: https://www.facebook.com/copperkettleyqr/
              max_items: 2
      responses:
        '200':
          description: Run completed.
          content:
            application/json:
              example:
                session_id: 11111111-1111-1111-1111-111111111111
                kind: facebook_reviews
                url: https://www.facebook.com/copperkettleyqr/
                max_items: 2
                newer_than: ''
                partial: false
                human: |-
                  # Facebook reviews

                  - **Page:** copperkettleyqr
                  - **Max reviews:** 2
                  - **Records returned:** 2
                machine:
                  total_items: 2
                  items:
                    - id: >-
                        UzpfSTEwMDAwODg0Mjg0MTAzMDozNDMzNTYyNDMzNjE1MTUxOjM0MzM1NjI0MzM2MTUxNTE=
                      url: >-
                        https://www.facebook.com/daniel.masih.313/posts/pfbid0bZeVZeBi2mdn5KayJHnbtF6a69KPC9if17xwwXs3f52AvX5LEkZi841jJBWVzptfl
                      date: '2024-09-11T17:57:58.000Z'
                      is_recommended: true
                      text: >-
                        They offers a cozy atmosphere, friendly service, and a
                        menu of tasty comfort food at reasonable prices. It’s a
                        great spot for casual dining.
                      tags:
                        - Child-friendly
                        - Fast delivery
                        - Cosy atmosphere
                      author:
                        id: '100008842841030'
                        name: Daniel Masih
                        profile_url: https://www.facebook.com/daniel.masih.313
                        profile_picture_url: >-
                          https://scontent.fwbw1-1.fna.fbcdn.net/v/t39.30808-1/415241783_3260597094245020_6766639615586464067_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1080x1080&ctp=s40x40&_nc_cat=109&_nc_map=urlgen_bucketless&ccb=1-7&
                      likes_count: 0
                      comments_count: 0
                      photos: []
                      comments: []
                      page_url: https://www.facebook.com/copperkettleyqr
                    - id: >-
                        UzpfSTUyNTU3NTA0MzoxMDE1OTM2NzE2MzM2NTA0NDoxMDE1OTM2NzE2MzM2NTA0NA==
                      url: >-
                        https://www.facebook.com/jayna.nicholson/posts/pfbid02K7hKJ7gBHzRZG9T7xEWySwbemooDWqKKZi2ajukBWPgQW12ngcqeYTHqqLxYNEEwl
                      date: '2024-04-11T17:40:55.000Z'
                      is_recommended: false
                      text: >-
                        Normally the food from here is really good but we got
                        pizza last night and it was somewhere in the range of
                        sub par to just really not good. The whole thing was
                        barely cooked and was so soggy. The cru
                      tags: []
                      author:
                        id: >-
                          pfbid02GXXowSv4nR9NhFEziLGawGRWG1EzbLXZ4Egh5VGFf7hoKqi25ozAGeSZe1APs5Wxl
                        name: Jay Enn
                        profile_url: null
                        profile_picture_url: >-
                          https://scontent.fwbw1-1.fna.fbcdn.net/v/t39.30808-1/858484501_10162710746435044_3723959754395115161_n.jpg?stp=cp6_dst-jpg_tt6&cstp=mx2048x2048&ctp=s40x40&_nc_cat=102&_nc_map=urlgen_bucketless&ccb=1-7
                      likes_count: 1
                      comments_count: 2
                      photos: []
                      comments:
                        - id: >-
                            Y29tbWVudDoxMDE1OTM2NzE2MzM2NTA0NF83NTA4NTY5MTIyNDk5Nzgw
                          url: null
                          text: >-
                            Thank you for sharing your feedback with us, Jay.
                            We're sorry to hear that your recent experience with
                            our pizza was disappointing. We appreciate your
                            continued support, and we'll consider your commen
                          date: '2024-04-15T14:44:58.000Z'
                          author_name: null
                          author_url: https://www.facebook.com/copperkettleyqr
                          likes_count: 0
                      page_url: https://www.facebook.com/copperkettleyqr
                  errors: []
                total_points: 10
              schema:
                type: object
                properties:
                  session_id:
                    type: string
                    description: Session identifier for this run.
                  kind:
                    type: string
                    description: Data source identifier for this endpoint.
                  url:
                    type: string
                  max_items:
                    type: integer
                  newer_than:
                    type: string
                  partial:
                    type: boolean
                    description: >-
                      True when the scrape stopped early and returned the
                      records collected so far.
                  human:
                    type: string
                    description: Markdown summary of the result, for display.
                  machine:
                    type: object
                    properties:
                      total_items:
                        type: integer
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            url:
                              type: string
                            date:
                              type: string
                            is_recommended:
                              type: boolean
                            text:
                              type: string
                            tags:
                              type: array
                              items:
                                type: string
                                nullable: true
                            author:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                profile_url:
                                  type: string
                                  nullable: true
                                profile_picture_url:
                                  type: string
                            likes_count:
                              type: integer
                            comments_count:
                              type: integer
                            photos:
                              type: array
                              items: {}
                            comments:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  url: {}
                                  text:
                                    type: string
                                  date:
                                    type: string
                                  author_name: {}
                                  author_url:
                                    type: string
                                  likes_count:
                                    type: integer
                                nullable: true
                            page_url:
                              type: string
                      errors:
                        type: array
                        items: {}
                    description: Structured result payload.
                  total_points:
                    type: integer
                    description: Points charged for this run.
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '402':
          description: Payment Required
        '500':
          description: Internal Error
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.