Autohome 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.

Autohome Car Listing is a source-locked Mainland China vehicle catalog API that searches Autohome by make, model, or series keyword and publishes a normalized 35-field Dataset.

• Mainland China-only public country: the focused input cannot route a run to unrelated international marketplaces.
• Automatic Autohome source lock: every focused run is restricted to the named catalog source.
• Source-accurate catalog scope: the adapter returns vehicle series and specification records, not a promise of live used-car inventory.
• 35 documented output fields: unavailable source values remain empty instead of becoming inferred facts.

Run a one-result test · View API

For the smallest controlled test, set max_results to 1 and budget at most $0.02250 on the FREE tier for one published result plus Actor Start. The public Store and API destinations were not live during the July 21, 2026 audit, so publication must be confirmed before launch.

What does Autohome Car Listing do?

Autohome Car Listing submits a keyword to Autohome's public search service and normalizes qualifying vehicle series and specification responses. A record can contain a series name, specification or trim, guide price text, currency, model year, manufacturer, body structure, transmission, engine or displacement information, image, listing identifier, and a direct Autohome URL when those values are returned.

This is a catalog-oriented search surface. It must not be marketed as a guaranteed used-car inventory feed, dealer-lead database, VIN history service, or live transaction-price source. The source adapter reads official series/specification data, and many listing-oriented fields in the shared 35-field schema can therefore be empty.

The runtime now locks this focused Actor to Autohome before applying country and query-capability checks. Its public schema contains no platform selector, and input cannot broaden a run to Dongchedi. Global Car Listing remains the appropriate product for intentional multi-source China research.

The Actor is not affiliated with Autohome. Verify important facts on source_url, especially prices and specifications that may change after collection.

How do I run Autohome Car Listing?

1. Open the Autohome Car Listing input page.
2. Keep country set to Mainland China and enter a Chinese or source-recognized vehicle keyword such as 凯美瑞.
3. Set max_results to 1 and start the Actor.
4. Confirm that platform is Autohome, then inspect source_url before increasing volume.

Every runnable example in this README uses this controlled input:

{
  "country": "Mainland China",
  "keyword": "凯美瑞",
  "max_results": 1
}

The keyword is trimmed but not translated, expanded, or replaced. max_results is the Autohome run ceiling, not a promise that the source will return that many publishable records.

What data does Autohome Car Listing return?

Each Dataset item follows a 35-field shared vehicle schema. Autohome catalog responses normally populate only the subset supported by a matched series or specification.

Field group	Public fields	Meaning
Vehicle identity	title, year, make, model, trim, listing_id	Series, specification, manufacturer, and source identifier.
Price	price, currency, price_text	Parsed or source-formatted guide price and CNY currency when supplied.
Specifications	body_type, transmission, engine, fuel, drive_type, condition, mileage, mileage_unit, exterior_color, interior_color, vin	Source-published details; unsupported values remain empty.
Images and text	main_image, images, description	Official image and combined catalog attributes when available.
Seller and market	seller, seller_type, location, country, platform	Manufacturer or factory context, country, and exact route attribution.
Links and dates	source_url, platform_url, official_url, posted_at, updated_at	Source traceability and dates when exposed.
Processing	processor, processed_at	Actor attribution and UTC processing timestamp.

This abbreviated example illustrates the contract without claiming a live source response:

{
  "title": "凯美瑞 2026款 双擎 2.0HGVP 豪华版",
  "price": 199800,
  "currency": "CNY",
  "year": 2026,
  "make": "丰田",
  "model": "凯美瑞",
  "trim": "双擎 2.0HGVP 豪华版",
  "body_type": "中型车",
  "transmission": "E-CVT",
  "country": "China",
  "platform": "Autohome",
  "source_url": "https://www.autohome.com.cn/spec/example/",
  "processor": "https://apify.com/username/actor_name",
  "processed_at": "2026-07-21T12:00:00Z"
}

Exports are available through the formats supported by the current Dataset items API, including JSON, JSONL, CSV, Excel, XML, HTML, and RSS.

What inputs can I configure?

Input	Type	Required	Accepted value and effect
country	string	Yes	Mainland China, the only public market for this release.
keyword	string	Yes	A non-empty vehicle make, model, or series phrase sent without translation.
max_results	integer	Yes	From 1 to 10,000, applied to the source-locked Autohome run.

Country, keyword, and max results form the complete public contract. Source selection is absent because the focused runtime enforces Autohome and does not accept a user override.

location is not exposed. The Autohome adapter uses a countrywide official search request with cityid set to zero and does not apply a user-supplied city as a native listing filter.

What platforms and markets does Autohome Car Listing cover?

The public market is Mainland China. The named source is Autohome search, whose official search results can expose vehicle series and specification information. The adapter identifies records from Autohome, reports the record country as China, and preserves official destination URLs where available.

The focused runtime admits only the autohome route. Dongchedi remains available through Global Car Listing but is not selectable or reachable through this Actor.

This focused Actor does not cover other countries. Use Global Car Listing for multi-market research. Source response shapes, inventory, prices, and field completeness can change independently of the Actor.

Why use Autohome Car Listing?

Verified capability	Practical benefit
Automatic Autohome source lock	Keep the runnable platform set on the named route without a user filter.
Mainland China-focused input	Prevent accidental selection of unrelated international sources.
Normalized 35-field Dataset	Load repeat runs into stable columns even when fields are absent.
Direct official URLs	Review the vehicle series or specification page before acting.
Per-result billing	Relate most run cost to records actually written to the Dataset.

The main trade-off is catalog scope: the Actor is source-specific, but it returns series/specification data rather than guaranteeing live used-car inventory.

Who is Autohome Car Listing for?

Autohome Car Listing is intended for developers, automotive analysts, product researchers, catalog teams, and China-market data operations that need repeatable Autohome series/specification search. Typical uses include model discovery, guide-price sampling, trim comparison, manufacturer catalog review, search-result monitoring, source-link verification queues, and normalized exports for internal analysis.

It is not the right tool for buyers who require inspection results, verified transaction prices, ownership history, current dealer stock, contact enrichment, or every field shown on an Autohome page. Those tasks need independent sources and verification.

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

The intended owner/name identifier is truefetch/autohome-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 integrating.

The current synchronous endpoint accepts the tilde-separated owner and Actor name:

curl -L "https://api.apify.com/v2/actors/truefetch~autohome-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": "Mainland China",
    "keyword": "凯美瑞",
    "max_results": 1
  }'

Review the official synchronous Actor run endpoint for authentication, timeout, and charge-limiting options.

Apify currently documents a hosted Streamable HTTP MCP server:

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

After publication, ask the MCP client to find truefetch/autohome-car-listing, inspect its schema, run the one-result 凯美瑞 scenario, and retrieve the Dataset item. Autohome is selected automatically. Running Actors requires authentication. See the Apify MCP server guide.

How much does Autohome Car Listing cost?

The Actor uses pay-per-event pricing. Actor Start is charged when a run begins, and one result event is charged for each 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.01250	One published Dataset item.
Result - BRONZE	$0.01208	One published Dataset item.
Result - SILVER	$0.01167	One published Dataset item.
Result - GOLD	$0.01125	One published Dataset item.
Result - PLATINUM	$0.01125	One published Dataset item.
Result - DIAMOND	$0.01125	One published Dataset item.

On the FREE tier, one published Autohome result costs $0.01000 + $0.01250 = $0.02250. An empty run can still incur Actor Start. Each Autohome record written to the default Dataset creates one result event. Confirm live Store pricing after publication.

How does Autohome Car Listing compare with alternatives?

Option	Best fit	Trade-off
Autohome Car Listing	Repeatable source-locked Autohome catalog search with normalized fields.	It is not a guaranteed live inventory feed.
Global Car Listing	Multi-country or multi-source automotive research.	Broader routing is unnecessary for an Autohome-only task.
Manual Autohome search	One-off research with full page context.	Difficult to schedule, export, or normalize repeatedly.
Dedicated Autohome integration	Teams requiring every source-specific field and workflow.	Higher maintenance and schema-mapping cost.

Choose this Actor when normalized Autohome catalog records fit the workflow. Do not choose it as a substitute for a live used-car stock feed.

What are the limits and troubleshooting steps?

Symptom or limit	Explanation and next step
A result identifies Dongchedi or another source	Treat it as a source-lock regression; stop scaling and send the run ID plus source URL to support.
No dealer, mileage, or VIN data	The source route returns series/specification catalog records, not guaranteed used-car listings.
Input rejects another country	Mainland China is the only public country for this focused release.
Fewer records arrive than requested	max_results is a ceiling; the live search response determines publishable records.
Some normalized fields are empty	Autohome does not expose every shared vehicle field for every series/specification.
A source URL changes or disappears	Source pages can be updated after collection; rerun and treat older output as historical.

For support, send the run ID, exact input, expected platform, and one public source URL. Never send API tokens or private data.

Frequently asked questions

Which inputs are required?

country, keyword, and max_results are required. No platform selector is exposed.

Can I select Dongchedi instead?

No. This focused Actor is locked to Autohome. Use Global Car Listing when Dongchedi or multi-source China coverage is required.

Does this return used-car listings?

The audited Autohome adapter returns official vehicle series and specification search records. It does not guarantee live used-car inventory.

Can I filter by city?

No. The public schema omits location because the adapter performs a countrywide Autohome catalog search.

Why are fields empty?

The 35-field schema is shared across vehicle sources, while an Autohome catalog record exposes only a subset.

Can I schedule the Actor?

Yes. Scheduled inputs use the same three fields, and the Actor remains source-locked to Autohome.

How is billing counted?

Each Dataset item triggers one result event; Actor Start is billed separately.

Are legacy Store statistics used as proof?

No. The user identified online data as old, and no current TrueFetch Store record was available during verification.

Related TrueFetch Actors

• Global Car Listing is the correct choice for multi-country or multi-source automotive research.
• CarDekho Car Listing focuses its public input on India vehicle sources.
• Webmotors Car Listing focuses on Brazilian vehicle inventory research.

These related project directories were verified locally. Their public links must be checked again after publication.

Support and last updated

• Store: Autohome Car Listing
• API: Autohome Car Listing API
• Source: Autohome search
• Apify help: Apify documentation
• Community: TrueFetch Telegram group
• Direct support: AiAgentApi support

Verified against local schemas, pricing metadata, source-lock regression evidence, and the public Autohome surface on July 21, 2026. Local Autohome-only routing now passes; unresolved Store/API links remain a publication gate.

Test one Autohome result · Review the API surface