Data API can only return data and metadata that is available in our system at the time it is being queried. So to get the metadata for the mentions updated, you have to initiate queries periodically and update the needed information in your dataset.
There are two ways of doing this:
- To get all mentions based on filters in one query and iterate over the mentions in the response.
You can use the same queries over and over again for the same keywords and for the same interval to get the same mention, but with the current metadata stored in our system. (Please keep in mind that using the same filters may result in having new mentions in the response, if those were found after the first query.)
In this case you can use any of the 2 following unique IDs presented for each mention in each response:- ID - a unique composite ID
- Hash - a generated hash that can be used for duplication prevention or similar use cases
- To get details for only one mention you can use a dedicated endpoint:
https://data.neticle.com/24.04/mentions/:mentionId (documentation: https://data.neticle.com/docs/24.04#mentions:finding-a-single-mention).
For this, you only have to use the ID presented for each mention in the previous responses. For example, if a mention’s ID from a previous request was ‘10001-367’, you can get the most recent metadata for it via:
https://data.neticle.com/24.04/mentions/10001-367
Before making your first query, it is essential to familiarize yourself with the Authentication section. This will guide you on how to generate a valid API key, which is necessary for accessing the data. For detailed instructions, please visit: https://neticle.com/knowledge-base/how-can-i-authenticate-my-queries-in-data-api