Facebookget/get_seller_details

Get Seller Details

Facebook Marketplace Listings
Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access Facebook data through agntdata: Get Seller Details. Retrieve seller details given the seller id. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need page and group posts, marketplace listings, video content, and ad discovery programmatically.

Use cases

AI agents that need Facebook data in structured form
Analytics and monitoring pipelines for Facebook content
Research and GTM workflows that combine Facebook signals with other data

Parameters

NameInTypeRequiredDescription
seller_idquerystringrequiredDefault: 100000821500068

Responses

Response

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "seller_details": {
          "type": "object",
          "properties": {
            "seller_info": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "short_name": {
                  "type": "string"
                },
                "seller_id": {
                  "type": "string"
                },
                "user_id": {
                  "type": "string"
                },
                "gender": {
                  "type": "string"
                },
                "can_viewer_follow": {
                  "type": "boolean"
                },
                "is_viewer_following": {
                  "type": "boolean"
                },
                "profile_pictures": {
                  "type": "object",
                  "properties": {
                    "large_160": {
                      "type": "string"
                    },
                    "medium_112": {
                      "type": "string"
                    },
                    "small_64": {
                      "type": "string"
                    },
                    "tiny_50": {
                      "type": "string"
                    }
                  }
                },
                "cover_photo": {
                  "type": "object",
                  "properties": {
                    "uri": {
                      "type": "string"
                    },
                    "width": {
                      "type": "integer"
                    },
                    "height": {
                      "type": "integer"
                    }
                  }
                }
              }
            },
            "rating_stats": {
              "type": "object",
              "properties": {
                "average_rating": {
                  "type": "number"
                },
                "total_rating_count": {
                  "type": "integer"
                },
                "min_ratings_required": {
                  "type": "integer"
                },
                "ratings_are_private": {
                  "type": "boolean"
                },
                "followers_count": {
                  "type": "integer"
                },
                "bad_attributes_count": {
                  "type": "integer"
                },
                "total_reviews_in_collection": {
                  "type": "integer"
                },
                "has_more_reviews": {
                  "type": "boolean"
                }
              }
            },
            "reviews": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "review_id": {
                    "type": "string"
                  },
                  "rating_value": {
                    "type": "string"
                  },
                  "creation_time": {
                    "type": "integer"
                  },
                  "creation_date": {
                    "type": "string"
                  },
                  "rating_attributes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "rater_info": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "profile_pic": {
                        "type": "string"
                      }
                    }
                  },
                  "ratee_info": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "profile_pic": {
                        "type": "string"
                      }
                    }
                  },
                  "review_text": {
                    "type": "string"
                  },
                  "feedback": {
                    "type": "object",
                    "properties": {
                      "reaction_count": {
                        "type": "integer"
                      },
                      "viewer_liked": {
                        "type": "boolean"
                      }
                    }
                  },
                  "response_info": {
                    "type": "object",
                    "properties": {
                      "response_text": {
                        "nullable": true
                      },
                      "response_creation_time": {
                        "nullable": true
                      }
                    }
                  },
                  "cursor": {
                    "type": "string"
                  }
                }
              }
            },
            "good_attributes": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "attribute": {
                    "type": "string"
                  },
                  "count": {
                    "type": "integer"
                  },
                  "percentage": {
                    "nullable": true
                  }
                }
              }
            },
            "badges": {
              "type": "array",
              "items": {}
            },
            "merchant_settings": {
              "type": "object",
              "properties": {}
            },
            "extraction_timestamp": {
              "type": "string"
            },
            "seller_id": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}

Agent / Developer Schema

Machine-readable formats for integrating this endpoint into AI agents and toolchains.

{
  "operationId": "Get_Seller_Details",
  "method": "get",
  "path": "/get_seller_details",
  "summary": "Get Seller Details",
  "description": "Retrieve seller details given the seller id",
  "parameters": [
    {
      "name": "seller_id",
      "in": "query",
      "required": true,
      "schema": {
        "type": "string",
        "default": "100000821500068"
      }
    }
  ],
  "responses": [
    {
      "statusCode": "200",
      "description": "Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "properties": {
                  "seller_details": {
                    "type": "object",
                    "properties": {
                      "seller_info": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "short_name": {
                            "type": "string"
                          },
                          "seller_id": {
                            "type": "string"
                          },
                          "user_id": {
                            "type": "string"
                          },
                          "gender": {
                            "type": "string"
                          },
                          "can_viewer_follow": {
                            "type": "boolean"
                          },
                          "is_viewer_following": {
                            "type": "boolean"
                          },
                          "profile_pictures": {
                            "type": "object",
                            "properties": {
                              "large_160": {
                                "type": "string"
                              },
                              "medium_112": {
                                "type": "string"
                              },
                              "small_64": {
                                "type": "string"
                              },
                              "tiny_50": {
                                "type": "string"
                              }
                            }
                          },
                          "cover_photo": {
                            "type": "object",
                            "properties": {
                              "uri": {
                                "type": "string"
                              },
                              "width": {
                                "type": "integer"
                              },
                              "height": {
                                "type": "integer"
                              }
                            }
                          }
                        }
                      },
                      "rating_stats": {
                        "type": "object",
                        "properties": {
                          "average_rating": {
                            "type": "number"
                          },
                          "total_rating_count": {
                            "type": "integer"
                          },
                          "min_ratings_required": {
                            "type": "integer"
                          },
                          "ratings_are_private": {
                            "type": "boolean"
                          },
                          "followers_count": {
                            "type": "integer"
                          },
                          "bad_attributes_count": {
                            "type": "integer"
                          },
                          "total_reviews_in_collection": {
                            "type": "integer"
                          },
                          "has_more_reviews": {
                            "type": "boolean"
                          }
                        }
                      },
                      "reviews": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "review_id": {
                              "type": "string"
                            },
                            "rating_value": {
                              "type": "string"
                            },
                            "creation_time": {
                              "type": "integer"
                            },
                            "creation_date": {
                              "type": "string"
                            },
                            "rating_attributes": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "rater_info": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string"
                                },
                                "profile_pic": {
                                  "type": "string"
                                }
                              }
                            },
                            "ratee_info": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string"
                                },
                                "profile_pic": {
                                  "type": "string"
                                }
                              }
                            },
                            "review_text": {
                              "type": "string"
                            },
                            "feedback": {
                              "type": "object",
                              "properties": {
                                "reaction_count": {
                                  "type": "integer"
                                },
                                "viewer_liked": {
                                  "type": "boolean"
                                }
                              }
                            },
                            "response_info": {
                              "type": "object",
                              "properties": {
                                "response_text": {
                                  "nullable": true
                                },
                                "response_creation_time": {
                                  "nullable": true
                                }
                              }
                            },
                            "cursor": {
                              "type": "string"
                            }
                          }
                        }
                      },
                      "good_attributes": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "attribute": {
                              "type": "string"
                            },
                            "count": {
                              "type": "integer"
                            },
                            "percentage": {
                              "nullable": true
                            }
                          }
                        }
                      },
                      "badges": {
                        "type": "array",
                        "items": {}
                      },
                      "merchant_settings": {
                        "type": "object",
                        "properties": {}
                      },
                      "extraction_timestamp": {
                        "type": "string"
                      },
                      "seller_id": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          },
          "example": {
            "data": {
              "seller_details": {
                "seller_info": {
                  "name": "Brian Salameh",
                  "short_name": "Brian",
                  "seller_id": "1474259102611459",
                  "user_id": "pfbid037xv3zasPcHXUAG6E72wQLvCQpkX2UAaSEzAjXJUXuwHHc38XEYkDHPq7XwdBFcgAl",
                  "gender": "MALE",
                  "can_viewer_follow": true,
                  "is_viewer_following": false,
                  "profile_pictures": {
                    "large_160": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/439972665_7477957192241590_2923853274879152312_n.jpg?stp=cp6_dst-jpg_s320x320_tt6&_nc_cat=109&ccb=1-7&_nc_sid=e99d92&_nc_ohc=jumFZgdVqEIQ7kNvwFTyH7e&_nc_oc=AdmAJHg6f6FFXcZ_ow-uDtiLKXc3eHNUdut4rxnXPzjv9wTrxAKcjjghBKekJS7drP4&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&_nc_gid=2xrpbNkZglYRnz1jFaX_WQ&oh=00_AfTdnMIDP5CvosNIVFlne_T4QOUmYsIbwMp2_ot9Brgfvg&oe=688D5884",
                    "medium_112": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/439972665_7477957192241590_2923853274879152312_n.jpg?stp=cp6_dst-jpg_s240x240_tt6&_nc_cat=109&ccb=1-7&_nc_sid=e99d92&_nc_ohc=jumFZgdVqEIQ7kNvwFTyH7e&_nc_oc=AdmAJHg6f6FFXcZ_ow-uDtiLKXc3eHNUdut4rxnXPzjv9wTrxAKcjjghBKekJS7drP4&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&_nc_gid=2xrpbNkZglYRnz1jFaX_WQ&oh=00_AfTtx5YlDcehMnTPdNiGT7L1ZLcDgeQHbmHp5RIYBVRsyw&oe=688D5884",
                    "small_64": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/439972665_7477957192241590_2923853274879152312_n.jpg?stp=cp6_dst-jpg_s130x130_tt6&_nc_cat=109&ccb=1-7&_nc_sid=e99d92&_nc_ohc=jumFZgdVqEIQ7kNvwFTyH7e&_nc_oc=AdmAJHg6f6FFXcZ_ow-uDtiLKXc3eHNUdut4rxnXPzjv9wTrxAKcjjghBKekJS7drP4&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&_nc_gid=2xrpbNkZglYRnz1jFaX_WQ&oh=00_AfTaFIdsjLKFjOyjJwFNvJqAtNUkK-PWf7qmdgXnag217Q&oe=688D5884",
                    "tiny_50": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/439972665_7477957192241590_2923853274879152312_n.jpg?stp=cp6_dst-jpg_s100x100_tt6&_nc_cat=109&ccb=1-7&_nc_sid=e99d92&_nc_ohc=jumFZgdVqEIQ7kNvwFTyH7e&_nc_oc=AdmAJHg6f6FFXcZ_ow-uDtiLKXc3eHNUdut4rxnXPzjv9wTrxAKcjjghBKekJS7drP4&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&_nc_gid=2xrpbNkZglYRnz1jFaX_WQ&oh=00_AfT02GDESk--NVhOhNuYTwX-y_HeO44fIekfInwKgNFSNQ&oe=688D5884"
                  },
                  "cover_photo": {
                    "uri": "https://scontent-iad3-2.xx.fbcdn.net/v/t1.6435-9/193509168_3988894011147943_4350413609437674248_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=rwd42q5_blkQ7kNvwFfIIh7&_nc_oc=Adkw204t-R2UHStcewx_7LTcggKDHs3xdDPdw6LOkDjVNGfjOBlCbKuSP4zXSAm0_0Y&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=2xrpbNkZglYRnz1jFaX_WQ&oh=00_AfTNoicvEJ0LfdA3r2S2TGs-keVmCSjPLsmncp4QyVvhsA&oe=68AF0798",
                    "width": 1440,
                    "height": 1440
                  }
                },
                "rating_stats": {
                  "average_rating": 3.8,
                  "total_rating_count": 86,
                  "min_ratings_required": 5,
                  "ratings_are_private": false,
                  "followers_count": 283,
                  "bad_attributes_count": 4,
                  "total_reviews_in_collection": 86,
                  "has_more_reviews": true
                },
                "reviews": [
                  {
                    "review_id": "23862792400010866",
                    "rating_value": "FIVE_STAR_FIVE",
                    "creation_time": 1749171056,
                    "creation_date": "2025-06-06 00:50:56",
                    "rating_attributes": [
                      "FAIR_PRICING",
                      "ITEM_DESCRIPTION",
                      "PUNCTUALITY",
                      "RESPONSE_TIME"
                    ],
                    "rater_info": {
                      "name": "John",
                      "profile_pic": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/506269723_3251717931647290_6685888180971558969_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=104&ccb=1-7&_nc_sid=393346&_nc_ohc=j8FinbnFe74Q7kNvwFHy5YK&_nc_oc=AdnNo0LxT29SUskWwiwOTJfwh79nUTIKdFBNaiEKuhl59T6TRJQniwbxv2PpZqUCnlY&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&_nc_gid=2xrpbNkZglYRnz1jFaX_WQ&oh=00_AfSHj6iSbj0FpRsI1FNTY2Rw3XBISXZexZa5lFqmc8VYEA&oe=688D67B8"
                    },
                    "ratee_info": {
                      "name": "Brian",
                      "profile_pic": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/439972665_7477957192241590_2923853274879152312_n.jpg?stp=cp6_dst-jpg_s100x100_tt6&_nc_cat=109&ccb=1-7&_nc_sid=393346&_nc_ohc=jumFZgdVqEIQ7kNvwFTyH7e&_nc_oc=AdmAJHg6f6FFXcZ_ow-uDtiLKXc3eHNUdut4rxnXPzjv9wTrxAKcjjghBKekJS7drP4&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&_nc_gid=2xrpbNkZglYRnz1jFaX_WQ&oh=00_AfT02GDESk--NVhOhNuYTwX-y_HeO44fIekfInwKgNFSNQ&oe=688D5884"
                    },
                    "review_text": "everything was perfect. from the 1st email he sent me back until the second i pulled into my driveway. Everything was perfect.",
                    "feedback": {
                      "reaction_count": 0,
                      "viewer_liked": false
                    },
                    "response_info": {
                      "response_text": null,
                      "response_creation_time": null
                    },
                    "cursor": "AQFmOqi3rK2f-sJRGPNS7UNMJYXdcPBQ0I6KaF4ZxuX94bSjvAmnEZIsp2SAyI0DmvONfEFUvBr3E7sXDYmGzhJnyw"
                  },
                  {
                    "review_id": "9909520472403962",
                    "rating_value": "FIVE_STAR_FIVE",
                    "creation_time": 1745901458,
                    "creation_date": "2025-04-29 04:37:38",
                    "rating_attributes": [],
                    "rater_info": {
                      "name": "Juan",
                      "profile_pic": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/499809273_3644052315731987_1114796898214142290_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=109&ccb=1-7&_nc_sid=393346&_nc_ohc=8ggFUOLDnUMQ7kNvwEXXSwr&_nc_oc=Adnjv2BzN6cyM_hla9ZHTEdWuaq91gsv9uzKTUOZS1-NP9Ws_yYPZWMTr2cU882PrHI&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&_nc_gid=2xrpbNkZglYRnz1jFaX_WQ&oh=00_AfTbnhTkYRrJmUuwWlGh93XNUJGwM0UItyKfZwhM8KTiaw&oe=688D5A13"
                    },
                    "ratee_info": {
                      "name": "Brian",
                      "profile_pic": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/439972665_7477957192241590_2923853274879152312_n.jpg?stp=cp6_dst-jpg_s100x100_tt6&_nc_cat=109&ccb=1-7&_nc_sid=393346&_nc_ohc=jumFZgdVqEIQ7kNvwFTyH7e&_nc_oc=AdmAJHg6f6FFXcZ_ow-uDtiLKXc3eHNUdut4rxnXPzjv9wTrxAKcjjghBKekJS7drP4&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&_nc_gid=2xrpbNkZglYRnz1jFaX_WQ&oh=00_AfT02GDESk--NVhOhNuYTwX-y_HeO44fIekfInwKgNFSNQ&oe=688D5884"
                    },
                    "review_text": "I just bought my car, the attention and readiness to help was very good, I recommend you this guys…also they were very friendly.�",
                    "feedback": {
                      "reaction_count": 1,
                      "viewer_liked": false
                    },
                    "response_info": {
                      "response_text": null,
                      "response_creation_time": null
                    },
                    "cursor": "AQFmdQUROdZE8H1KOSZoe2Cl81Sfs1s2GHl1i0rGW3193IUUjDmorYrGc2hRgAQOWzjMOzELdSRE4OWysY5Vhp_6Rg"
                  },
                  {
                    "review_id": "9406410782777976",
                    "rating_value": "FIVE_STAR_ONE",
                    "creation_time": 1743290684,
                    "creation_date": "2025-03-29 23:24:44",
                    "rating_attributes": [
                      "PUNCTUALITY",
                      "RESPONSE_TIME"
                    ],
                    "rater_info": {
                      "name": "Steve",
                      "profile_pic": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-6/496871637_10232615703507380_2322809274392006988_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=101&ccb=1-7&_nc_sid=8991a6&_nc_ohc=rCcA5Ms_BW0Q7kNvwFSlaTp&_nc_oc=AdnUpCuWmlIiEsFVSma6C_1bY3DEMclDIYLNDhUPcTI_hVXL7rYCAR9ci5dwxr3YLqw&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=2xrpbNkZglYRnz1jFaX_WQ&oh=00_AfSBjAWEEQr4I5lHLrUG9syODWp0SDMHzFq9mp70O_O6sg&oe=688D5E90"
                    },
                    "ratee_info": {
                      "name": "Brian",
                      "profile_pic": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/439972665_7477957192241590_2923853274879152312_n.jpg?stp=cp6_dst-jpg_s100x100_tt6&_nc_cat=109&ccb=1-7&_nc_sid=393346&_nc_ohc=jumFZgdVqEIQ7kNvwFTyH7e&_nc_oc=AdmAJHg6f6FFXcZ_ow-uDtiLKXc3eHNUdut4rxnXPzjv9wTrxAKcjjghBKekJS7drP4&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&_nc_gid=2xrpbNkZglYRnz1jFaX_WQ&oh=00_AfT02GDESk--NVhOhNuYTwX-y_HeO44fIekfInwKgNFSNQ&oe=688D5884"
                    },
                    "review_text": "Terrible service can’t even get a response in a timely manner and can never meet within a reasonable time ",
                    "feedback": {
                      "reaction_count": 1,
                      "viewer_liked": false
                    },
                    "response_info": {
                      "response_text": "When dealing with multiple parties who are interested it is hard to make times to show a vehicle and respond in a timely manner . ",
                      "response_creation_time": 1745243135
                    },
                    "cursor": "AQFmk0It4TSVIbzCPGz6NXrT1F0Aa6sc9GFf-q2HZHXZHFSAsMTCJMyBoexfuQD_C-G5mueExHsO_Qjcj-vh74deHQ"
                  }
                ],
                "good_attributes": [
                  {
                    "attribute": "Communication",
                    "count": 28,
                    "percentage": null
                  },
                  {
                    "attribute": "Item description",
                    "count": 23,
                    "percentage": null
                  },
                  {
                    "attribute": "Pricing",
                    "count": 21,
                    "percentage": null
                  },
                  {
                    "attribute": "Punctuality",
                    "count": 20,
                    "percentage": null
                  },
                  {
                    "attribute": "Friendliness",
                    "count": 1,
                    "percentage": null
                  }
                ],
                "badges": [],
                "merchant_settings": {},
                "extraction_timestamp": "2025-07-28T15:07:25.645499",
                "seller_id": "100000821500068"
              }
            }
          }
        }
      }
    }
  ]
}

Pricing

$0.01per successful request

Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.

Related endpoints

Start using this endpoint

Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.

Facebook APIFacebook data APIget seller details APIAI agents data APIFacebook APIFacebook data APIFacebook for AI agents