Skip to main content

Miravia Scraper

info

The Miravia scraper is in beta. Please contact us to report any issue you encounter.

Introduction​

The Miravia scraper provides reliable access to Miravia marketplace data in Spain (miravia.es). Responses use native Miravia website data and can differ from equivalent Lazada response shapes.

Miravia requests use the Lazada task endpoint:

POST /scraping-tasks/lazada/run

Miravia uses the same pricing as Lazada and Daraz. See the Pricing page for current pricing details.

Usage​

request_body='{
  "requests": [
    {
      "url": "https://www.miravia.es/catalog/?q=tshirt",
      "language": "en"
    }
  ]
}'
curl_args=(
  --header "Content-Type: application/json"
  --header "Authorization: Bearer ${token}"
  --request POST
  --data "$request_body"
  https://continuous-scraper.common.chartedapi.com/scraping-tasks/lazada/run
)
curl "${curl_args[@]}"

The Miravia endpoint or page URL is specified inside the request body. Each request is processed independently.

See the API Reference for the complete task API.

Supported APIs​

Product Search by Keyword or Category or Seller​

  • URL Path:
    • https://www.miravia.es/catalog/?q=${keyword}
    • https://www.miravia.es/c/${categorySlug}-${categoryId}/
    • https://www.miravia.es/${sellerKey}/?q=All-Products&from=wangpu&langFlag=en-ES&pageTypeId=2&search_scenario=store&src=store_allproducts&sellerKey=${sellerKey}
warning

Avoid specifying the page parameter in the URL. Miravia requires sequential navigation from the first page. Use productListing_crawlNextPages for multi-page crawling.

  • URL Parameters:

    • keyword: Search keyword, e.g. tshirt.
    • categorySlug: Category slug, e.g. camisetas-para-mujer.
    • categoryId: Category ID, e.g. 100195.
    • sellerKey: Seller key, e.g. inside.

  • Scraper Input Parameters:

    • emulateMobileDevice (default = false): Simulates a mobile browser when set to true.
    • productListing_crawlNextPages (default = false): Enables automatic crawling of subsequent pages.
    • productListing_crawlNextPages_maxPages (optional): Sets a maximum number of pages to crawl.
    • productListing_crawlNextPages_maxUniqueProducts (optional): Sets a maximum number of unique products to return.
    • productListing_crawlNextPages_stopWhenNewPageOnlyContainsDuplicates (default = true): Stops when a page only contains products already returned.
    • productListing_crawlNextPages_stopWhenNoMorePagesIsTrue (default = true): Stops when the response reports that no more pages are available.

  • Example Input:

{
  "requests": [
    { "url": "https://www.miravia.es/catalog/?q=tshirt" },
    { "url": "https://www.miravia.es/c/camisetas-para-mujer-100195/" },
    { "url": "https://www.miravia.es/inside/?q=All-Products&from=wangpu&langFlag=en-ES&pageTypeId=2&search_scenario=store&src=store_allproducts&sellerKey=inside" }
  ]
}

Product Details​

  • URL Path:

    • https://www.miravia.es/p/i${productId}.html
    • https://www.miravia.es/p/${productSlug}-i${productId}.html

  • URL Parameters:

    • productSlug: Optional product slug.
    • productId: Product ID (a.k.a. itemId), e.g. 1374784873099279.

  • Scraper Input Parameters:

    • emulateMobileDevice (default = false): Simulates a mobile browser when set to true. Some fields may differ in this mode.

  • Example Input:

{
  "requests": [
    { "url": "https://www.miravia.es/p/i1374784873099279.html" }
  ]
}

The response body is the raw product fields object embedded by Miravia on the product page. It preserves Miravia's native field names and structure.

Product Reviews​

  • URL Path:

    • https://www.miravia.es/pdp/review/getReviewList?itemId=${productId}

  • URL Parameters:

    • productId: Product ID (a.k.a. itemId), e.g. 1358777607694890.

  • Example Input:

{
  "requests": [
    { "url": "https://www.miravia.es/pdp/review/getReviewList?itemId=1358777607694890" }
  ]
}

The response contains the raw initial product-review object available on the product page. Retrieving later review pages is not currently supported.

Category Tree​

  • URL Path:

    • https://acs-m.miravia.es/h5/mtop.lazada.guided.shopping.categories.categorieslpcommon/1.0/

  • Example Input:

{
  "requests": [
    { "url": "https://acs-m.miravia.es/h5/mtop.lazada.guided.shopping.categories.categorieslpcommon/1.0/" }
  ]
}

The response is Miravia's curated navigation tree. It is not a complete marketplace taxonomy. Intermediate categories can be absent, non-leaf nodes can lack IDs and URLs, and leaf IDs can appear only in category URL slugs.

Seller Details​

  • URL Path:

    • https://www.miravia.es/shop/${sellerKey}/

  • URL Parameters:

    • sellerKey: Seller key, e.g. inside.

  • Scraper Input Parameters:

    • emulateMobileDevice (default = false): Simulates a mobile browser when set to true. Some fields may differ in this mode.

  • Example Input:

{
  "requests": [
    { "url": "https://www.miravia.es/shop/inside/" }
  ]
}

The response contains the raw seller-detail object. The example includes seller ID 4000014096033, shop ID 1138, and seller key inside.

Seller Promoted Products​

  • URL Path:

    • https://www.miravia.es/shop/site/api/shop/campaignTppProducts/query?shopId=${shopId}&sellerId=${sellerId}&itemId=${productId}

  • URL Parameters:

    • shopId: Shop ID, available from Seller Details.
    • sellerId: Seller ID, available from Seller Details.
    • productId: Any product ID from the seller.
    • offset (optional): Result offset. Use offset=20 for the second 20-item page.

  • Example Input:

{
  "requests": [
    { "url": "https://www.miravia.es/shop/site/api/shop/campaignTppProducts/query?shopId=1138&sellerId=4000014096033&itemId=1374784873099279" }
  ]
}

Keyword Listing​

  • URL Path:

    • https://www.miravia.es/sitemap-d7df5b64df1181ef1d62d646a13aaa86.xml?limit=${limit}&offset=${offset}

  • URL Parameters:

    • limit: Number of keyword sub-sitemaps to load.
    • offset: Keyword sub-sitemap offset, typically a multiple of limit.

  • Example Input:

{
  "requests": [
    { "url": "https://www.miravia.es/sitemap-d7df5b64df1181ef1d62d646a13aaa86.xml?limit=1&offset=0" }
  ]
}

The generated-looking sitemap identifier is matched exactly and its long-term stability is unknown. Miravia also publishes a separate product sitemap, but product-sitemap discovery is not part of the current scraper contract.

Unsupported APIs​

Product Reviews V2​

  • Request Method:

    • POST

  • URL Path:

    • https://acs-m.miravia.es/h5/mtop.lazada.review.item.getpcreviewlist/1.0/

This endpoint is unsupported for Miravia. Use Product Reviews for the initial product-review object.

Seller Listing​

  • URL Path:
    • https://www.miravia.es/sitemap-sellers.xml?limit=${limit}&offset=${offset}

This endpoint is unsupported because Miravia does not provide a seller sitemap at this path.

Unsupported requests return HTTP 400, task status ERROR, and an error message beginning with ERROR_UNSUPPORTED_API. They are rejected before execution and are not billed.

Operational Recommendations​

  • Monitor success rates during high-traffic campaigns.
  • Expect stricter anti-bot protections during major sales events.
  • Pause traffic if failures rise unexpectedly.