ESPA APIespa.gr ↗
Access Greek ESPA EU funding programs, news, and program planning data via API. Retrieve program details, budgets, deadlines, and full article content.
What is the ESPA API?
The ESPA.gr API provides access to 6 endpoints covering EU-funded programs and news published on the Greek ESPA portal. Use list_programs to paginate active and pending funding calls with fields like operational_program, region, budget, and submission_period, or use get_program_detail to retrieve the full details of any individual program including target audience, funded activities, and attached files.
curl -X GET 'https://api.parse.bot/scraper/e6c05698-3fc6-4f49-a79f-d1e47ed00dd7/list_programs?page=1&status=active' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace espa-gr-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.espa_gr_funding_api import ESPA, Program, ProgramDetail, NewsArticle, NewsDetail, PlanningLink
espa = ESPA()
# List available funding programs
for program in espa.programs.list(limit=5):
print(program.title, program.region, program.submission_period)
# Search for programs by keyword
for result in espa.programs.search(query="αλιεία", limit=3):
print(result.id, result.title, result.operational_program)
# Get full details for a specific program
detail = espa.programs.get(item_id="7262")
print(detail.title, detail.url)
for f in detail.files:
print(f.title, f.url)
# List news articles
for article in espa.newsarticles.list(limit=3):
print(article.title, article.date)
# Get full news content
news = espa.newsarticles.get(item_id="2037")
print(news.title, news.content)
# List program planning links
for link in espa.planninglinks.list(limit=5):
print(link.title, link.url)
List ESPA funding programs/calls with pagination. Returns active and pending programs by default, 10 per page. Each program includes its ID, title, status, operational program, region, submission period, and direct URL.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
{
"type": "object",
"fields": {
"items": "array of program objects with id, title, status, operational_program, region, submission_period, and url",
"pagination": "object with current_page and total_pages"
},
"sample": {
"data": {
"items": [
{
"id": "7262",
"url": "https://www.espa.gr/el/pages/ProclamationsFS.aspx?item=7262",
"title": "Τεχνική υποστήριξη Χωρικών Φορέων/ ΒΑΑ Εορδαίας",
"region": "Νομός Κοζάνης",
"status": "",
"submission_period": "8/6/2026 - 31/7/2026",
"operational_program": "Δυτική Μακεδονία"
}
],
"pagination": {
"total_pages": 29,
"current_page": 1
}
},
"status": "success"
}
}About the ESPA API
Programs and Funding Calls
The list_programs endpoint returns paginated arrays of ESPA funding program objects, each carrying an id, title, status, operational_program, region, submission_period, and url. The optional page parameter lets you walk through the full catalog, which defaults to 10 items per page. Once you have an id, pass it as item_id to get_program_detail to get the complete record: a details object containing keys such as target_audience, budget, funded_activities, and region, plus a files array of downloadable attachments with titles and direct URLs.
News and Program Planning
list_news returns a reverse-chronological list of ESPA news articles — each with an id, title, date, and url. Retrieve the full text of any article via get_news_detail using the article's item_id; the response includes the complete content string. For forward-looking data, list_program_planning returns a flat array of planning link objects (each with a title and url), organized by region and operational program, giving visibility into calls that are not yet open.
Search
The site_search endpoint accepts a query string and returns a matching items array in the same shape as list_programs. This is useful for filtering programs by keyword — for example, searching for a sector name, region, or funding instrument — without iterating through all pages manually.
The ESPA API is a managed, monitored endpoint for espa.gr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when espa.gr changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official espa.gr API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor new ESPA funding calls by polling
list_programsand alerting whenstatuschanges or newsubmission_periodwindows open. - Build a grant discovery tool that lets Greek businesses filter programs by
regionoroperational_programfrom thelist_programsresponse. - Aggregate program
budgetandfunded_activitiesfields to analyze where EU structural funds are being directed across sectors. - Download program documentation by iterating the
filesarray returned byget_program_detailfor each active funding call. - Track ESPA news for policy monitoring by collecting article
contentviaget_news_detailand indexing it for keyword alerts. - Surface upcoming funding opportunities ahead of their opening by reading
list_program_planningplanning links organized by region. - Enable keyword search over the ESPA program database using
site_searchto find calls relevant to a specific industry or municipality.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ESPA.gr have an official developer API?+
What does `get_program_detail` return beyond what `list_programs` shows?+
list_programs returns summary fields: id, title, status, operational_program, region, submission_period, and url. get_program_detail adds the details object — containing keys like target_audience, budget, and funded_activities — plus a files array of attached documents with their download URLs.Can I filter `list_programs` by region or status directly?+
list_programs endpoint supports only a page parameter; it does not accept filter parameters for region or status. To filter, retrieve pages and apply filtering on the region or status fields client-side, or use site_search with a relevant keyword as a proxy filter.Does the API cover completed or archived ESPA programs from previous funding periods?+
list_programs endpoint returns active and pending programs by default. Archived or historically closed programs from prior EU funding periods are not currently covered. You can fork this API on Parse and revise it to add an endpoint targeting archived program listings.