Get research country codes

List available research country codes with document counts.

GET /research-v1/country-codes

Parameter	Type	DataType	Description
search	query	string	Case-insensitive wildcard filter on country code (auto-converted to uppercase)
page	query	integer	Page number (default: 1)
page_size	query	integer	Items per page (default: 50, max: 100)

NOTE

Authentication requires a user-level API key with research entitlements.
Uses page-based pagination.
Search filtering uses wildcard matching with the search term automatically converted to uppercase.

Request

https://premium.aiera.com/api/research-v1/country-codes

Response

{
  "pagination": {
    "total_count": 45,
    "current_page": 1,
    "total_pages": 1,
    "page_size": 45
  },
  "data": [
    {
      "country_code": "US",
      "doc_count": 9500
    },
    {
      "country_code": "GB",
      "doc_count": 3200
    }
  ]
}

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/research-v1/country-codes' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.request("GET", "https://premium.aiera.com/api/research-v1/country-codes", headers={"X-API-Key": "xxx"})