28car Car Listing

Affiliate disclosure: Apify Store links in this README use the fpr=aiagentapi referral parameter, which may attribute a signup or purchase without changing your price.

28car Car Listing is a Hong Kong vehicle listings API that searches public 28car sale records by keyword and returns a normalized 35-field Dataset for pricing, inventory, and automotive market research.

• Automatic 28car source lock: every focused run is restricted to the named marketplace.
• One verified market: the public input is restricted to Hong Kong, the country route supported by 28car.
• Three required inputs: country, keyword, and a per-run result ceiling keep the first test predictable.
• 35 documented output fields: unavailable source values stay empty instead of being presented as inferred facts.

Run a one-result test · View API

Set max_results to 1 for the smallest useful test; on the FREE tier, one published result plus Actor Start costs at most $0.02150 before any platform-level adjustments.

What does 28car Car Listing do?

28car Car Listing sends a vehicle keyword to the public 28car marketplace and converts publishable Hong Kong sale records into a consistent Apify Dataset. A result can include the listing title, HKD price, make, model, year, fuel, engine, transmission, source identifier, and direct listing URL when those values appear on the source page. The remaining normalized fields are present in the Dataset contract but can be empty.

The Actor is designed for public listing discovery and analysis. It is not affiliated with 28car, and it does not provide a vehicle inspection, ownership history, accident report, title guarantee, appraisal, financing decision, or private seller database. It does not translate the search phrase or source text. Users should open source_url and independently verify any record before making a purchase, compliance, or commercial decision.

The current release intentionally exposes only the inputs that produce a valid 28car search: Hong Kong, a non-empty keyword, and a result limit.

How do I run 28car Car Listing?

1. Open the 28car Car Listing input page.
2. Keep country set to Hong Kong, enter a make or model phrase in keyword, and set max_results to 1 for the first run.
3. Start the Actor and wait for the default Dataset to contain a record.
4. Open the returned source_url to verify the original listing, then increase max_results only if the sample matches your use case.

All examples in this README use the same Toyota search:

{
  "country": "Hong Kong",
  "keyword": "Toyota",
  "max_results": 1
}

The keyword is trimmed and sent without automatic translation, expansion, or substitution. max_results is a ceiling rather than a promise: 28car may have fewer publishable matching listings at the time of the run.

What data does 28car Car Listing return?

Each Dataset item follows the same 35-field schema. Source-provided values vary by listing, so a field that is documented does not imply that every 28car record contains it.

Field group	Public fields	Meaning
Listing identity	title, listing_id, vin, description	Listing text and identifiers when exposed.
Images	main_image, images	Primary image and image list when available.
Price	price, currency, price_text	Parsed amount, source currency, and original price text.
Vehicle identity	year, make, model, trim, condition	Model-year and source-published vehicle identity.
Specifications	mileage, mileage_unit, body_type, fuel, transmission, engine, drive_type, exterior_color, interior_color	Odometer and specification values when present.
Seller and market	seller, seller_type, location, country, platform	Public seller context and source attribution.
Links and dates	source_url, platform_url, official_url, posted_at, updated_at	Traceability links and source timestamps.
Processing	processor, processed_at	Actor attribution and processing time.

This abbreviated, illustrative item uses the same Toyota scenario:

{
  "title": "TOYOTA PRIUS HYBRID",
  "price": 138000,
  "currency": "HKD",
  "year": 2021,
  "make": "TOYOTA",
  "model": "PRIUS",
  "fuel": "HYBRID",
  "transmission": "AT",
  "country": "Hong Kong",
  "platform": "28car",
  "source_url": "https://m.28car.com/sell_dsp.php?h_vid=000000",
  "processor": "https://apify.com/username/actor_name",
  "processed_at": "2026-07-21T12:00:00Z"
}

Apify Datasets support exports such as JSON, JSONL, CSV, Excel, XML, HTML, and RSS through the current Dataset items API.

What inputs can I configure?

Input	Type	Required	Accepted value and effect
country	string	Yes	Hong Kong. This is the only public country value because it is the 28car route.
keyword	string	Yes	A non-empty vehicle phrase such as Toyota, sent without translation or replacement.
max_results	integer	Yes	From 1 to 10,000; the maximum number of publishable 28car records returned.

The focused schema does not expose a platform selector because the runtime locks this Actor to 28car before routing. It also does not expose a location input because the verified 28car route does not support source-native location filtering. This prevents a user from entering a city or platform choice that the focused Actor cannot honor.

Required fields include visible examples, while no hidden fallback invents a different keyword or market. For a low-risk start, keep the Hong Kong country value, use a broad make such as Toyota, and request one result.

What platforms and markets does 28car Car Listing cover?

28car Car Listing covers one public source, 28car, and one market, Hong Kong. The 28car site presents vehicle-sale records for private and dealer activity, while individual listings can contain Traditional Chinese or English text depending on the seller and page. The Actor preserves source text rather than promising a translation.

The market restriction is deliberate. This Actor is not a global vehicle aggregator and does not search Cars.com, CarGurus, mobile.de, CarDekho, Webmotors, or other marketplaces. Use Global Car Listing when the task requires country-aware selection across multiple vehicle sources.

Source availability can change independently of the Actor. A valid Hong Kong keyword can return fewer results when matching 28car inventory is limited, listings have been removed, or source pages do not contain enough information to create a publishable record.

Why use 28car Car Listing?

Verified capability	Practical benefit
Focused 28car attribution	Build a Hong Kong sample without mixing records from other marketplaces.
Direct source_url on publishable records	Review the original listing before accepting a price or vehicle detail.
Parsed HKD amounts	Compare numeric asking prices without relying only on formatted price text.
One 35-field contract	Load repeated runs into the same table even when individual optional fields are empty.
Per-result billing	Relate most of the Actor cost to records written to the default Dataset.

The main trade-off is breadth. A focused source simplifies attribution, but it cannot replace multi-market coverage or a source-specific detail service. It is best when 28car is the intended evidence source, not merely one option among many.

Who is 28car Car Listing for?

28car Car Listing is intended for developers, automotive analysts, Hong Kong dealer researchers, pricing teams, inventory monitors, and data operations specialists who need a repeatable sample of public 28car records. Typical projects include asking-price comparisons, make/model availability checks, inventory snapshots, source-link review queues, and scheduled research exports.

The Actor also suits spreadsheet users who want a one-result manual test before moving to API or scheduled execution. It is not appropriate for buyers seeking a mechanical inspection, teams requiring private contact enrichment, or users who need guaranteed vehicle history, exact real-time stock, or market-wide coverage beyond 28car.

How can I use 28car Car Listing through the API or MCP?

The canonical owner/name identifier derived from this release is truefetch/28car-car-listing. The public Store API did not return a current record for that identifier on July 21, 2026, so a numeric Actor ID and live Store proof are intentionally omitted. Verify publication before using the Actor-specific endpoints below.

The current Apify API accepts a numeric Actor ID or a tilde-separated owner and Actor name. This synchronous example uses the shared Toyota input and places the token in the authorization header:

curl -L "https://api.apify.com/v2/actors/truefetch~28car-car-listing/run-sync-get-dataset-items?maxItems=1" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <APIFY_TOKEN>" \
  -d '{
    "country": "Hong Kong",
    "keyword": "Toyota",
    "max_results": 1
  }'

Review the official synchronous Actor run documentation before using timeout, output, or charge-limiting parameters.

Apify currently recommends its hosted Streamable HTTP MCP server for compatible AI clients:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=actors,docs"
    }
  }
}

After publication, instruct the MCP client to find truefetch/28car-car-listing, inspect the input schema, run the one-result Toyota scenario, and retrieve the Dataset item. Actor execution requires authentication. See the current Apify MCP server guide for supported transports and tool selection.

How much does 28car Car Listing cost?

28car Car Listing uses pay-per-event pricing. Actor Start is charged once when a run begins, and result is charged once for each vehicle record written to the default Dataset.

Billed event and tier	Price per event	Billing unit
Actor Start	$0.01000	One Actor run start.
Result - FREE	$0.01150	One published Dataset item.
Result - BRONZE	$0.01112	One published Dataset item.
Result - SILVER	$0.01073	One published Dataset item.
Result - GOLD	$0.01035	One published Dataset item.
Result - PLATINUM	$0.01035	One published Dataset item.
Result - DIAMOND	$0.01035	One published Dataset item.

On the FREE tier, one published result costs $0.01000 + $0.01150 = $0.02150. A run that publishes no record can still incur Actor Start. Verify the live pricing surface after publication because Store prices can change.

How does 28car Car Listing compare with alternatives?

Option	Best fit	Trade-off
28car Car Listing	Focused, repeatable 28car research with normalized output.	Limited to one Hong Kong marketplace.
Global Car Listing	Cross-market work using country-aware platform selection.	Broader routing can be unnecessary for a 28car-only task.
Manual 28car browsing	One-off review where a person needs full page context.	Difficult to schedule, export, or compare repeatedly.
Separate custom integration	Teams that need source-specific fields beyond this public schema.	Requires ongoing maintenance and normalization.

Choose this Actor when the record must be attributable to 28car. Choose the global Actor when source breadth matters more than single-market focus.

What are the limits and troubleshooting steps?

Symptom or limit	Explanation and next step
Input rejects another country	Hong Kong is the only public market for this focused Actor; use Global Car Listing for another country.
A location cannot be entered	The 28car route has no verified source-native location filter, so the public schema intentionally omits it.
No records match	Try a broader make keyword such as Toyota, keep max_results at 1, and verify that matching listings exist on 28car.
Some fields are empty	28car listings do not expose every normalized field. Use source_url to review the source record.
Chinese source text appears	The Actor preserves source text and does not promise translation. Translate downstream if your workflow requires it.
A source URL no longer opens	Listings can be edited or removed after collection; rerun the search and treat the old record as historical.
The run publishes fewer than requested	max_results is a maximum, not a guaranteed inventory count.

For a reproducible support report, include the run ID, the exact keyword, max_results: 1, and whether a matching public 28car page was visible. Never include an Apify token or private seller information.

Frequently asked questions

Which inputs are required?

All three public inputs are required: country, keyword, and max_results.

Can I choose a country outside Hong Kong?

No. This focused Actor exposes only Hong Kong because that is the verified 28car market route.

Can I filter by district or postcode?

No verified source-native location filter is exposed. Use a precise vehicle keyword and review the listing location fields when they are available.

Does the Actor translate Chinese listing text?

No. Keywords and source text are not translated or replaced.

Why are VIN, mileage, seller, or image fields sometimes empty?

Those values are optional in the normalized schema and remain empty when the source record does not expose them.

How is a result charge counted?

One result event is charged for each record written to the default Dataset. Actor Start is billed separately once per run.

Can I schedule recurring 28car searches?

Yes. Apify supports schedules, but every scheduled execution is a new run and source inventory can change between runs.

Are old Store statistics used as proof here?

No. The public TrueFetch Store record was unavailable during verification, and the user identified existing online data as legacy. No old run, user, rating, or review count is presented as current evidence.

Related TrueFetch Actors

• Global Car Listing adds country-aware routing across multiple vehicle marketplaces when 28car alone is too narrow.
• CarDekho Car Listing focuses on India for CarDekho-specific vehicle research.
• Webmotors Car Listing focuses on Brazil for Webmotors-specific inventory and pricing work.

These three related project directories were verified in the current audit scope. Their public destinations must be rechecked after publication.

Support and last updated

• Store: 28car Car Listing
• API: 28car Car Listing API
• Source: 28car
• Apify platform help: Apify documentation
• Community: TrueFetch Telegram group
• Direct support: AiAgentApi support

Verified against the local schemas, pricing metadata, source-lock regression evidence, and the public 28car surface on July 21, 2026. Local 28car-only routing passes; Store, API, and related Actor destinations remain a pre-publication validation gate.

Test one 28car result · Review the API surface