Manage charts

Charts made with any key of your organization, from POST /v1/charts. None of these requests is billed. Stored charts expire after 90 days on pay as you go and never on the monthly credit plan (expires_at); an expired or deleted chart answers 404 chart_not_found.

List charts

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

Your charts, newest first, a page at a time.

Query

Parameter	Type
`limit`	integer	How many, 1 to 100. Default: `20`.
`before`	string	The `next_before` of the previous page.

Response

object"list"
Always list.
dataobject[]
Your organization’s charts, newest first.
Show child attributes
- idstring
  The chart id.
- typestring
  The chart type.
- titlestring
  Its title.
- themestring
  Its theme.
- localestring
  Its language.
- created_atstring
  When it was created.
- expires_atstring | null
  When it expires, or null if it never does.
- embed_urlstring
  The page for an iframe.
- image_urlstring
  The PNG.
- svg_urlstring
  The SVG.
has_moreboolean
Whether there are older charts.
next_beforestring | null
Pass it as before for the next page. null on the last one.

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": "The blue dollar rose 4.1% this week",
      "theme": "light",
      "locale": "en",
      "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 published the most about lithium",
      "theme": "editorial",
      "locale": "en",
      "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"
}

Get a chart

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

One chart, with what is drawn, its plan and its sources: the same fields as the POST /v1/charts response, with usage.cost_usd at 0.

Path

Parameter	Type
`id`	string	The chart id, `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"
}

Change a chart

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

Switches the type, the theme, the title, the subtitle or the language, and redraws from the same data: no new search, free. Send at least one field. type should be one of the chart's compatible_types; if the data doesn't fit it, the chart is drawn with the closest type that does and warnings says so (chart_type_adjusted). Without a title of your own, the title is rewritten for the new type and language.

The embed_url, image_url and svg_url stay the same. Embeds and images are cached for 5 minutes, so the change shows there within that time.

Body

typeenum<string>
The new chart type: one of the chart’s compatible_types. If the data doesn’t fit it, the closest type is drawn, with a chart_type_adjusted warning.
One of: line · area · bar · bar_horizontal · stacked_bar · pie · donut · scatter · funnel · timeline · kpi · table
themeenum<string>
light, dark, editorial or electric.
titlestring
A new title. Without a title of your own, the title is rewritten for the new type and language.
subtitlestring
A new subtitle.
localeenum<string>
Redraw it in another language: en or es.

Response

The updated chart, with the same fields as the POST /v1/charts response.

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 (abridged)

{
  "id": "chart_8k2m9q4x7w1p3n5z",
  "object": "chart",
  "type": "area",
  "theme": "dark",
  "locale": "en",
  "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": []
}

Delete a chart

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

Deletes the chart. Its embed, image and SVG stop working; copies already cached can take a few minutes to go.

Path

Parameter	Type
`id`	string	The chart id, `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 }