REST Countries · Example Payload

Search By Name Response

CountriesGeocodingGeographyISO 3166Open-SourcePublic APIsReference DataCurrencyLanguageCapitalsRegionsSubregionsTranslations

Search By Name Response is an example object payload from REST Countries, with 1 top-level field. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

data

Example Payload

{
  "data": {
    "objects": [
      {
        "names": {
          "common": "New Zealand",
          "official": "New Zealand",
          "alternates": ["Aotearoa"],
          "native": {
            "eng": {
              "common": "New Zealand",
              "official": "New Zealand"
            },
            "mri": {
              "common": "Aotearoa",
              "official": "Aotearoa"
            }
          }
        },
        "codes": {
          "alpha_2": "NZ",
          "alpha_3": "NZL",
          "ccn3": "554"
        },
        "region": "Oceania",
        "subregion": "Australia and New Zealand",
        "population": 5084300,
        "flag": {
          "emoji": "🇳🇿",
          "url_png": "https://flagcdn.com/w320/nz.png",
          "url_svg": "https://flagcdn.com/nz.svg"
        }
      },
      {
        "names": {
          "common": "Papua New Guinea",
          "official": "Independent State of Papua New Guinea",
          "alternates": []
        },
        "codes": {
          "alpha_2": "PG",
          "alpha_3": "PNG",
          "ccn3": "598"
        },
        "region": "Oceania",
        "subregion": "Melanesia",
        "population": 8947024,
        "flag": {
          "emoji": "🇵🇬",
          "url_png": "https://flagcdn.com/w320/pg.png",
          "url_svg": "https://flagcdn.com/pg.svg"
        }
      }
    ],
    "meta": {
      "total": 2,
      "count": 2,
      "limit": 25,
      "offset": 0,
      "more": false,
      "request_id": "req_03jkl789mno012"
    }
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/search-by-name-response"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.