Question 1

What kind of product information can I retrieve?

Accepted Answer

The API returns comprehensive product information, including barcode, product name, brand, category, product image, and tax details. Depending on your subscription plan, you can also retrieve supermarket prices and historical price data.

Question 2

Can I search products by both barcode and product name?

Accepted Answer

Yes. The Search API supports both barcode lookups and keyword-based searches. It returns up to 10 matching products and can optionally include supermarket prices and historical pricing information.

Question 3

How can I retrieve supermarket prices?

Accepted Answer

Enable the marketPrices=true parameter to include current prices from supported supermarkets. You can also use the preferredMarkets parameter to limit the response to specific supermarket chains.

Question 4

Can I access historical price data?

Accepted Answer

Yes. Historical pricing is available by enabling historyPrices=true or by using the dedicated History API endpoint. The History API returns the complete chronological price history for a product and can optionally be filtered by supermarket.

Question 5

How are API credits calculated?

Accepted Answer

Credits are charged based on the amount of data returned. Each product costs 1 credit. Every supermarket price included in the response consumes 1 additional credit, and historical price data also consumes 1 additional credit when available. Total usage is reported in the X-Jojapi-Credits-Used response header.

Question 6

Can I filter prices by specific supermarkets?

Accepted Answer

Yes. Use the preferredMarkets parameter to retrieve pricing data only from the supermarkets you specify. This helps reduce unnecessary data transfer and credit consumption.

Question 7

Can I access the product database directly?

Accepted Answer

Eligible subscription plans can generate temporary read-only MySQL credentials. These credentials provide SELECT access to the published database views, expire after 30 days, and are intended for analytics, reporting, and large-scale data access.

Product Barcode API - camgoz.net

Frequently Asked Questions