Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
APINOA_API_KEYYesRequired for every data call. Create a key under Dashboard > API keys at apinoa.com.
APINOA_BASE_URLNoBase URL for the apinoa API gateway.https://gateway.apinoa.com

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

apinoa returns live web data as JSON: Amazon, Walmart, Shopify, TikTok Shop and AliExpress products, reviews and categories; TikTok, Instagram, YouTube, Reddit, X, Threads, LinkedIn and facebook posts, profiles and comments; search results from Google, Bing, Naver, Baidu, Yandex, Yahoo and 10 more search engines; what ChatGPT, Gemini, Google AI Overviews, Google AI Mode, Naver AI Briefing, Naver AI Tab, copilot and dola answer to a prompt, with the citations. Use it instead of writing a scraper. Find the operations and fields with search_docs, then call them from TypeScript in execute: fan out, page, filter and aggregate in the code, and return only the result.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_docsA

Find how to do a task with apinoa: the matching operations as you call them in execute (e.g. apinoa.tiktok.posts({ hashtag })), every parameter, the cost per call, and the fields of what they return. Free: it calls nothing. Use it before writing code. Pass words ('tiktok hashtag videos', 'instagram reels of an account', 'amazon product reviews'), a platform, or a type name ('Post'); with neither you get the list of every operation.

Platforms: aliexpress, amazon, app-store, baidu, bing, chatgpt, company, copilot, daum, dola, duckduckgo, facebook, gemini, google, google-ai-mode, google-aio, google-play, google-shopping, google-trends, instagram, linkedin, naver, naver-ai-brief, naver-ai-tab, reddit, seznam, shopify, sogou, threads, tiktok, tiktokshop, tripadvisor, walmart, x, yahoo, yahoo-japan, yandex, youtube.

executeA

Run TypeScript that calls the apinoa API, and get back only what it prints or returns. Use it for every data task, from one call to thousands: fan out over accounts or posts, follow pages, then filter, count, rank and average in the code, so raw API answers never fill the conversation.

The code is the body of an async function: use await, and return a small result (aggregate, slice, pick the fields you need). In scope:

  • apinoa..(params): one API call, returns the answer's data; throws ApinoaError (code, status) on a refusal. search_docs lists the parameters and the fields returned.

  • pages(op, params, { maxPages }): every item of a paged operation, following cursors (default 5 pages).

  • many(items, fn, { concurrency }): fn over every item, 8 at a time by default; a failed item comes back undefined.

  • store.save(name, value) / store.load(name) / store.list() / store.saveFile(name, base64): data kept on this machine between runs.

  • usage: { calls, units, budget } of this run. The code is type-checked before it runs: an operation, parameter or field that does not exist fails there, before anything is billed. Each call costs units (1 unit = $0.001, per search_docs); the run stops once budget_units are spent. Answers are cached for 10 minutes, so re-running after a fix costs nothing for calls already made. Only the API is reachable from the code.

Example: const page = await apinoa.tiktok.posts({ hashtag: "glassskin", limit: 50 }); const authors = [...new Set(page.items.map((p) => p.author.handle))].slice(0, 10); const recent = await many(authors, (u) => apinoa.tiktok.posts({ username: u, limit: 30 })); return authors.map((u, i) => { const views = (recent[i]?.items ?? []).map((p) => p.metrics?.views ?? 0).sort((a, b) => a - b); return { author: u, median: views[Math.floor(views.length / 2)] ?? null }; });

Operations (call search_docs with words or a platform for parameters, costs and the fields returned):

  • apinoa.aliexpress: search, browse, categories, imageSearch, product, shipping

  • apinoa.amazon: search, imageSearch, browse, categories, product

  • apinoa.app-store: search, app, reviews

  • apinoa.baidu: search, suggestions

  • apinoa.bing: search, suggestions

  • apinoa.chatgpt: answer

  • apinoa.company: technologies

  • apinoa.copilot: answer

  • apinoa.daum: search, suggestions

  • apinoa.dola: answer

  • apinoa.duckduckgo: search, suggestions

  • apinoa.facebook: profile, ads

  • apinoa.gemini: answer

  • apinoa.google: search, suggestions, places, place

  • apinoa.google-ai-mode: answer

  • apinoa.google-aio: answer

  • apinoa.google-play: search, app, reviews

  • apinoa.google-shopping: search, product, reviews

  • apinoa.google-trends: explore, trending

  • apinoa.instagram: profile, post, posts, comments, group, groups

  • apinoa.linkedin: profile, post, posts, comments, group, job, jobs

  • apinoa.naver: search, suggestions, places, place, reviews

  • apinoa.naver-ai-brief: answer

  • apinoa.naver-ai-tab: answer

  • apinoa.reddit: profile, profiles, post, posts, comments, group, groups

  • apinoa.seznam: search, suggestions

  • apinoa.shopify: search, imageSearch, catalog, product, reviews

  • apinoa.sogou: search, suggestions

  • apinoa.threads: profile, post, posts, comments

  • apinoa.tiktok: profile, profiles, post, posts, comments, group, groups, media

  • apinoa.tiktokshop: search, browse, categories, catalog, product, reviews

  • apinoa.tripadvisor: places, place, reviews

  • apinoa.walmart: search, browse, categories, product, reviews

  • apinoa.x: profile, post, posts, group

  • apinoa.yahoo: search, suggestions

  • apinoa.yahoo-japan: search, suggestions

  • apinoa.yandex: search, suggestions, places, place, reviews

  • apinoa.youtube: profile, profiles, post, posts, comments, groups

translate_imageA

Replace the text inside a product image with a translation, keeping fonts, colours and layout. Give the image as a URL. Returns the translated image.

read_image_textA

OCR: read the text in an image. Give the image as a URL. Returns every text region with its text, confidence, bounding box and polygon. Reads Chinese (Simplified and Traditional), Japanese, English and other Latin-script text. One credit per image; an image whose long side is 2.5 times its short side or more is read in sections, one credit each.

send_feedbackA

Tell apinoa when a call failed, returned wrong or missing data, or when a platform, operation or option you need does not exist. Include what you called (platform, operation, params), the request_id of the response, what came back (received) and what you expected; for a request, describe what you need in message. Free, and works without an API key. Returns an id: read the status and our reply later with get_feedback. Give contact to also get the reply by email.

get_feedbackA

The status of a report sent with send_feedback (received, in_progress, resolved or declined) and our reply, by its id. Free.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.2/5.0

Scored across 6 tools

Disambiguation5/5

Each tool has a clearly distinct role: send_feedback/get_feedback form a lifecycle pair, search_docs is read-only discovery, execute runs code, and read_image_text/translate_image are separate image operations. There is no realistic risk of selecting the wrong tool, since execute is the sole data-access path and search_docs is explicitly documentation-only.

Naming Consistency4/5

All names use snake_case with verb-led phrasing (send_feedback, get_feedback, search_docs, read_image_text, translate_image), which is predictable. The only minor deviation is the bare verb 'execute', though it remains clear and unambiguous.

Tool Count5/5

Six tools is well-scoped for an API gateway that exposes dozens of platforms through a single programmatic execute tool. Each tool earns its place: docs discovery, execution, feedback submission/status, and two image utilities.

Completeness4/5

The surface covers the core loop: discover operations via search_docs, run them via execute, and report/resolve issues via the feedback pair, plus image OCR and translation. Minor gaps exist around account/billing status and direct operation listing without code, but these are largely workable through execute and search_docs.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues