Integração via API

A integração via API está disponível apenas no plano Premium.

As requisições à API são autenticadas usando sua chave de API. Inclua sua chave de API no cabeçalho X-API-Key em cada requisição. Contate o suporte para obter a sua.

URL Base

Todos os endpoints da API são relativos a: https://itsgot.com

Paginação

Para endpoints que suportam paginação, as URLs da próxima página e da página anterior podem ser encontradas no cabeçalho Link da resposta HTTP.

Recuperar Produtos

GET /api/products

Parâmetros de Consulta:

• sku - O SKU da variante (opcional)
• barcode - O código de barras da variante (opcional)
• external_product_id - ID do produto na Shopify (opcional)
• external_variant_id - ID da variante na Shopify (opcional)
• page - Página a recuperar (opcional)
• per_page - Número de produtos retornados por página, deve ser um dos seguintes: 10, 25, 50, 100 (opcional, o padrão é 10)

Exemplo usando curl:

curl -H 'X-API-Key: ***' 'https://itsgot.com/api/products?sku=JARFOOD'

Resposta (200 OK):

[
  {
    "id": 1,
    "name": "Jar of Food",
    "rating": 0.0,
    "external_product_id": 123123123,
    "variants": [
      {
        "name": "Spicy",
        "size": null,
        "servings_per_container": "1",
        "serving_size": null,
        "ingredients": null,
        "barcode": "834325",
        "external_variant_id": 789789789,
        "warnings": null,
        "instructions": null,
        "claims": null,
        "sku": "JARFOOD",
        "origin_countries": null,
        "allergens": null,
        "created_at": "2026-07-30T13:32:38Z",
        "updated_at": "2026-07-30T13:36:08Z",
        "kosher": false,
        "halal": false,
        "glatt_kosher": true,
        "organic": false,
        "dairy": false,
        "parve": true,
        "vegan": true,
        "vegetarian": true,
        "gmos": null,
        "gluten": null,
        "wheat": null,
        "preservatives": null,
        "artificial_colors": null,
        "artificial_flavors": null,
        "casein": null,
        "egg": null,
        "soy": null,
        "shellfish": null,
        "tree_nuts": null,
        "peanuts": null,
        "fish": null,
        "seeds": null,
        "milk": null,
        "nitrates": null,
        "nitrites": null,
        "sesame": null,
        "coconut": null,
        "rbst": null,
        "rbgh": null,
        "celery": null,
        "translations": {},
        "nutrition": [
          {
            "id": 1,
            "calories": 28,
            "calories_from_fat": null,
            "calories_from_saturated_fat": null,
            "comments": "Per 100g",
            "number": 1,
            "kilojoules": 114,
            "created_at": "2026-08-04T18:48:07Z",
            "updated_at": "2026-08-04T18:48:07Z",
            "data": [
              {
                "id": 1,
                "percent_allowance": null,
                "comments": null,
                "components": null,
                "quantity": {
                  "value": "1",
                  "unit": "mg"
                },
                "type": "nutrient",
                "source": {
                  "id": 10,
                  "name": "Iron",
                  "translations": []
                },
                "created_at": "2026-08-04T18:48:07Z",
                "updated_at": "2026-08-04T18:48:07Z"
              },
              {
                "id": 2,
                "percent_allowance": null,
                "comments": null,
                "components": null,
                "quantity": {
                  "value": "2",
                  "unit": "g"
                },
                "type": "nutrient",
                "source": {
                  "id": 8,
                  "name": "Protein",
                  "translations": []
                },
                "created_at": "2026-08-04T18:48:07Z",
                "updated_at": "2026-08-04T18:48:07Z"
              }
            ]
          }
        ],
        "labels": [
          {
            "id": 10,
            "format": "au_nutrition_facts_vertical",
            "locale": "en-AU",
            "target_device": null
          }
        ]
      }
    ]
  }
]

Exportar um Rótulo para um Formato Específico

GET /api/products/PRODUCT_ID/labels/LABEL_ID/export.FORMAT

Parâmetros obrigatórios:

• PRODUCT_ID - ID do produto cujo rótulo você deseja exportar
• LABEL_ID - ID do rótulo que você deseja exportar
• FORMAT - Formato para exportar. Um dos seguintes: png, jpg, pdf ou html

Parâmetros de consulta opcionais:

• width - Somente para imagens. Exporta o rótulo com a largura fornecida. O padrão é a largura do rótulo x 2.
• height - Somente para imagens. Exporta o rótulo com a altura fornecida. Por padrão, a proporção é mantida e a altura é baseada na largura fornecida.
• background_color - Somente para imagens. Cor de fundo a usar se o rótulo for redimensionado e não mantiver mais sua proporção

Exemplo usando curl:

curl -H 'X-API-Key: ***' 'https://itsgot.com/api/products/123/labels/789/export.jpg' > product.jpg