Seller Profile

2min

Seller Profile Results
The Seller Profile Parameters are applicable when making a request with  type=seller_profile  to retrieve seller profile results for a given seller name on a given Ebay domain - the Ebay domain is specified using the  ebay_domain  parameter and the seller name is specified in the  seller_name  parameter. The parameters should be appended as querystring parameters to the Ebay Product Data API GET HTTP request.
Seller Profile results are retrieved from the seller profile results page on Ebay.
Seller Profile Page
﻿
An example of the JSON object returned from a Seller Profile request is shown below:
JSON
{
  "request_info": {
    "success": true,
    "credits_used": 1,
    "credits_remaining": 999
  },
  "request_metadata": {
    "id": "f78c211030e249334f2741f37cc7f3a884392054",
    "created_at": "2020-01-01T00:00:00.000Z",
    "processed_at": "2020-01-01T00:00:00.001Z",
    "total_time_taken": 0.1,
    "ebay_url": "https://www.ebay.com/usr/lytecordz"
  },
  "request_parameters": {
    "type": "seller_profile",
    "ebay_domain": "ebay.com",
    "seller_name": "lytecordz"
  },
  "seller": {
    "name": "lytecordz",
    "link": "https://www.ebay.com/usr/lytecordz",
    "member_since": "Jul 02, 2008",
    "postive_ratings_percent": 98.8,
    "followers": 540,
    "reviews": 3,
    "email": "[email protected]",
    "phone": "123456789",
    "location": "United States",
    "image": "https://i.ebayimg.com/00/s/NjkwWDEwMDA=/z/qu4AAOSwCR9cfYLq/$_7.JPG",
    "description": "A great selection of unique and fun smartphone accessories, DVDs, CD, and MORE! Guaranteed 3 day Delivery from Domestic USA Seller! Very responsive to ALL messages! 90 DAY GUARANTEE ON ALL PRODUCTS!",
    "feedback_ratings": {
      "positive": 4233,
      "neutral": 31,
      "negative": 47
    },
    "detailed_seller_ratings": [
      {
        "rating": 4.9,
        "type": "Item as described"
      },
      {
        "rating": 4.9,
        "ratings_total": 3442,
        "type": "Communication"
      },
      {
        "rating": 5,
        "ratings_total": 3561,
        "type": "Shipping time"
      },
      {
        "rating": 5,
        "ratings_total": 3628,
        "type": "Shipping charges"
      }
    ],
    "business_details": [
      {
        "id": "business_name",
        "name": "Business name",
        "value": "Joes Deals LLC"
      },
      {
        "id": "first_name",
        "name": "First name",
        "value": "Joe"
      },
      {
        "id": "last_name",
        "name": "Last name",
        "value": "Smith"
      },
      {
        "id": "address",
        "name": "Address",
        "value": [
          "address line 1",
          "address line 2",
          "address line 3"
        ]
      },
      {
        "id": "business_registration_number",
        "name": "Business registration number",
        "value": "abcdefg"
      },
      {
        "id": "phone",
        "name": "Phone",
        "value": "123456789"
      },
      {
        "id": "fax_number",
        "name": "Fax number",
        "value": "123456789"
      },
      {
        "id": "email",
        "name": "Email",
        "value": "[email protected]"
      }
    ]
  }
}
{
  "request_info": {
    "success": true,
    "credits_used": 1,
    "credits_remaining": 999
  },
  "request_metadata": {
    "id": "f78c211030e249334f2741f37cc7f3a884392054",
    "created_at": "2020-01-01T00:00:00.000Z",
    "processed_at": "2020-01-01T00:00:00.001Z",
    "total_time_taken": 0.1,
    "ebay_url": "https://www.ebay.com/usr/lytecordz"
  },
  "request_parameters": {
    "type": "seller_profile",
    "ebay_domain": "ebay.com",
    "seller_name": "lytecordz"
  },
  "seller": {
    "name": "lytecordz",
    "link": "https://www.ebay.com/usr/lytecordz",
    "member_since": "Jul 02, 2008",
    "postive_ratings_percent": 98.8,
    "followers": 540,
    "reviews": 3,
    "email": "example@example.com",
    "phone": "123456789",
    "location": "United States",
    "image": "https://i.ebayimg.com/00/s/NjkwWDEwMDA=/z/qu4AAOSwCR9cfYLq/$_7.JPG",
    "description": "A great selection of unique and fun smartphone accessories, DVDs, CD, and MORE! Guaranteed 3 day Delivery from Domestic USA Seller! Very responsive to ALL messages! 90 DAY GUARANTEE ON ALL PRODUCTS!",
    "feedback_ratings": {
      "positive": 4233,
      "neutral": 31,
      "negative": 47
    },
    "detailed_seller_ratings": [
      {
        "rating": 4.9,
        "type": "Item as described"
      },
      {
        "rating": 4.9,
        "ratings_total": 3442,
        "type": "Communication"
      },
      {
        "rating": 5,
        "ratings_total": 3561,
        "type": "Shipping time"
      },
      {
        "rating": 5,
        "ratings_total": 3628,
        "type": "Shipping charges"
      }
    ],
    "business_details": [
      {
        "id": "business_name",
        "name": "Business name",
        "value": "Joes Deals LLC"
      },
      {
        "id": "first_name",
        "name": "First name",
        "value": "Joe"
      },
      {
        "id": "last_name",
        "name": "Last name",
        "value": "Smith"
      },
      {
        "id": "address",
        "name": "Address",
        "value": [
          "address line 1",
          "address line 2",
          "address line 3"
        ]
      },
      {
        "id": "business_registration_number",
        "name": "Business registration number",
        "value": "abcdefg"
      },
      {
        "id": "phone",
        "name": "Phone",
        "value": "123456789"
      },
      {
        "id": "fax_number",
        "name": "Fax number",
        "value": "123456789"
      },
      {
        "id": "email",
        "name": "Email",
        "value": "joe.smith@email.com"
      }
    ]
  }
}
﻿
Countdown API returns the following properties for Seller Profile requests:
Property
Type
Description
seller
object
An object containing details of the seller profile.
name
string
The name of the seller.
﻿
link
string
A link to the seller profile page.
﻿
member_since
string
The string containing the date the seller joined.
﻿
feedback_score
number
The Ebay feedback score for the seller.
﻿
positive_ratings_percent
number
A percentage of all ratings that were positive.
﻿
followers
number
The number of followers the seller has.
﻿
reviews
number
The number of reviews this seller has left for others.
﻿
location
string
The location of the seller.
﻿
image
string
A link to the seller profile image.
﻿
description
number
The description of the seller.
﻿
feedback_ratings
object
An object with 3 number properties, positive , neutral and negative showing the total number of positive, neutral and negative ratings received by the seller.
﻿
detailed_seller_ratings
array
Detailed Seller Ratings Array 
The detailed seller ratings property contains an array of detailed seller ratings objects containing details of the rating received for specific types of feedback. The detailed seller ratings object has the following properties:
﻿
rating
number
The rating value (out of 5) of the detailed seller rating.
﻿
ratings_total
number
The total number of ratings received.
﻿
rating
string
The textual description of the detailed seller rating.
﻿
business_details
array
Business Details Array 
The details shown on the "Business Details" popup on the seller profile page. The types of details shown can vary from seller to seller. The business details array has the following properties:
﻿
id
string
The ID of the business detail entry.
﻿
name
string
The free-text name of the business detail entry.
﻿
value
string
The value of the business detail entry.
﻿
Next Steps
     Seller Profile Parameters﻿

Property	Type	Description
seller	object	An object containing details of the seller profile. name string The name of the seller. link string A link to the seller profile page. member_since string The string containing the date the seller joined. feedback_score number The Ebay feedback score for the seller. positive_ratings_percent number A percentage of all ratings that were positive. followers number The number of followers the seller has. reviews number The number of reviews this seller has left for others. location string The location of the seller. image string A link to the seller profile image. description number The description of the seller. feedback_ratings object An object with 3 number properties, positive , neutral and negative showing the total number of positive, neutral and negative ratings received by the seller. detailed_seller_ratings array Detailed Seller Ratings Array The detailed seller ratings property contains an array of detailed seller ratings objects containing details of the rating received for specific types of feedback. The detailed seller ratings object has the following properties: rating number The rating value (out of 5) of the detailed seller rating. ratings_total number The total number of ratings received. rating string The textual description of the detailed seller rating. business_details array Business Details Array The details shown on the "Business Details" popup on the seller profile page. The types of details shown can vary from seller to seller. The business details array has the following properties: id string The ID of the business detail entry. name string The free-text name of the business detail entry. value string The value of the business detail entry.

Updated 04 Sep 2024

Did this page help you?

Reviews

Seller Feedback