Administrar gráficos

Los gráficos hechos con cualquier key de tu organización, con POST /v1/charts. Ninguno de estos pedidos se cobra. Los gráficos guardados vencen a los 90 días con pago por uso y nunca con el plan mensual de créditos (expires_at); uno vencido o borrado responde 404 chart_not_found.

Listar gráficos

GEThttps://api.typesearch.ai/v1/charts

Tus gráficos, del más nuevo al más viejo, de a una página.

Consulta

Parámetro	Tipo
`limit`	integer	Cuántos, de 1 a 100. Por defecto: `20`.
`before`	string	El `next_before` de la página anterior.

Respuesta

object"list"
Siempre list.
dataobject[]
Los gráficos de tu organización, del más nuevo al más viejo.
Ver los campos
- idstring
  El id del gráfico.
- typestring
  El tipo de gráfico.
- titlestring
  Su título.
- themestring
  Su tema.
- localestring
  Su idioma.
- created_atstring
  Cuándo se creó.
- expires_atstring | null
  Cuándo vence, o null si nunca vence.
- embed_urlstring
  La página para un iframe.
- image_urlstring
  La PNG.
- svg_urlstring
  El SVG.
has_moreboolean
Si hay gráficos más viejos.
next_beforestring | null
Pásalo como before para la página siguiente. null en la última.

curl "https://api.typesearch.ai/v1/charts?limit=2" \
  -H "Authorization: Bearer $TYPESEARCH_API_KEY"

200 OK

{
  "object": "list",
  "data": [
    {
      "id": "chart_8k2m9q4x7w1p3n5z",
      "type": "line",
      "title": "El dólar blue subió 4,1 % en la semana",
      "theme": "light",
      "locale": "es",
      "created_at": "2026-09-26T14:02:11.482Z",
      "expires_at": "2026-12-25T14:02:11.482Z",
      "embed_url": "https://api.typesearch.ai/embed/chart_8k2m9q4x7w1p3n5z",
      "image_url": "https://api.typesearch.ai/embed/chart_8k2m9q4x7w1p3n5z.png",
      "svg_url": "https://api.typesearch.ai/embed/chart_8k2m9q4x7w1p3n5z.svg"
    },
    {
      "id": "chart_3v7n1q8m2k5x9w4p",
      "type": "bar_horizontal",
      "title": "Diario Ejemplo es el que más publicó sobre el litio",
      "theme": "editorial",
      "locale": "es",
      "created_at": "2026-09-26T13:47:30.105Z",
      "expires_at": "2026-12-25T13:47:30.105Z",
      "embed_url": "https://api.typesearch.ai/embed/chart_3v7n1q8m2k5x9w4p",
      "image_url": "https://api.typesearch.ai/embed/chart_3v7n1q8m2k5x9w4p.png",
      "svg_url": "https://api.typesearch.ai/embed/chart_3v7n1q8m2k5x9w4p.svg"
    }
  ],
  "has_more": true,
  "next_before": "2026-09-26T13:47:30.105Z"
}

Ver un gráfico

GEThttps://api.typesearch.ai/v1/charts/{id}

Un gráfico, con lo que se dibuja, su plan y sus fuentes: los mismos campos que la respuesta de POST /v1/charts, con usage.cost_usd en 0.

Ruta

Parámetro	Tipo
`id`	string	El id del gráfico, `chart_…`.

curl https://api.typesearch.ai/v1/charts/chart_8k2m9q4x7w1p3n5z \
  -H "Authorization: Bearer $TYPESEARCH_API_KEY"

404 Not Found

{
  "type": "urn:typesearch:error:chart_not_found",
  "title": "Not found",
  "status": 404,
  "detail": "No chart with that id for this key (GET /v1/charts).",
  "code": "chart_not_found",
  "request_id": "req_Hn2qW7xL4mZa"
}

Cambiar un gráfico

PATCHhttps://api.typesearch.ai/v1/charts/{id}

Cambia el tipo, el tema, el título, la bajada o el idioma, y vuelve a dibujar con los mismos datos: sin buscar de nuevo, gratis. Envía al menos un campo. type debería ser uno de los compatible_types del gráfico; si los datos no lo admiten, se dibuja con el tipo más cercano que sí y warnings lo dice (chart_type_adjusted). Sin un título tuyo, el título se vuelve a escribir para el nuevo tipo y el nuevo idioma.

embed_url, image_url y svg_url no cambian. Los embeds y las imágenes se guardan en caché 5 minutos, así que el cambio se ve ahí dentro de ese plazo.

Cuerpo

typeenum<string>
El nuevo tipo de gráfico: uno de los compatible_types del gráfico. Si los datos no lo admiten, se dibuja el tipo más cercano, con un aviso chart_type_adjusted.
Uno de: line · area · bar · bar_horizontal · stacked_bar · pie · donut · scatter · funnel · timeline · kpi · table
themeenum<string>
light, dark, editorial o electric.
titlestring
Un título nuevo. Sin un título tuyo, el título se vuelve a escribir para el nuevo tipo y el nuevo idioma.
subtitlestring
Una bajada nueva.
localeenum<string>
Lo vuelve a dibujar en otro idioma: en o es.

Respuesta

El gráfico actualizado, con los mismos campos que la respuesta de POST /v1/charts.

curl -X PATCH https://api.typesearch.ai/v1/charts/chart_8k2m9q4x7w1p3n5z \
  -H "Authorization: Bearer $TYPESEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "area", "theme": "dark" }'

200 OK (resumida)

{
  "id": "chart_8k2m9q4x7w1p3n5z",
  "object": "chart",
  "type": "area",
  "theme": "dark",
  "locale": "es",
  "compatible_types": ["line", "area", "bar", "kpi", "table"],
  "embed_url": "https://api.typesearch.ai/embed/chart_8k2m9q4x7w1p3n5z",
  "cached": false,
  "usage": { "cost_usd": 0, "mode": null, "queries": 0, "duration_ms": 0 },
  "warnings": []
}

Borrar un gráfico

DELETEhttps://api.typesearch.ai/v1/charts/{id}

Borra el gráfico. Su embed, su imagen y su SVG dejan de funcionar; las copias que ya estaban en caché pueden tardar unos minutos en irse.

Ruta

Parámetro	Tipo
`id`	string	El id del gráfico, `chart_…`.

curl -X DELETE https://api.typesearch.ai/v1/charts/chart_8k2m9q4x7w1p3n5z \
  -H "Authorization: Bearer $TYPESEARCH_API_KEY"

200 OK

{ "id": "chart_8k2m9q4x7w1p3n5z", "object": "chart", "deleted": true }