Skip to content

Collectibles Recognition

PRICING DEMO TAXONOMY

This page describes API of Collectibles Recognition service for images. This service provides basic analysing of photos with collectible items. The API method first detect all collectible items on a photo recognizes their types (Stamps, Coins, Banknotes, Comics and Cards).

If a trading card is detected then the card is further analyzed to recognize the card Category (Sport Card or Trading Card Game), Subcategory (Baseball, Football, Pokémon, Magic The Gathering, ...), Languague (International or Japanese), etc. The full taxonomy is here.

The API follows the general rules of Ximilar API as described in Section First steps. Collectibles Recognition is available only in Business and Professional pricing plans.

More Detailed Analysis/Visual Search

If you are looking for a more detailed analysis of collector items, e.g.:

  • you are missing a specific feature and would like to add it to this endpoint,
  • you want to automatically read text/name from banknote/coin/trading cards/etc.,
  • you want to do automatic visual inspection and grading of collector items,
  • you want visual search or identification of the stamp, comics, posters, vinyl covers, cards, etc.,

then please contact us at care@ximilar.com and we can create a customized soluton for your business.

Try the service in Ximilar App or Demo

In order to get access to the Collectibles Recognition service, please register at https://app.ximilar.com. In the app pick "Ready-To-Use Image Recognition" on the main dashboard and then Collectibles Recognition. You must have at least business plan to access this service. A public demo is to be launched soon at demo.ximilar.com.

BETA / TESTING

This service is in BETA version. Be aware that some changes for this endpoint are possible in the future.

This service API has one endpoint running at URL:

https://api.ximilar.com/tagging/collectibles/v2/process

Collectibles Recognition /v2/process

Given a list of image records, this method returns and objects of collector's items for each of them. The result images with _objects (with _tags) and Graded Slab fields, which represents location of the detected items and if the item is in graded sleeve/package.

Parameters:

  • records: list of photos to upscale for
    • must contain either of _url or _base64 field - see section image data for details

$ curl https://api.ximilar.com/tagging/collectibles/v2/process -H "Content-Type: application/json" -H "Authorization: Token __API_TOKEN__" -d '{
    "records": [
        { "_url": "https://images.ximilar.com/examples/cards/jordan.jpeg"}
    ]
}'

Returns:

  • HTTP error code 2XX, if the method was OK and other HTTP error code, if the method failed.
  • Body of the response is a JSON object (map) with the following fields:
    • status - a JSON map with a status of the method processing. It contains these subfields:
      • code - a numeric code of the operation status; it follows the concept of HTTP status codes (2XX, 4XX). Specific codes are described for each type of answer (or operation) (see below).
      • text - a text describing the status code
      • error_description - in case of the processing ended with error (codes 4XX), this field contains a detailed description of the error; this might include Java stack traces.
    • Example of statuses that can be returned:
      "status": {"code": 200, "text": "OK"}
      "status": {"code": 402, "text": "aborted by error", error_description="..."}
      "status": {"code": 500, "text": "unknown error", "error_description": "..."}
    • statistics - a map of various statistics about the processing. The only statistic included every time is
      • processing time - time of actual processing of the query [in seconds]
    • records - JSON array with the input records, each record enriched by fields, Graded Slab and _objects with _tags
CLICK TO SHOW JSON RESULT

{
    "records": [
        {
            "_url": "https://images.ximilar.com/examples/cards/jordan.jpeg",
            "_status": {
                "code": 200,
                "text": "OK",
                "request_id": "b528b51b-435f-480c-bb17-a2f597340d85"
            },
            "_id": "97480960-be47-43c2-b10b-49a3052d8d70",
            "_width": 954,
            "_height": 1516,
            "_objects": [
                {
                    "name": "Card",
                    "id": "76fa9ec3-e0d9-408a-b582-55a1cd6712e0",
                    "bound_box": [
                        83,
                        343,
                        862,
                        1445
                    ],
                    "prob": 0.9307230114936829,
                    "area": 0.5935693621634778,
                    "Top Category": "Card",
                    "_tags": {
                        "Category": [
                            {
                                "prob": 0.96291,
                                "name": "Card/Sport Card",
                                "id": "a5634621-4a37-4b37-aa3d-720b2d6b35ec"
                            }
                        ],
                        "Subcategory": [
                            {
                                "prob": 0.98437,
                                "name": "basketball",
                                "id": "b8ccec14-4d8a-4b26-83a2-6cc690845ba4"
                            }
                        ],
                        "Side": [
                            {
                                "prob": 0.96881,
                                "name": "front",
                                "id": "651c8141-2b18-479b-a8b1-b959bc34b729"
                            }
                        ],
                        "Autograph": [
                            {
                                "prob": 0.94523,
                                "name": "not autograph",
                                "id": "5c1bb98b-cd69-42c9-ab2a-75e480ffa2b0"
                            }
                        ],
                        "Top Category": [
                            {
                                "id": "8ae26c4a-ae79-4c01-9b54-ac4e2b42e914",
                                "name": "Card",
                                "prob": 1.0
                            }
                        ]
                    },
                    "_tags_simple": [
                        "not autograph",
                        "front",
                        "Card/Sport Card",
                        "basketball",
                        "Card"
                    ],
                    "Category": "Card/Sport Card"
                }
            ],
            "Graded Slab": [
                {
                    "prob": 0.95904,
                    "name": "yes",
                    "id": "9d7bf709-dfbc-4595-91be-a9d779b5f33c"
                },
                {
                    "prob": 0.04096,
                    "name": "no",
                    "id": "3a532911-7d7c-4b9b-8442-f0f293952be6"
                }
            ]
        }
    ],
    "status": {
        "code": 200,
        "text": "OK",
        "request_id": "b528b51b-435f-480c-bb17-a2f597340d85",
        "proc_id": "de2b192f-5e9b-4998-8152-f6b9008a1bc3"
    },
    "statistics": {
        "processing time": 13.916424751281738
    }
}