Tracksellers API

Contact

Tracksellers Support

support@tracksellers.com

License

Apache 2.0

http://www.apache.org/licenses/LICENSE-2.0.html

Terms of Service

https://www.tracksellers.com/terms-and-conditions

API Endpoints

https://www.tracksellers.com/graphql

Headers

# Your API token from the dashboard. Must be included in all API calls.
Authorization: Bearer <YOUR_TOKEN_HERE>

Version

1.0.0

Queries

`allDomains`

Description

Returns all domains

Response

Returns [DomainType]

Example

Query

query allDomains {
  allDomains {
    id
    code
    name
    amazonUrl
  }
}

Response

{
  "data": {
    "allDomains": [
      {"id": 987, "code": "us", "name": "USA", "amazonUrl": "amazon.com"}
    ]
  }
}

Queries

`categoriesForDomain`

Description

Returns all categories for a domain

Response

Returns [CategoryType]

Arguments

Name	Description
`domainCode` - `String!`	Domain code like `us`, `uk` ...

Example

Query

query categoriesForDomain($domainCode: String!) {
  categoriesForDomain(domainCode: $domainCode) {
    id
    domain {
      ...DomainTypeFragment
    }
    name
    display
    lastUpdated
  }
}

Variables

{"domainCode": "us"}

Response

{
  "data": {
    "categoriesForDomain": [
      {
        "id": 172282,
        "domain": DomainType,
        "name": "Electronics",
        "display": true,
        "lastUpdated": "2016-10-07T01:08:03.420Z"
      }
    ]
  }
}

Queries

`sellerSearch`

Description

Advanced seller search

Response

Returns [SellerListType]

Arguments

Name	Description
`queryDict` - `GenericScalar!`	Dictionary of query options
`n` - `Int`	Max results

Example

Query

query sellerSearch(
  $queryDict: GenericScalar!,
  $n: Int
) {
  sellerSearch(
    queryDict: $queryDict,
    n: $n
  ) {
    sellerId
    name
    mainCategory
    rating
    rank
  }
}

Variables

{
  "queryDict": {
    "domain": "us",
    "category_ids": [5174, 172282],
    "rank_lifetime": {"max": 100},
    "reviews_lifetime": {"min": 10000},
    "listings": {"min": 10}
  },
  "n": 25
}

Response

{
  "data": {
    "sellerSearch": [
      {
        "sellerId": "AZQBWXI5F2WWA",
        "name": "imagikids LLC",
        "mainCategory": "Clothing, Shoes & Jewelry",
        "rating": 99,
        "rank": 101
      }
    ]
  }
}

Queries

`topSellersByCategory`

Description

Returns the top sellers for a category within a domain

Response

Returns [SellerListType]

Arguments

Name	Description
`domainCode` - `String!`	Domain code like `us`, `uk` ...
`categoryId` - `Float!`	Category id
`n` - `Int`	Max results

Example

Query

query topSellersByCategory(
  $domainCode: String!,
  $categoryId: Float!,
  $n: Int
) {
  topSellersByCategory(
    domainCode: $domainCode,
    categoryId: $categoryId,
    n: $n
  ) {
    sellerId
    name
    mainCategory
    rating
    rank
  }
}

Variables

{"domainCode": "us", "categoryId": 172282, "n": 25}

Response

{
  "data": {
    "topSellersByCategory": [
      {
        "sellerId": "AZQBWXI5F2WWA",
        "name": "imagikids LLC",
        "mainCategory": "Clothing, Shoes & Jewelry",
        "rating": 99,
        "rank": 101
      }
    ]
  }
}

Queries

`topSellersByDomain`

Description

Returns the top sellers for a domain

Response

Returns [SellerListType]

Arguments

Name	Description
`domainCode` - `String!`	Domain code like `us`, `uk` ...
`n` - `Int`	Max results

Example

Query

query topSellersByDomain(
  $domainCode: String!,
  $n: Int
) {
  topSellersByDomain(
    domainCode: $domainCode,
    n: $n
  ) {
    sellerId
    name
    mainCategory
    rating
    rank
  }
}

Variables

{"domainCode": "us", "n": 25}

Response

{
  "data": {
    "topSellersByDomain": [
      {
        "sellerId": "AZQBWXI5F2WWA",
        "name": "imagikids LLC",
        "mainCategory": "Clothing, Shoes & Jewelry",
        "rating": 99,
        "rank": 101
      }
    ]
  }
}

Types

Boolean

Description

The Boolean scalar type represents true or false.

Types

CategoryType

Fields

Field Name	Description
`id` - `Float!`
`domain` - `DomainType!`
`name` - `String!`
`display` - `Boolean`
`lastUpdated` - `Date!`

Example

{
  "id": 172282,
  "domain": DomainType,
  "name": "Electronics",
  "display": true,
  "lastUpdated": "2016-10-07T01:08:03.420Z"
}

Types

Date

Description

The Date scalar type represents a Date value as specified by iso8601.

Example

"2016-10-07T01:08:03.420Z"

Types

DomainType

Fields

Field Name	Description
`id` - `Int!`
`code` - `String!`
`name` - `String!`
`amazonUrl` - `String!`

Example

{"id": 987, "code": "us", "name": "USA", "amazonUrl": "amazon.com"}

Types

Float

Description

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Example

987.65

Types

GenericScalar

Description

The GenericScalar scalar type represents a generic GraphQL scalar value that could be: String, Boolean, Int, Float, List or Object.

Example

{"key1": "val1", "key2": "val2", "complex_key": {"key1": "val1"}}

Types

Int

Description

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example

Types

SellerListType

Fields

Field Name	Description
`sellerId` - `String`
`name` - `String`
`mainCategory` - `String`
`rating` - `Float`
`rank` - `Int`

Example

{
  "sellerId": "AZQBWXI5F2WWA",
  "name": "imagikids LLC",
  "mainCategory": "Clothing, Shoes & Jewelry",
  "rating": 99,
  "rank": 101
}

Types

String

Description

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example

"abc123"

Documentation by Anvil SpectaQL