Atoka API User Reference

v20241018.0953

Public Funding Search

This API allows you to search for public funding. See the glossary for information about the source and the license of the data.

https://api.atoka.io/v2/publicfunding

All requests must be properly authenticated.

Authentication

Parameters

  • token string required

    All requests must be properly authenticated; see the Authentication section for more info

curl -G "https://api.atoka.io/v2/publicfunding"

Response

By default this API endpoint returns the list of public funding matching the selected criteria.

Using these parameters, you'll be able to customize the output you'll get from your searches.

Parameters

  • fields array,
    default is items

    Get just the list of public funding matched, or the search facets (or both!).

    If you set this to value none, you'll get just the meta object, with count of public funding matching your search criteria.

    Accepts multiple values, separated with , (comma) char: will match on any value (logic OR).

    Possible values are:

    • items
    • facets
    • none

  • facetFields array

    We want to keep our API as fast as possible, but facets are expensive to compute. To avoid slowing things down, you must explicitly state which facets you want when you request them. We want to make your life as simple as possible, though, that's why we support wildcards to be used in here; with them you will be able to have an initial look at the data, and to explicitly specify the facets you need once you start developing your application.

    This field is required when requesting the search facets through the fields parameter

    Accepts multiple values, separated with , (comma) char: will match on any value (logic OR).

    Possible values are:

    • * Enable all the facets of all the requested packages
    • base.* Enable all the facets of the package "base"
    • base.goal
    • base.theme
curl -G "https://api.atoka.io/v2/publicfunding" -d "fields=items" -d "facetFields=base.*"

Response modifications

When fields is items, the response will be:

{
"items": [
{
"id": "foo",
"name": "Fondo di Garanzia lg.662/96"
},
...
],
"meta": {
"ordering": "default",
"count": 57,
"limit": 10,
"offset": 30,
"info": [
"foo",
...
],
"obfuscated": {
"foo": undefined,
"bar": undefined,
"baz": undefined
}
}
}
curl -G "https://api.atoka.io/v2/publicfunding" -d "fields=items"

Data packages

This parameter is left for future, as currently only one package is available for Public Funding. In the future you will be able to fine tune the fields you want to be returned by the API, similarly to what is done in the other Atoka APIs.

If you have special needs and want to further customize the data returned, we can adapt the output to your specific needs: just get in touch with us at sales@atoka.io.

Parameters

  • packages array

    Fine tune the results to the level of detail your application actually requires.

    The extraction cost per single fund will be multiplied to the number of results in your query (up to offset parameter value).

    To avoid using any package, don't pass this parameter and the results will contain just the Atoka Public Funding ID (and little more).

    Accepts multiple values, separated with , (comma) char: will match on any value (logic OR).

    Possible values are:

    • base
    • * (use all the data packages you have an active subscription for)
curl -G "https://api.atoka.io/v2/publicfunding" -d "packages=*"

Response modifications

When packages is *, the response will be:

{
"items": [
{
"id": "foo",
"name": "Fondo di Garanzia lg.662/96",
},
...
],
"facets": {
},
"queryExplanation": [
{
"engine": "foo",
"text": "foo",
"json": {"foo": "bar"}
},
...
],
"meta": {
"ordering": "default",
"count": 57,
"limit": 10,
"offset": 30,
"info": [
"foo",
...
],
"obfuscated": {
"foo": undefined,
"bar": undefined,
"baz": undefined
}
}
}
curl -G "https://api.atoka.io/v2/publicfunding" -d "packages=*"

Ordering & Pagination

To download long lists of results you can paginate returned items using these parameters.

You can also decide the order in which items are returned.

Parameters

  • limit integer,
    default is 10

    This is the number of individual objects that are returned in each page.

    Use a number between 0 and 50.

  • offset integer,
    default is 0

    This offsets the start of each page by the number specified.

    Use a number between 0 and 9950.

  • ordering string,
    default is "startDateDesc"

    Selects the order in which results are returned.

    Choose only one among:

    • startDate
    • startDateDesc
    • amount
    • amountDesc
curl -G "https://api.atoka.io/v2/publicfunding" -d "limit=10" -d "offset=30" -d "ordering=amount"

General info

These filters act on the general information of the public funding, such as the fund amount, the starting / ending dates, and so on.

Parameters

  • ids array

    Search via already known Atoka Public Funding ID.

    Accepts multiple values, separated with , (comma) char.

  • beneficiaries array base

    Search via already known Atoka Company Beneficiaries ID.

    Accepts multiple values, separated with , (comma) char.

  • covidRelated boolean base

    Get just the list of public fundings relative to Covid 19.

  • themes array base

    Filter public fundings by their theme. Themes as provided by OpenCoesione. When missing, we might infer it via our Machine Learning model.

    Accepts multiple values, separated with , (comma) char: will match on any value (logic OR).

    Possible values are:

    • attractions
    • competitiveness
    • digitalAgenda
    • education
    • energy
    • environment
    • inclusion
    • occupation
    • PA
    • renovation
    • researchInnovation
    • transportation
    • unknown
    • * matches for any value

  • themesExclude array base

    Exclude public fundings by their theme. Themes as provided by OpenCoesione. When missing, we might infer it via our Machine Learning model.

    Accepts multiple values, separated with , (comma) char: will match on any value (logic OR).

    Possible values are:

    • attractions
    • competitiveness
    • digitalAgenda
    • education
    • energy
    • environment
    • inclusion
    • occupation
    • PA
    • renovation
    • researchInnovation
    • transportation
    • unknown
    • * matches for any value

  • goals array base

    Filter public fundings by their goal.

    Accepts multiple values, separated with , (comma) char.

  • goalsExclude array base

    Exclude public fundings by their goal.

    Accepts multiple values, separated with , (comma) char.

  • fullText string base

    Full-text search on several concatenated fields with optional highlight of the match

  • fullTextQuery string Private parameter base

    Full-text query on several concatenated fields with optional highlight of the match

  • fullTextTag boolean,
    default is false

    Enable match highlighting in the fullText field

curl -G "https://api.atoka.io/v2/publicfunding" -d "covidRelated=true" -d "themes=occupation" -d "themesExclude=occupation" -d "goals=formazione" -d "goalsExclude=formazione"

Debug

Use these parameters when you need to understand how your request was evaluated by the API.

Parameters

  • explain boolean,
    default is false

    When using this parameter in your request you'll get and additional property in the results explanation, that contains all the filters actually used during the query.

    Mostly useful for debugging purposes.

curl -G "https://api.atoka.io/v2/publicfunding" -d "explain=true"

Response modifications

When explain is true, the response will be:

curl -G "https://api.atoka.io/v2/publicfunding" -d "explain=true"

extended

Parameters

  • tagStart string,
    default is "<em>"

    Text that is prefixed to field highlights. Valid only if one of the highlightable field filters is passed.

  • tagEnd string,
    default is "</em>"

    Text that is appended to field highlights. Valid only if one of the highlightable field filters is passed.

curl -G "https://api.atoka.io/v2/publicfunding"

Response

The response of the fund

{
"items": [
{
"id": "foo",
"name": "Fondo di Garanzia lg.662/96",
},
...
],
"facets": {
},
"queryExplanation": [
{
"engine": "foo",
"text": "foo",
"json": {"foo": "bar"}
},
...
],
"meta": {
"ordering": "default",
"count": 57,
"limit": 10,
"offset": 30,
"info": [
"foo",
...
],
"obfuscated": {
"foo": undefined,
"bar": undefined,
"baz": undefined
}
}
}

Public Funding Details

Show full details of a fund.

By default we show all information available using all the data packages you subscribed to. Use the package parameter to fine tune the output format.

If you have special needs and want to further customize the data returned, we can adapt the output to your specific needs: just get in touch with us at sales@atoka.io.

https://api.atoka.io/v2/publicfunding/{id}

Replace {id} with the Atoka Public funding ID you want details for (as returned by the [Public Funding Search](#publicfunding)..

All requests must be properly authenticated.

Data Packages

This parameter is left for future, as currently only one package is available for Public Funding. In the future you will be able to fine tune the fields you want to be returned by the API, similarly to what is done in the other Atoka APIs.

Remember: your subscription gives you access to different levels of detail in data returned!

Parameters

  • packages array,
    default is *

    By using this parameter you can fine tune the results to the level of detail your application actually requires.

    Accepts multiple values, separated with , (comma) char: will match on any value (logic OR).

    Possible values are:

    • base
    • * use all the data packages you have an active subscription for
curl -G "https://api.atoka.io/v2/publicfunding/{id}" -d "packages=*"

Response modifications

When packages is *, the response will be:

{
"item": {
"id": "foo",
"name": "Fondo di Garanzia lg.662/96",
},
"queryExplanation": [
{
"engine": "foo",
"text": "foo",
"json": {"foo": "bar"}
},
...
]
}
curl -G "https://api.atoka.io/v2/publicfunding/{id}" -d "packages=*"

Debug

Use these parameters when you need to understand how your request was evaluated by the API.

Parameters

  • explain boolean,
    default is false

    When using this parameter in your request you'll get and additional property in the results explanation, that contains all the filters actually used during the query.

    Mostly useful for debugging purposes.

curl -G "https://api.atoka.io/v2/publicfunding/{id}" -d "explain=true"

Response modifications

When explain is true, the response will be:

curl -G "https://api.atoka.io/v2/publicfunding/{id}" -d "explain=true"

Response

Through the autentication credentials (the token) you are given, we are able to adapt the data available in API responses to your specific needs.

Moreover, depending on your subscription plan, you'll be able to retrieve different levels of details from the API calls.

{
"item": {
"id": "foo",
"name": "Fondo di Garanzia lg.662/96",
},
"queryExplanation": [
{
"engine": "foo",
"text": "foo",
"json": {"foo": "bar"}
},
...
]
}