GET /api/citations/political-economy

Political Economy Citations Endpoint

Retrieve verified academic citations, primary sources, and cross-referenced literature related to political economy. Returns structured JSON with metadata, DOIs, and relevance scoring.

Authentication Bearer Token (Header)

Rate Limit 120 req/min (Standard)

Response Format application/json

Data Freshness Updated hourly

Query Parameters

Parameter	Type	Required	Description
`page`	integer	Optional	Page number for pagination. Defaults to `1`.
`limit`	integer	Optional	Results per page. Max `100`. Defaults to `20`.
`q`	string	Optional	Free-text search query. Supports boolean operators and wildcard matching.
`year_range`	string	Optional	Filter by publication year. Format: `YYYY-YYYY` or `YYYY-`.
`sort`	string	Optional	Sort order. Values: `relevance`, `date_desc`, `citations_desc`.
`fields`	string	Optional	Comma-separated list of fields to include. Reduces payload size.

Response Schema

Field	Type	Description
`id`	string	Unique citation identifier (UUID v4)
`title`	string	Full title of the academic work
`authors`	array[object]	List of authors with `name`, `affiliation`, `orcid`
`source`	string	Journal, publisher, or repository name
`year`	integer	Year of publication
`doi`	string	Digital Object Identifier (if available)
`relevance_score`	number	AI-calculated relevance to political economy (0.0 - 1.0)
`access_type`	string	Values: `open_access`, `subscription`, `archived`

Code Examples

cURL

curl "https://api.aevumencyclopedia.com/v1/citations/political-economy?page=1&limit=5&sort=relevance" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Python

import requests

response = requests.get(
    "https://api.aevumencyclopedia.com/v1/citations/political-economy",
    params={"page": 1, "limit": 10, "year_range": "2018-2024"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

print(response.json())

JavaScript

const response = await fetch(`https://api.aevumencyclopedia.com/v1/citations/political-economy?sort=date_desc`, {
  headers: {
    "Authorization": `Bearer ${API_KEY}`
  }
});

const data = await response.json();
console.log(data.items);

Example Response

JSON (200 OK)

{
  "meta": {
    "total": 1482,
    "page": 1,
    "limit": 5,
    "generated_at": "2024-05-12T08:30:00Z"
  },
  "items": [
    {
      "id": "cit_9a7f3b21...",
      "title": "Markets, States, and Social Reproduction",
      "authors": [
        {
          "name": "Dr. Elena Rostova",
          "affiliation": "LSE Economics Department"
        }
      ],
      "source": "Journal of Political Economy",
      "year": 2023,
      "doi": "10.1086/je.2023.141.2",
      "relevance_score": 0.94,
      "access_type": "open_access"
    }
  ]
}

Error Responses

Status Code	Meaning	Solution
`400`	Bad Request	Check query parameter formatting. Ensure `year_range` matches expected format.
`401`	Unauthorized	Provide a valid Bearer token in the `Authorization` header.
`429`	Too Many Requests	Slow down. Implement exponential backoff. Check `X-RateLimit-Reset` header.
`500`	Server Error	Transient failure. Retry with jitter. Contact support if persistent.

Note: All citations returned by this endpoint are cross-verified against primary academic databases. Relevance scores are dynamically calculated using Aevum's semantic indexing engine and update weekly.

Usage Policy: Data from this endpoint may only be used for research, educational, or internal indexing purposes. Redistribution or commercial resale requires a licensed enterprise agreement.