Developer documentation, APIs and tools

Base URL https://geekyants.com/api/public/v1 · specification /openapi.json

Parameters and limits

• Every list operation takes page and per_page. per_page is clamped to 100; asking for more returns 100 rather than an error.
• q filters a listing by a case-insensitive substring of the title or description. It is a directory filter, not a ranked search — no stemming, no relevance order.
• /api/public/v1/pages accepts category, one of Consulting, Services, Industries, Guides, Company.
• A 502 means our content system could not be reached. It is never returned as an empty result set, so an outage cannot be mistaken for “nothing published”. Retry.

What it does not serve

Only pages that are live and already indexable on this website — the same set listed in the XML sitemap. There is no staff or author directory, no draft or scheduled content, no contact submissions, no internal identifiers, and no part of our content management system. If you need something that is not here, ask us.

curl -s 'https://geekyants.com/api/public/v1/services?per_page=5'

curl -s 'https://geekyants.com/api/public/v1/blog?q=react%20native&per_page=5'

curl -s 'https://geekyants.com/api/public/v1/blog/{slug}' | jq -r '.data.markdown'

Building an agent or a tool integration? Point it at /openapi.json — every operation carries a unique operation id, typed parameters and a response schema, so it converts straight into function-calling definitions.

Any page on this site will also answer with Markdown instead of HTML if you ask for it: send Accept: text/markdown and you get the page’s text with no markup to strip.

Errors

Every failure returns the same shape, so you can branch on error.code without parsing prose.

{
  "error": {
    "code": "not_found",
    "message": "No such blog post.",
    "hint": "Check the path against the operations listed at /api/public/v1.",
    "docs": "https://geekyants.com/developers"
  }
}

• bad_request (400) — a parameter is wrong and you can fix it.
• not_found (404) — no such resource, or not one this API serves.
• upstream_unavailable (502) — an outage. Never read this as an empty result: it means we could not reach our content system, not that nothing is published. Retry; a Retry-After header accompanies it.

Versioning

The major version is in the path and repeated on every response — successes and failures alike — as API-Version: v1.

Within a major version fields are only ever added. An existing field will not change type, change meaning or disappear, so you can safely ignore fields you do not recognise. A breaking change means a new major version at a new path; the old one keeps working.

Deprecation

If a version is ever withdrawn you will be told first, on the responses themselves. Affected responses will carry Deprecation (RFC 9745) with the date the deprecation was declared, and Sunset (RFC 8594) with the date the version stops answering. Those two dates will be at least twelve months apart.

Neither header is sent today, because nothing is deprecated. Watch for them on any response rather than polling this page.

Rate limits

There is no enforced per-caller quota, and no sign-up. Responses are cached for five minutes at the edge, which is what keeps load off our content system, so polling is cheap and welcome.

Every response carries RateLimit-Policy: "public";q=600;w=60 — an advisory fair-use ceiling of 600 requests a minute that we commit to honouring. Deliberately no RateLimit field reporting remaining quota is sent: nothing is counting, and a number nobody measures would make you throttle against a fiction. If you need more than the ceiling, ask us rather than working around it.

• OpenAPI 3.1 specification /openapi.json

  The machine-readable description of the public content API. Load it into a client generator, an API console, or an agent's tool definitions.

• llms.txt /llms.txt

  A short guide to the site for a language model: who GeekyAnts are, and the few dozen URLs that matter most.

• llms-full.txt /llms-full.txt

  Every indexable page on the site, titled and described. Generated from the live site, so it cannot fall behind.

• XML sitemap /sitemap.xml

  Every URL with its last-modified date and locale alternates, for a crawler that will read them all.

• RSS feed /feed.xml

  The newest 50 News & Press articles, as RSS 2.0.

• API catalogue /.well-known/api-catalog

  An RFC 9727 linkset pointing at the specification above. The standard place a client looks first.

• github.com/GeekyAnts — every repository we publish, including the contribution guide and issue templates on each.
• gluestack-ui and NativeBase — the two projects behind the CLI tools above.
• Our open-source portfolio — the full set of projects, each with its own site and documentation.

Something missing, or an endpoint you need? Get in touch — this page and the API behind it are maintained alongside the site, and we would rather add what you need than have you scrape it.